spec-writer

Use this agent to scan a codebase for domain terminology, existing story IDs, and project documentation structure. Helps spec writers use consistent language and avoid ID conflicts with existing stories. Examples: <example> Context: 使用者在 Phase 0 確認有程式碼庫可掃描 user: (確認 codebase 可用) assistant: "我會使用 codebase-explorer 來掃描領域術語和既有 Story ID。" <commentary> codebase-explorer 掃描專案以提取領域語言和任何 story/ticket 引用。 </commentary> </example>

Use this agent to read and summarize existing project documents such as PRDs, spec files, sprint plans, or backlog exports. Produces a structured Context Summary that the spec-writing skill uses in subsequent phases. Examples: <example> Context: 使用者在 Phase 0 提供了既有 spec 與 sprint 文件路徑 user: (觸發 Phase 0 情境收集) assistant: "我會使用 context-reader agent 來讀取並摘要你的文件。" <commentary> 使用者提供了既有文件。context-reader 讀取並提取專案名稱、已知限制、 既有 Story ID、Sprint 目標等資訊。 </commentary> </example> <example> Context: 使用者貼上了原始需求文字 user: (在 AskUserQuestion 回應中提供原始文字) assistant: "讓我用 context-reader 來處理這些內容。" <commentary> 原始文字作為任務脈絡傳入。context-reader 解析並結構化。 </commentary> </example>

Use this agent when reviewing user stories or specs for quality. Examples: <example> Context: 使用者剛寫完一組 User Stories，想確認品質 user: "幫我檢查這些 stories 的品質" assistant: "我會使用 spec-reviewer agent 來進行 INVEST 檢查和反模式掃描。" <commentary> 使用者明確要求檢查 stories 品質，觸發 spec-reviewer 進行全面品質檢查。 </commentary> </example> <example> Context: 使用者寫完 spec 後想確認是否有反模式 user: "這個 spec 有沒有什麼問題？" assistant: "讓我用 spec-reviewer agent 來掃描常見反模式和 INVEST 標準。" <commentary> 使用者詢問 spec 問題，觸發 spec-reviewer 進行反模式掃描。 </commentary> </example> <example> Context: 使用者完成了 stories 撰寫，進入品質檢查階段 user: "review my stories" assistant: "I'll use the spec-reviewer agent to check INVEST compliance and anti-patterns." <commentary> 使用者要求 review stories，觸發 spec-reviewer。 </commentary> </example>

Use this agent to decompose a large, ambiguous goal into a structured Story Map (Activity → Task → Story) using Jeff Patton's methodology. Produces a prioritized Stories list for the spec-writing skill's subsequent phases. Examples: <example> Context: 使用者在 Phase 0.5 需要從模糊大目標拆解出 Stories user: (Phase 0 完成，需求是大功能或多角色場景) assistant: "我會使用 story-mapper agent 來建立 Story Map 並拆解出候選 Stories 清單。" <commentary> 需求模糊且範圍大。story-mapper 使用 Story Mapping 方法論，從使用者旅程出發， 建立 Activity → Task → Story 三層結構，並建議 Release 切片。 </commentary> </example> <example> Context: 使用者明確要求進行 Story Mapping user: "幫我做 story mapping" assistant: "我會使用 story-mapper agent 來進行 Story Mapping 拆解。" <commentary> 使用者直接要求 Story Mapping。story-mapper 讀取方法論參考並執行拆解。 </commentary> </example>

This skill should be used when the user asks to "撰寫 spec", "寫 user story", "寫 story", "撰寫需求規格", "write spec", "write user story", "撰寫驗收標準", "寫 acceptance criteria", "拆分 story", "拆解需求", "檢查 story 品質", "INVEST 檢查", "反模式掃描", "review my user stories", "break down a feature into stories", "story mapping", "需求拆解", "user story mapping", "拆解大功能", "建立 story map", or needs guidance on spec writing methodology, story types, scoping, acceptance criteria, prioritization, or INVEST quality checks.