Menu
规范澄清技能. 通过提出最多 5 个高度针对性的澄清问题, 识别当前功能规范中未充分说明的领域, 并将答案编码回规范中. 当用户提到澄清规范、消除模糊性、补充规范细节、或在 specify 完成后需要进一步细化时使用.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
按 Git/非 Git、是否指定 BRANCH_NAME 与 FEATURE_DIR 分支决策，解析输入并创建或复用特性分支与功能目录，输出 BRANCH_NAME、SPEC_FILE、FEATURE_DIR。用于 /specify 或单独创建/复用特性分支。
基于已定义的功能识别并调整逻辑实体，输出实体责任边界、协作关系与关键数据结构，并生成数据模型文档。仅被显式调用，不自动触发。
SDD流程代码变更采集Skill。在SDD流程执行完毕后，采集目标目录的代码变更信息，提取feature_infos和code_blocks，生成评测所需的JSON文件并保存到当前SDD分支的evalset目录下。当用户提到"采集SDD变更"、"生成评测数据"、"收集代码变更信息"、"build_configi_eval"、"evalset"时触发本技能。
深度逻辑架构要素反构编排Skill. 当 reverse 的 --target 为 deep_logic_architecture 时触发.
实体清单与实体关系反构的编排Skill. 当 reverse 的 --target 为 entities 或 all 的实体阶段时触发.
功能清单与功能详情文档反构的编排Skill. 当 reverse 的 --target 为 functions 或 all 的功能阶段时触发.
| name | clarify |
| description | 规范澄清技能. 通过提出最多 5 个高度针对性的澄清问题, 识别当前功能规范中未充分说明的领域, 并将答案编码回规范中. 当用户提到澄清规范、消除模糊性、补充规范细节、或在 specify 完成后需要进一步细化时使用. |
检测并减少活跃功能规范中的模糊性或缺失的决策点, 并将澄清内容直接记录在规范文件中.
注意: 此澄清工作流应在 /design 之前运行(并完成). 如果用户明确表示跳过澄清(例如, 探索性原型), 可以继续, 但必须警告下游返工风险增加.
在继续之前, 你必须考虑用户的消息内容(如果不为空).
开始执行步骤之前，需要进行一些打点记录工作，记录本skill的执行时间到 start_time字段：
Get-Date -Format "yyyy-MM-dd HH:mm:ss"
linux: date +"%Y-%m-%d %H:%M:%S"start_timescripts/powershell/check-prerequisites.ps1 --json --paths-only
linux: scripts/bash/check-prerequisites.sh --json --paths-onlyFEATURE_DIRFEATURE_SPECIMPL_DESIGN、TASKS 用于未来的链式流程.)/specify 或验证功能分支环境.加载当前规范文件. 使用以下分类法执行扫描, 对每个类别标记状态: 清晰 / 部分 / 缺失. 生成内部覆盖范围图(除非不会提问, 否则不输出原始图).
功能范围与行为:
领域与数据模型:
交互与 UX 流程:
非功能性质量属性:
集成与外部依赖:
边缘情况与故障处理:
约束与权衡:
术语与一致性:
完成信号:
其他 / 占位符:
对于每个处于部分或缺失状态的类别, 添加候选问题机会, 除非:
(内部)生成候选澄清问题的优先级队列(最多 5 个). 不要一次性输出所有问题. 应用以下约束:
一次只提出确切一个问题
对于多项选择题:
分析所有选项并基于以下确定最合适的选项:
在顶部突出显示推荐选项并附上清晰推理(1-2 句话)
格式为: **Recommended:** Option [X] - <reasoning>
然后将所有选项渲染为 Markdown 表格:
| Option | Description |
|---|---|
| A | Option A description |
| B | Option B description |
| Short | Provide a different short answer (<=5 words) |
表格后添加: You can reply with the option letter (e.g., "A"), accept the recommendation by saying "yes" or "recommended", or provide your own short answer.
对于简答题风格(没有有意义的不同选项):
**Suggested:** <your proposed answer> - <brief reasoning>Format: Short answer (<=5 words). You can accept the suggestion by saying "yes" or "suggested", or provide your own answer.用户回答后:
在以下情况时停止进一步提问:
永远不要提前揭示未来的排队问题
如果开始时没有有效问题, 立即报告没有关键模糊性
每次接受答案后:
## Clarifications 部分存在(如果缺失, 根据规范模板在最高级别的上下文 / 概述部分之后创建)### Session YYYY-MM-DD 子标题- Q: <question> -> A: <final answer>每次写入后执行, 最终再进行一次完整检查:
## Clarifications、### Session YYYY-MM-DD将更新的规范写回 FEATURE_SPEC.
加载 evaluation-rubric skill 的四维量规，对更新后的 FEATURE_SPEC 执行评测：
FEATURE_DIR/.runs/evaluations/evaluation-report.yaml（stage: clarify）若不通过: 修复规范中对应维度的问题，重新评测（最多 2 轮），结果记入步骤 9 完成报告。
提问循环结束或提前终止后输出:
/design 还是再次运行澄清执行runlog-record skill，请将前面获取到的start_time的值作为参数传入runlog-record skill
/specify(不要在此创建新规范)