메뉴
循环向用户提问，持续收集补充意见来打磨 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: 待确认 -->）