task-management
Manages development tasks using structured directories, README dashboards, and status tracking.
Install
mkdir -p .claude/skills/task-management-rjchien728 && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/11624" && unzip -o skill.zip -d .claude/skills/task-management-rjchien728 && rm skill.zipInstalls to .claude/skills/task-management-rjchien728
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
管理 ~/tasks/（或使用者指定路徑）下的進行中工作項目資料夾。每個 task 是一個資料夾，README.md 是純狀態 dashboard（status frontmatter + 一句 headline + 一行狀態 + 檔案清單 + 下一步），實際的設計 / 規劃 / 調查文件用獨立 .md 檔，腳本與 reproduce 也存獨立檔。負責命名（YYMMDD-<slug>）、建資料夾、寫 README dashboard、更新狀態、總覽掃描。當使用者說「開新 task」「開個 task」「新增 task」「new task」「記錄到 tasks 下」「把目前設計記下來開個 task」「task 卡住了」「task 完成」「archive task」「現在有哪些 task」「列 task」「task 狀態」「show tasks」時觸發。Key capabilities
- →Create new task folders with standardized naming.
- →Write a README.md dashboard for each task.
- →Update task status and progress in the README.md.
- →List current tasks with their status and project information.
- →Store design, planning, or investigation content in separate .md files.
- →Store scripts and reproduction snippets in independent files.
How it works
The skill creates and manages task-specific folders, enforcing a standardized README.md dashboard for status, file listing, and next steps.
Inputs & outputs
When to use task-management
- →Tracking coding tasks
- →Organizing investigation files
- →Managing project status
- →Archiving completed work
About this skill
Task Management
~/tasks/ 下管理進行中工作項目（或使用者指定的 tasks 目錄）。每個 task 是一個資料夾。
README.md 角色
只放：
- frontmatter（status / created / updated / project）
- 一句 headline
- 一行狀態註記（覆蓋式更新，不疊歷史）
- 檔案清單（指向同資料夾下其他檔）
- 下一步 checklist
不放（改用獨立檔）：
- 設計 / 規劃 / 調查內容 → 同資料夾內開獨立
.md - 腳本、reproduce、test snippet → 存獨立檔（
reproduce.py、probe.sh等） - log / output 資料 → 存獨立檔（
error.log、output.json等）
整份 README 不超過 40 行。
命名
格式：YYMMDD-<slug>
YYMMDD：用date +%y%m%d取<slug>：dash 分隔小寫，可含 project 名
範例：260504-payment-webhook-debug、260512-billing-migration-handoff
不加 -investigation / -design / -plan 後綴（那是內部 .md 檔名的事）。
README.md 模板
---
status: in-progress # in-progress | blocked | done | archived
created: 2026-05-04
updated: 2026-05-04
project: <project-name> # optional
---
# <Task 標題>
<一句 headline>
## 狀態
**in-progress** — <一行字描述目前做到哪 / 卡在哪>
## 檔案
- [`260504-token-cache-investigation.md`](260504-token-cache-investigation.md) — 初步調查
- [`reproduce.py`](reproduce.py) — 重現腳本
## 下一步
- [ ] 看 cache invalidation 邏輯找出 leak point
- [ ] 跟相關 stakeholder 確認影響範圍
剛開的 task 還沒檔案就省略「檔案」段。
status 值：
| 值 | 用法 |
|---|---|
in-progress | 在做或暫時擱著但還沒放棄 |
blocked | 等別人 / 等外部條件 |
done | 完成；保留資料夾不刪 |
archived | 不繼續或被別的 task 取代 |
工作流
1. 開新 task
- 問 slug。使用者只給敘述就提建議讓他確認。
date +%y%m%d取 YYMMDD。mkdir -p ~/tasks/<YYMMDD>-<slug>- 對話中已有設計 / 規劃 / 調查內容（≥3 段或 200 字以上）→ 在該資料夾內開獨立
.md，不塞 README。 - 對話中已有腳本 / snippet → 存獨立檔，檔名用描述性英文。
- 寫 README.md：填 frontmatter、一句 headline、一行狀態、檔案清單、下一步。控制在 40 行內。
- 回報路徑。
2. 更新狀態 / 加進展
- 用 slug fuzzy match 找對應 README.md，找不到就問。
- 新進展是長內容（新調查 / 新設計）→ 開獨立 .md 檔，加進「檔案」段。
- 新進展是短狀態 → 覆蓋更新「狀態」段那一行（不疊歷史）。
- 更新 frontmatter：
status、updated（date +%Y-%m-%d）。
3. 列出總覽
ls ~/tasks/，只挑符合YYMMDD-*格式的資料夾。- 讀每個 README.md 的 frontmatter + 「狀態」段那一行。
- markdown table 呈現：資料夾名 / status / project / updated / 狀態註記。
- 預設只列
in-progress與blocked。done/archived要使用者明確要求才列。 - 有
blockedtask 主動點出卡在什麼。
README dashboard vs 內部 .md 的分工
| README.md | 內部 .md | |
|---|---|---|
| 角色 | task 資料夾的命名、狀態、檔案 index | 單一主題的內容、設計、調查 |
| 產物 | dashboard | .md 檔（放在 task 資料夾下） |
| 命名 | 固定 README.md | YYMMDD-<topic>-<type>.md |
開 task 用本 skill；寫設計 / 調查內容開獨立 .md 放同資料夾，加進 README 的「檔案」段。
常見錯誤
- ❌ 把設計、規劃、調查內容塞進 README（開獨立 .md 檔）
- ❌ README 超過 40 行
- ❌ 「狀態」段累積歷史 entry（只記現在一行）
- ❌ 開 task 前不問 slug 自己猜
- ❌ task 資料夾名加
-investigation/-plan後綴 - ❌ 用記憶猜日期沒跑
date - ❌ Task 完成後刪資料夾（改 status 即可）
- ❌ 在
~/tasks/README.md維護靜態總表
When not to use it
- →When the user wants to put design, planning, or investigation content directly into README.md.
- →When the user wants to exceed 40 lines in README.md.
- →When the user wants to accumulate historical entries in the 'status' section.
Limitations
- →README.md must not exceed 40 lines.
- →The 'status' section in README.md only shows the current status, not historical entries.
- →Task folders are not deleted after completion, only their status is changed.
How it compares
This skill standardizes task management by enforcing a strict README.md format and separating detailed content into independent files, promoting clarity and organization over unstructured notes.
Compared to similar skills
task-management side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| task-management (this skill) | 0 | 3mo | No flags | Beginner |
| agent-project-board-sync | 0 | 6mo | Review | Intermediate |
| pi-tasks | 0 | 3mo | No flags | Intermediate |
| add-todo | 0 | 1mo | No flags | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
agent-project-board-sync
ruvnet
Agent skill for project-board-sync - invoke with $agent-project-board-sync
pi-tasks
Micka33
>-
add-todo
MichaelGao1999
即时写入待办项到 status.md，当用户说"计入待办""记入待办""加入待办""加到清单""后面做""回头处理"时使用。
yatta
Trompetilla
Personal productivity system for task and capacity management. Create and organize tasks with rich attributes (priority, effort, complexity, tags), track time and streaks, manage capacity across projects and contexts, view Eisenhower Matrix prioritization, sync calendar subscriptions, handle delegat
develop-feature
saptarshibasu
Use when starting spec-driven development on any change, large or trivial — triggers: \"create a spec for X\", \"start a new feature: Z\", \"use SDD for this\", \"write a spec before we code\". Proposes a right-sized workflow track for approval, then orchestrates Specify -> Plan -> Tasks -> Analyze
github-manage
matteocervelli
Manage operations concerning GitHub on behalf of user