القائمة
循环向用户提问，持续收集补充意见来打磨 Spec 文档，直到用户明确确认全部 OK 才停止并输出完整结果。当用户要求"完善 spec"、"补充需求"、"评审 spec"、"继续细化"时触发。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
按 Plan 文档逐步执行代码改动，每步自动 lint、git commit 并更新执行状态，支持中断续接和单步回滚。当用户要求"执行 plan"、"按计划实施"、"开始写代码"时触发。
全自动需求→实现流水线编排。串联 write-spec → refine-spec → write-plan → execute-plan → 验收，每阶段设置确认门，支持中断恢复。当用户要求"全自动实现"、"一键开发"、"按需求交付"时触发。
从 Spec 技术规格文档生成分步实施计划（Plan），包含执行记忆存储和 git commit 策略。当用户要求"写 plan"、"生成实施计划"、"spec 转 plan"、"帮我拆分实现步骤"时触发。
分析项目代码结构，生成一份 CLAUDE.md 项目架构文档，包含技术栈、目录结构、入口文件、架构模式和配置说明。当用户要求"生成 CLAUDE.md"、"写项目文档"、"分析项目架构"、"初始化项目上下文"时触发。
将用户需求与 CLAUDE.md 项目架构上下文结合，生成一份结构化的 Spec 技术规格文档。当用户要求"写 spec"、"生成规格文档"、"需求转技术方案"、"帮我设计实现方案"时触发。
| name | refine-spec |
| description | 循环向用户提问，持续收集补充意见来打磨 Spec 文档，直到用户明确确认全部 OK 才停止并输出完整结果。当用户要求"完善 spec"、"补充需求"、"评审 spec"、"继续细化"时触发。 |
| allowed-tools | Read(*), Bash(ls:*, cat:*), Write(*), Edit(*), Glob(*) |
| metadata | {"author":"tangjiahui","version":"1.0.0"} |
以循环提问的方式不断收集用户补充意见，逐轮打磨 Spec 文档，直到用户明确确认无需补充后才停止。
当用户提到以下内容时调用此 skill：
ls .claude/tmp/spec/*.md 2>/dev/null
❌ 错误：Spec 文件不存在（.claude/tmp/spec/ 目录下无 .md 文件）。
请先用 write-spec 生成 Spec：
「帮我写 spec：<你的需求>」
┌──────────────────────────────────────┐
│ 1. 读取当前 spec │
│ 2. 分析缺口，准备 1-3 个问题 │
│ 3. 向用户提问 │
│ 4. 用户回答 │
│ 5. 用 Edit 更新 spec │
│ 6. 追问"还有其他需要补充/修改的吗？" │
└──────────────────────────────────────┘
│
┌─────────┴─────────┐
│ 用户有补充 │ 用户表示"OK/没问题/可以了"
▼ ▼
回到步骤 1 停止循环，输出本轮所有变更摘要
每次迭代从以下维度中选 1-3 个最需要补充的方向提问：
| 序号 | 维度 | 检查逻辑 |
|---|---|---|
| 1 | 范围边界 | 功能边界是否清晰？做什么/不做什么是否明确？ |
| 2 | 功能拆分 | 功能点粒度是否合理？优先级(P0/P1/P2)是否正确？ |
| 3 | 技术落地 | 涉及模块/文件是否遗漏？技术方案是否可执行？ |
| 4 | 边界条件 | 空数据/加载态/错误态/极端值是否覆盖？ |
| 5 | 兼容影响 | 对已有功能的影响是否分析？是否需要迁移？ |
| 6 | 验证方案 | 验证步骤是否具体可执行？回归范围是否完整？ |
原则：
每轮用户回答后，用 Edit 工具精确修改 spec 文件中的对应位置。同时更新文件头部的时间戳：
> 创建时间: 2026-07-20 | 状态: draft | 最后更新: 2026-07-20 15:30
用户给出以下任一信号时停止循环：
| 信号 | 示例 |
|---|---|
| 明确确认 | "没问题了"、"可以了"、"就这样"、"OK"、"确认"、"通过"、"没有" |
| 转入下一步 | "生成 plan"、"开始实现"、"执行"、"拆分步骤" |
停止后，输出本轮所有变更摘要：
## Refine 完成
**Spec**：`.claude/tmp/spec/<name>.md`
### 本轮变更
| 轮次 | 维度 | 变更内容 |
|------|------|----------|
| 1 | 边界条件 | 补充了空数据态处理方案 |
| 2 | 功能拆分 | 将 Step 2 拆分为两个子功能点 |
| ... | ... | ... |
### 当前 Spec 状态
- 状态：ready（可进入 write-plan）
<!-- TODO: 待确认 -->）