ReddRadar
Agent skill
doc-flow
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
Install this agent skill to your Project
npx add-skill https://github.com/tarrragon/claude/tree/main/skills/doc-flow
SKILL.md
Doc-Flow SKILL
五重文件管理系統 - 專案文件運作的核心控制中心
核心理念
每個文件有單一職責，工程師只需讀對應文件就能理解全部。
重要規範：禁用 Emoji
所有五重文件系統中的文件禁止使用 emoji。
原因：
- 交接文件需要專業、正式
- emoji 在某些環境可能顯示不正確
- Claude Code CLI 處理 markdown 表格中的 emoji 可能導致 Rust panic
適用範圍：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 # 檢查文件一致性
Worklog 管理
/doc-flow worklog init [version] # 初始化新版本 worklog
/doc-flow worklog read [version] # 讀取指定版本 worklog 摘要
/doc-flow worklog update # 更新當前版本 worklog 狀態
Todo 管理
/doc-flow todo list # 列出所有待處理問題
/doc-flow todo add [description] # 新增待處理問題
/doc-flow todo resolve [id] # 標記問題已解決（移除）
/doc-flow todo defer [id] [version] # 延遲到指定版本
Changelog 管理
/doc-flow changelog preview # 預覽即將發布的變更
/doc-flow changelog update # 版本發布時更新
Error Pattern 整合
/doc-flow learn # 觸發錯誤模式學習流程
檔案位置
docs/
├── CHANGELOG.md # 版本變更記錄
├── todolist.yaml # 結構化版本索引（Source of Truth）
├── error-patterns/ # 錯誤模式知識庫
│ ├── README.md
│ └── categories/
└── work-logs/
└── v{VERSION}/
├── v{VERSION}-main.md # 版本企劃（大方向）
└── tickets/ # 執行細節
├── {version}-W1-001.md
└── ...
設計原則
1. 職責單一化
每個文件回答一個核心問題，不重疊、不混淆。
2. 自給自足原則
讀 worklog 就能理解版本全貌，不需要額外 context。
3. 細節下沉原則
執行細節 - Ticket，大方向 - Worklog
4. 經驗累積原則
每次修復都查詢/更新 error-patterns，持續改善工作模式。
相關文件
- 職責詳解：
references/document-responsibilities.md - 工作流程整合：
references/workflow-integration.md - 方法論：
.claude/methodologies/five-document-system-methodology.md - 規則：
.claude/references/document-system.md - Worklog 模板：
.claude/skills/doc-flow/templates/worklog.md.template - Todolist 模板：
.claude/skills/doc-flow/templates/todolist.yaml.template
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
tarrragon/claude
skill-design-guide
Use this skill when creating a new skill, updating an existing skill's YAML frontmatter, or reviewing skill quality. Provides the official Anthropic skill specification, frontmatter rules, description writing best practices, progressive disclosure architecture, and common pitfalls to avoid. Triggers include: creating skills, skill review, frontmatter validation, SKILL.md writing.
tarrragon/claude
test-async-guardian
Flutter/Dart 測試異步資源管理守護者。用於：(1) 診斷測試卡住問題，(2) 審查測試程式碼中的異步資源清理，(3) 提供 tearDown 最佳實踐，(4) 掃描潛在的資源洩漏風險。觸發場景：測試卡住、撰寫新測試、Code Review 測試程式碼、執行 flutter test 前自動掃描。
tarrragon/claude
agent-team
Agent Teams 協作派發指南。Use when: (1) Agent A 的發現會改變 Agent B 正在進行的工作, (2) 用戶要求使用 team/swarm, (3) 多代理人需即時協商共用介面或 API 契約。涵蓋 team 建立、Ticket-Task 橋接、teammate 入職、生命週期管理。
tarrragon/claude
tdd
TDD 全流程指導工具。Use for: (1) 開始新功能的 TDD 流程（Phase 0-4）, (2) 推進到下一個 TDD 階段, (3) Phase 1 SOLID 原則驅動功能拆分分析, (4) 查看當前 TDD 進度和階段狀態, (5) 評估是否需要 Phase 4 重構以及 3b 拆分評估。Use when: 開始新功能開發、進入任何 TDD Phase、需要 SOLID 拆分指導、需要確認當前所在 TDD 階段、需要做 Phase 4 豁免判斷時。
tarrragon/claude
branch-worktree-guardian
Branch Worktree Guardian - Git 分支和 Worktree 管理工具。Use for: (1) 新開發需求時建立隔離分支, (2) 使用 worktree 機制避免分支衝突, (3) 驗證當前工作分支正確性, (4) 預防在錯誤分支上開發
tarrragon/claude
design-decision-framework
多方案評估決策框架。用於面臨 3+ 技術方案時的結構化評估、架構決策時的系統化分析，防止衝動決策和技術債務累積。Use for: 技術方案選擇、重大架構決策、高風險技術選型
Didn't find tool you were looking for?