自动请求澄清技能Skill clarify-spec

---

name: clarify-spec description: | 自动激活于模糊请求。宁可多问一次也不要错误实现。

识别特征（满足一个即可）：

• 请求 <25 个单词
• 没有具体文件名/路径
• 模糊动词：改善、优化、修复、做、更改、改进、适应、扩展、重构、整理、修订
• 不确定语言：有些、也许、马上、快、简单、一点、可能、应该
• 缺乏成功标准：没有因此、所以、因为、为了
• 无上下文的相对概念：更快、更好、更美、更简单

输出是结构化JSON用于prompt-architect技能。 转义：直接做、不要提问、自己决定跳过澄清。 triggers:

• /clarify
• /spec
• /was-genau
• /praezisieren
• /klaeren

---

Clarify-Spec v2.0: 自动请求澄清

激活：激进 - 宁可多问一次！

自动在这些信号下激活（满足一个即可）

信号	例子	为什么有问题
简短请求 (<25 单词)	让导出更好	上下文太少
没有文件名/路径	优化性能	范围不明确
模糊动词	改善、优化、修复、做	不可操作化
不确定语言	有些、也许、马上、快	表示不明确
缺乏成功标准	没有因此、所以、因为	没有定义目标
相对概念	更快、更好、更美、更简单	无基线则无意义
隐含假设	通常、像往常一样、标准	上下文缺失

仅当满足所有条件时不激活：

• 提及具体文件名/路径 并且
• 定义清晰、可衡量的目标 并且
• 可识别成功标准 并且
• 明确跳过命令（直接做、不要提问）

工作流程

阶段1: 模糊性检查（严格）

检查每个请求对以下清单：

[ ] 提及具体文件/组件？ [ ] 定义清晰、可衡量的目标？ [ ] 可识别成功标准？ [ ] 范围划定？ [ ] 没有使用模糊动词？

少于4个勾选 = 提问！

阶段2: 收集上下文（安静，无需用户交互）

1. 在项目中搜索相关文件（全局）
2. 检查 CLAUDE.md / AGENTS.md
3. 识别无接触区域
4. 查找类似现有实现

阶段3: 针对性提问（2-4个，优先）

格式 - 简短精确：

在开始之前 - 简短澄清：

1. [最具体问题 - 到底是什么？]
2. [第二重要问题 - 哪里/哪个文件？]
3. [可选：成功标准？]
4. [可选：有例子/参考吗？]

（或说直接做 - 然后我根据最佳知识决定。）

问题优先级：

优先级	类型	示例问题
1	什么	你到底是什么意思更好？要解决什么问题？
2	哪里	哪个文件/组件受影响？前端还是后端？
3	成功	如何识别完成？预期结果是什么？
4	例子	有参考/截图吗？期望输出什么样？
5	上下文	用于哪个用例？谁是这个功能的用户？

阶段4: 结构化输出（用于prompt-architect的JSON）

用户回答后，生成结构化JSON：

• clarified_task.goal: 精确目标，1-2句话
• clarified_task.problem_statement: 问题是什么
• clarified_task.scope.files: 受影响文件
• clarified_task.scope.no_touch: 不要接触
• clarified_task.success_criteria: 可衡量标准
• clarified_task.constraints: 限制
• metadata.original_request: 原始请求
• metadata.confidence: 高/中/低

阶段5: 确认与提示预览

向用户展示可读总结，包括目标、问题、范围、成功标准、限制。

问题：我应该开始吗？（是 / 否 / 调整：…） 或：/prompt-architect 用于结构化最佳实践提示

阶段6: 对确认的反应

回答	行动
是 / 好 / 开始 / 做	执行与内部JSON上下文
否 / 停止 / 取消	取消，询问替代方案
调整：…	修改JSON，再次显示
/prompt-architect	传递给prompt-architect技能
直接做	根据自己判断执行

转义机制

用户可以随时跳过澄清：

• 直接做
• 自己决定
• 不要提问
• 无所谓，只要X工作
• 直接做

转义时：根据最佳知识执行，但记录假设。

与prompt-architect集成

成功澄清后，用户可以调用 /prompt-architect。 prompt-architect技能使用阶段4的JSON，生成完整的 Claude 4.x 标准的最佳实践提示。

工作流程： clarify-spec -> JSON 输出 -> prompt-architect -> 执行

度量：成功

技能成功时：

• 实现后减少返工
• 用户说是的，这正是我的意思
• 首次实现满足所有标准
• 没有“这不是我的意思”的情况