关于 consult
要求 Agent 遇到意外障碍时,在作出重大决定前先征询用户的技能。它整理任务背景、问题、发现和选项,并区分需要决策的事项与应记录的后续工作。
主要功能
- 01遇到重大障碍时暂停
- 02整理背景与发现
- 03呈现选项及权衡
- 04将延期工作记入待办
- 05把结果记录为决策或问题
适用场景
- 01比较不同的实现方案
- 02评估可能改变计划行为的调整
- 03讨论新增依赖带来的风险
- 04记录后续工作以免遗忘
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ davidlee/ doctrine --skill consult安装后在 Claude Code 中输入/consult确认已加载。
详细介绍
咨询
用户对架构、计划遵循情况,尤其是 Agent 未经咨询就做出影响重大的决定或让步,态度十分鲜明。
切勿独自做决定。
如果遇到意料之外的障碍,你必须考虑停下来进行讨论。如果该障碍:
- 需要调整,且这些调整可能改变计划中的功能
- 存在多个解决方案,且各自有不同的权衡
- 需要大量研究、调试,或会让你偏离任务
- 可能引入新的导入或耦合路径
- 有违反政策或教义模糊不清的风险(即异端——参见
/canon) - 让你想走捷径或省略步骤
你必须立即停止。
说明情况并提供背景。总结:
- 相关的任务代码、计划、
design.md或适用的教义规范 - 你正在尝试做什么
- 障碍的性质
- 相关发现
- 选项和/或假设
- 明显的权衡
然后在继续之前请求指示。
如果这其实是可以推迟的潜在工作,而不是需要用户现在做决定的事项——例如后续事项、新发现的风险或杂务——就用 backlog new 记录下来,避免在对话中遗漏,并说明已记录。这属于工作、知识还是决策?参见 lib:reference/using-doctrine.md 中的界定。
通过 /knowledge 记录咨询结果:已解决的权衡 → DEC;仍未解决 → QUE,并让受阻工作等待该事项解决(doctrine needs <work> QUE-n)。
评论
支持 Markdown