⚡

任务澄清工具Skill clarify-spec

这个技能用于自动检测和澄清软件开发中的模糊任务需求。通过识别模糊语言、缺少具体信息等问题，自动提问以明确目标、范围、成功标准等，并生成结构化JSON输出，以便于后续开发和集成。关键词：任务澄清、需求分析、自动化工具、结构化输出、软件开发效率、模糊任务处理、AI辅助、项目管理。

需求分析 0 次安装 0 次浏览 更新于 3/18/2026

名称：澄清规格 描述：| 在模糊任务时自动激活。宁可多次询问也不要错误实现。

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

  • 任务 <25 个词
  • 没有具体的文件名/路径
  • 模糊动词：更好、优化、修复、做、改变、改进、调整、扩展、重构、整理、修订
  • 不确定的语言： somehow、可能、 quick、简单、有点、可以、应该
  • 缺少成功标准：没有因此、所以、因为、为了
  • 没有上下文的相对术语：更快、更好、更美、更简单

输出是用于 prompt-architect 技能的结构化 JSON。 退出：直接做、不要问、自己决定跳过澄清。 触发词：

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

澄清规格 v2.0：自动任务澄清

激活：积极 – 宁可多次！

自动在以下信号时激活（满足一个即可！）

信号 示例 为什么有问题
简短任务（<25 个词） 让导出更好 上下文太少
没有文件名/路径 优化性能 范围不明确
模糊动词 更好、优化、修复、做、改变、改进、调整、扩展、重构、整理、修订 不可操作化
不确定的语言 somehow、可能、 quick、简单、有点、可以、应该 表示不明确
缺少成功标准 没有因此、所以、因为、为了 未定义目标
相对术语 更快、更好、更美、更简单 没有基准无意义
隐含假设 通常的、如常、标准 缺少上下文

不激活仅当所有满足：

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

工作流程

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

根据此清单检查每个任务：

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

少于 4 个勾选 = 提出问题！

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

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

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

格式 – 简短精确：

在我开始前 – 简短澄清：

  1. [最具体问题 – 什么 exactly？]
  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 功能正常
  • Just do it

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

与 prompt-architect 集成

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

工作流程： 澄清规格 -> JSON 输出 -> prompt-architect -> 执行

指标：成功

技能成功当：

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