mcpField
C
clarify

clarify

github.com/owainlewisAgent 工作流45118 次安装10 周前更新
代码仓库

关于 clarify

clarify 是一种将粗略需求整理成可由其他 Agent 执行提示词的技能,面向需要明确任务范围和验收标准的工作。它会依据上下文决定直接完善请求,还是先询问关键问题。

主要功能

  1. 01按歧义程度选择完善或访谈
  2. 02先检查仓库上下文
  3. 03提取目标、约束与成功检查
  4. 04仅在明确要求时执行任务
  5. 05生成自包含的最终提示词

适用场景

  1. 01将模糊需求转成可执行任务
  2. 02在修改仓库前梳理相关文件和约定
  3. 03确认影响安全或兼容性的关键选择

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/owainlewis/agent-skills --skill clarify

安装后在 Claude Code 中输入/clarify确认已加载。

附带文件agents/openai.yaml

详细介绍

Clarify

将粗略请求改写为另一个 Agent 可执行的提示词。

选择模式

  • 目标明确且缺失细节有安全默认值时,直接完善。
  • 如果有一个未解决的选择会实质性改变行为、数据、安全性、兼容性、成本、输出或验证方式,则进行访谈。
  • 只有当用户明确要求执行,或说“直接做”时,才执行澄清后的提示词。

流程

  1. 阅读请求及其引用的材料。
  2. 对于仓库相关工作,在提问前检查可发现的上下文,例如 AGENTS.md、CLAUDE.md、README.md、文件树和相关代码。
  3. 提取目标、当前状态、输入、输出、约束、范围边界、失败处理方式和成功检查项。
  4. 根据现有上下文,明确无歧义的引用和项目惯例。
  5. 如果用户之后可以更改某项假设,且无需重做任务,则采用合理的假设。
  6. 如果不存在安全的假设,则提出一个问题。收到回答后,检查是否还有其他重要决策未定。
  7. 加入执行提示词所需的全部上下文。不要提及“我们的讨论”或提示词之外的信息。

提出有用的问题

询问这类决策:

  • 涉及哪些输入、文件、目录、系统或受众
  • 必须生成什么输出、输出位置,以及是否允许覆盖现有内容
  • 对无效输入、缺失数据、网络故障或部分成功的处理要求
  • 会改变产品行为、安全性、兼容性、成本或架构的权衡
  • 用于证明任务完成的可观察结果或检查项

不要询问外观选择、仓库中已有答案的惯例、已提供的细节,或有明显低风险默认值的偏好。

使用以下格式:

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