关于 clarify
clarify 是一种将粗略需求整理成可由其他 Agent 执行提示词的技能,面向需要明确任务范围和验收标准的工作。它会依据上下文决定直接完善请求,还是先询问关键问题。
主要功能
- 01按歧义程度选择完善或访谈
- 02先检查仓库上下文
- 03提取目标、约束与成功检查
- 04仅在明确要求时执行任务
- 05生成自包含的最终提示词
适用场景
- 01将模糊需求转成可执行任务
- 02在修改仓库前梳理相关文件和约定
- 03确认影响安全或兼容性的关键选择
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ owainlewis/ agent-skills --skill clarify安装后在 Claude Code 中输入/clarify确认已加载。
附带文件agents/openai.yaml
详细介绍
Clarify
将粗略请求改写为另一个 Agent 可执行的提示词。
选择模式
- 目标明确且缺失细节有安全默认值时,直接完善。
- 如果有一个未解决的选择会实质性改变行为、数据、安全性、兼容性、成本、输出或验证方式,则进行访谈。
- 只有当用户明确要求执行,或说“直接做”时,才执行澄清后的提示词。
流程
- 阅读请求及其引用的材料。
- 对于仓库相关工作,在提问前检查可发现的上下文,例如
AGENTS.md、CLAUDE.md、README.md、文件树和相关代码。 - 提取目标、当前状态、输入、输出、约束、范围边界、失败处理方式和成功检查项。
- 根据现有上下文,明确无歧义的引用和项目惯例。
- 如果用户之后可以更改某项假设,且无需重做任务,则采用合理的假设。
- 如果不存在安全的假设,则提出一个问题。收到回答后,检查是否还有其他重要决策未定。
- 加入执行提示词所需的全部上下文。不要提及“我们的讨论”或提示词之外的信息。
提出有用的问题
询问这类决策:
- 涉及哪些输入、文件、目录、系统或受众
- 必须生成什么输出、输出位置,以及是否允许覆盖现有内容
- 对无效输入、缺失数据、网络故障或部分成功的处理要求
- 会改变产品行为、安全性、兼容性、成本或架构的权衡
- 用于证明任务完成的可观察结果或检查项
不要询问外观选择、仓库中已有答案的惯例、已提供的细节,或有明显低风险默认值的偏好。
使用以下格式:
Question: <one decision>
Recommendation: <answer> because <short reason>.
编写最终提示词
只包含会影响执行的内容:
- 目标
- 相关上下文和当前状态
- 明确的输入和输出
- 工作范围内及范围外的事项
- 约束和安全假设
- 必需的失败处理方式
- 成功标准和验证方式
优先使用正向指令。解决矛盾,或说明哪条指令优先。仅在顺序重要时使用编号步骤。只有当缺失值无法安全假设且用户要求停止访谈时,才添加 [NEEDS: <detail>]。
返回:
Final prompt:
<self-contained prompt>
Assumptions: <only material defaults; omit when empty>
Gaps: <only unresolved [NEEDS: ...] items; omit when empty>
不要解决提示词中的任务、解释改写过程,也不要提供后续操作选项,除非用户提出要求。
评论
支持 Markdown