メニュー
Manages project documentation system including CHANGELOG, worklog, tickets, error-patterns, and todolist. Use for: (1) worklog initialization and updates, (2) todolist management, (3) version collaboration workflows, (4) documentation consistency checks
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Branch Worktree Guardian - Git 分支和 Worktree 管理工具。Use for: (1) 新開發需求時建立隔離分支, (2) 使用 worktree 機制避免分支衝突, (3) 驗證當前工作分支正確性, (4) 預防在錯誤分支上開發
Claude Code release notes 框架影響評估工具。比對 last-reviewed 版本篩出新版本，逐項分類（對框架有幫助 / 需評估 / 無影響 / 不適用），對採用項引導建 ANA + WRAP + spawn 落地。Use when: 執行 /release-notes 看到新版本、定期檢查 CC 更新、評估新功能對專案框架的影響時。Triggers: release notes, release-notes, CC 更新, claude code 更新, 版本更新評估, 新功能評估, 框架影響評估。
Use this skill for managing git worktrees for Ticket-based development. Triggers include: creating a worktree for a new ticket, checking worktree status, viewing all worktrees, or any mention of /worktree, worktree management, feature branches, or setting up development environment.
版本發布整合工具。Use for: (1) 發布新版本（合併到 main、打 Tag、推送）, (2) 發布前健康檢查（所有 Ticket 完成？CHANGELOG 更新？）, (3) 更新版本文件（worklog 狀態、CHANGELOG）。Use when: 準備發布版本、執行 /version-release check 確認發布前狀態、完成所有 Ticket 後要收尾時。
Composes atomic, intent-revealing, grep-friendly writing (Zettelkasten) for code comments, docs, logs, prompts, schema/ticket fields, external-analysis transformation, and long-form technical articles. Use when cognitive load and token cost matter. **Also triggers during multi-round review / batch review / 寫作 audit** — provides the keyword bank (正向陳述 / 口語修辭 / 地區用語 / 廢話前綴 / 裝飾符號 / 對讀者喊話 / 自評誇飾 / 必然性框架) and frame-specific check lists that multi-round-review reviewer agents need. Triggers: 寫註解, 寫文件, 寫日誌, 寫 prompt, 寫文章, 技術文章, 商業分析, 外部分析文章, post-mortem, 架構決策, 除錯復盤, 欄位設計, atomic, reusable, 多輪審查, multi-round review, batch review, 寫作 audit, 正向陳述, 口語修辭, 字句層 grep.
寫多篇章節後做多輪 agent reviewer audit 的標準操作流程。每輪用不同 frame 切換、跨輪 finding 互不重疊、停止訊號是 frame 涵蓋而非 finding 數遞減。Round 1-A 寫作規範 reviewer 必須同步 invoke `compositional-writing` skill 的字句層 keyword bank（正向陳述 / 口語修辭 / 地區用語 / 廢話前綴 / 裝飾符號 / 對讀者喊話 / 自評誇飾 / 必然性框架）、且命中後要做語意判定（命中是候選不是判決）。觸發詞：多輪審查、Round 1/2/3、frame 切換、跨輪審查、reviewer 規劃、何時停止 review、寫作 audit、batch review、cadence 同骨化、enumeration 不窮盡、正向陳述、self-application sweep。Trigger when reviewing multiple writings via successive rounds of agent reviewers.
| name | doc-flow |
| description | Manages project documentation system including CHANGELOG, worklog, tickets, error-patterns, and todolist. Use for: (1) worklog initialization and updates, (2) todolist management, (3) version collaboration workflows, (4) documentation consistency checks |
五重文件管理系統 - 專案文件運作的核心控制中心
| Skill | 管理範圍 | 核心問題 | 使用時機 |
|---|---|---|---|
/doc | proposals, spec, usecases | 需求是什麼？為什麼要做？ | 建立/查詢需求文件、提案評估 |
/doc-flow | CHANGELOG, worklog, todolist, error-patterns | 版本文件怎麼管？ | 初始化 worklog、更新版本文件 |
/ticket | Ticket CRUD, 追蹤, 交接, 恢復 | 任務怎麼執行和追蹤？ | 建立/認領/完成任務、交接 context |
簡記：doc 管需求（上游）、doc-flow 管版本文件（中台）、ticket 管任務執行（下游）。
每個文件有單一職責，工程師只需讀對應文件就能理解全部。
所有五重文件系統中的文件禁止使用 emoji。
原因：
適用範圍：CHANGELOG.md、todolist.yaml、worklog、ticket、error-patterns
| 文件 | 核心問題 | 職責定位 | 更新時機 |
|---|---|---|---|
| CHANGELOG | 這個版本做了什麼改變？ | 版本推進變化（給工程師看） | 版本發布時 |
| todolist.yaml | 還有哪些問題需要處理？ | 結構化版本索引（Source of Truth） | 持續更新 |
| worklog | 這個版本要達成什麼目標？ | 版本企劃 + 進度記錄 | 版本開始/結束 + 重要事件 |
| ticket | 這個任務的執行細節是什麼？ | 任務執行歷程（細節記錄） | 執行過程中 |
| error-patterns | 之前遇過類似問題嗎？ | 經驗學習（查詢/更新） | 執行前後 |
┌─────────────────┐
│ CHANGELOG │
│ (版本間差異) │
└────────┬────────┘
│
┌────────┴────────┐
│ worklog │
│ (大方向) │
└────────┬────────┘
│
┌────────────────┼────────────────┐
│ │ │
┌──────┴──────┐ ┌──────┴──────┐ ┌──────┴──────┐
│ ticket │ │todolist.yaml│ │error-patterns│
│ (執行細節) │ │ (版本索引) │ │ (經驗學習) │
└─────────────┘ └─────────────┘ └─────────────┘
/doc-flow status # 查看五重文件系統整體狀態
/doc-flow check # 檢查文件一致性
/doc-flow worklog init [version] # 初始化新版本 worklog
/doc-flow worklog read [version] # 讀取指定版本 worklog 摘要
/doc-flow worklog update # 更新當前版本 worklog 狀態
每個版本必須有 v{VERSION}-main.md 主 worklog。init 指令執行以下步驟：
docs/work-logs/v{MAJOR}/v{MAJOR}.{MINOR}/v{VERSION}/tickets/（如不存在）v{MAJOR}.{MINOR}-main.md（如不存在）cp .claude/skills/doc-flow/templates/worklog.md.template \
docs/work-logs/v{MAJOR}/v{MAJOR}.{MINOR}/v{VERSION}/v{VERSION}-main.md
docs/todolist.yaml 新增版本條目前提條件：worklog 三層目錄結構是 ticket 系統正常運作的前提。目錄不存在時 ticket 無法建立。
觸發時機：版本開始時，在建立第一個 Ticket 之前。
新專案/Legacy Code 接手時：若 docs/work-logs/ 為空或使用舊版扁平結構，需先執行結構初始化（建立 v{MAJOR}/ 頂層目錄）後再 init 版本。project-init onboard 會自動處理此步驟。
主 worklog 職責：版本的敘事性事件日誌。記錄「發生了什麼」和「為什麼」，不是 ticket 狀態表的重複。
記錄什麼（因果鏈和決策）：
不記錄什麼（ticket 系統已追蹤）：
ticket track list 查詢）/doc-flow todo list # 列出所有待處理問題
/doc-flow todo add [description] # 新增待處理問題
/doc-flow todo resolve [id] # 標記問題已解決（移除）
/doc-flow todo defer [id] [version] # 延遲到指定版本
/doc-flow changelog preview # 預覽即將發布的變更
/doc-flow changelog update # 版本發布時更新
/doc-flow learn # 觸發錯誤模式學習流程
docs/
├── CHANGELOG.md # 版本變更記錄
├── todolist.yaml # 結構化版本索引（Source of Truth）
├── error-patterns/ # 錯誤模式知識庫
│ ├── README.md
│ └── categories/
└── work-logs/
├── v{MAJOR}/ # 大版本目錄
│ ├── v{MAJOR}-main.md # 大版本工作日誌
│ └── v{MAJOR}.{MINOR}/ # 中版本目錄
│ ├── v{MAJOR}.{MINOR}-main.md # 中版本工作日誌
│ └── v{VERSION}/ # 小版本目錄
│ ├── v{VERSION}-main.md # 小版本工作日誌（敘事性事件日誌）
│ └── tickets/ # 執行細節
│ ├── {version}-W{wave}-{seq}.md
│ └── ...
└── legacy/ # 舊格式散落檔案
每個文件回答一個核心問題，不重疊、不混淆。
讀 worklog 就能理解版本全貌，不需要額外 context。
執行細節 - Ticket，大方向 - Worklog
每次修復都查詢/更新 error-patterns，持續改善工作模式。
references/document-responsibilities.mdreferences/workflow-integration.md.claude/methodologies/five-document-system-methodology.md.claude/references/document-system.md.claude/skills/doc-flow/templates/worklog.md.template.claude/skills/doc-flow/templates/todolist.yaml.templateLast Updated: 2026-04-01 Version: 1.0.0