claude

Claude

Claude Code 是一个位于 PATH 上的独立 Agent（claude），与当前工作树共享文件，并且已完成身份验证。可将它用作第二意见或委派任务的执行者，但不要将其视为事实依据：核实它的说法，自行负责任何更改，并严格限定它的任务范围。

默认设置

除非用户或任务要求使用其他模型或思考级别，否则使用 claude -p --model opus --effort high。保留 opus 作为别名，让 Claude Code 使用当前的 Opus 版本；不要在此技能中固定使用带日期的模型 ID。

• 模型： 优先使用 opus、sonnet 或 fable 等别名，它们会跟随当前 Claude 版本。仅当用户或任务要求使用特定模型时，才接受完整模型名称，并先确认该模型仍是当前版本。默认使用 opus。
• 思考级别： 传入 Claude Code 的 --effort 标志。有效级别为 low、medium、high、xhigh 和 max。默认使用 high。
• 成本控制： 对于探索性请求，如果用户给出了预算或任务可能不断扩展，则添加 --max-budget-usd <amount>。

示例：

claude -p --model opus --effort high "<prompt>"

向 Claude 提示任务

像安排操作任务一样向 Claude 提示：简洁、分块，并明确说明所需产物。明确的任务约定比提高思考级别更有效。

• 每次运行只安排一项任务。 将审查、实现和文档编写拆分成独立提示。
• 相关时指明仓库技能。 Claude 可以读取仓库文件；提示它“为文档遵循 write-docs”或“遵守 refactor-clean：不要添加兼容性包装器”，而不是把这些技能粘贴进提示。
• 仅在有用时添加以下区块：
  • <task> — 具体工作、上下文和预期结果。
  • <output_contract> — 精确的回复格式，按重要性从高到低排列。
  • <default_follow_through> — 对低风险情况采用合理解释并继续；只有缺少的信息会影响正确性、安全性或不可逆操作时才停止。
  • <verification_loop> — 根据要求检查结果，并在定稿前进行修改。
  • <grounding> — 要求每项说法都以代码或工具输出为依据；标明推断。
  • <action_safety> — 严格控制差异范围；不要顺手重构。
• 反模式： 模糊的提示、混合多项工作、没有输出约定、要求它“想得更深入”而不是收紧任务，以及不核查证据就接受它的回答。

咨询

当用户要求了解 Claude 的看法，或第二个 Agent 的审查能显著降低风险时，使用 Claude 进行咨询。除非用户明确要求它编辑，否则应以只读为主。

1. 要求提供证据，而不是凭感觉作答：要求提供文件路径、观察到的行为、命令输出或明确标注的推断。
2. 审查时优先使用只读工具： --tools "Read,Grep,Glob,Bash" --permission-mode dontAsk。
3. 所需工具不能少于输出约定的要求。 阅读你自己的提示，并确认每项要求都需要使用什么工具。如果评审者无法运行命令，却被要求给出数字，它仍会给出数字——自圆其说、实则毫无测量依据，还会声称自己写入了产物。缩减工具范围不会让回答更谨慎，只会让编造更难被发现。要么授予所需工具，要么停止索要相关说法。
4. 要求数字附带凭据：回复中的任何数量都必须同时提供生成该数字的命令及其输出。没有这些凭据的发现应直接剔除，而不是降低权重。
5. 根据代码逐一评估每项发现，再采取行动。报告 Claude 提出了哪些问题、哪些被采纳，以及哪些被驳回。

实现 — 仅在明确要求时

只有当用户指定 Claude 执行任务时，才将实现工作委派给 Claude。 绝不可主动委派，也绝不可在没有新的明确要求时重新委派后续工作。

1. 明确划分任务：目标、约束、允许的范围和验证方式。 如果任务描述不够明确，就由你继续处理，直到新加入的 Agent 不会误解任务为止。
2. 从干净的工作树开始，或记录基线提交，以便区分 Claude 的差异与自己的改动。告诉 Claude 不要将临时文件（探测文件、转储文件、笔记）留在工作树中——它的差异中只能包含交付内容。
3. 根据任务所需权限选择权限：
   • 读取／审查：--tools "Read,Grep,Glob,Bash" --permission-mode dontAsk。
   • 小范围编辑：添加编辑工具，并在提示词中明确允许修改的路径。
   • 大范围自主工作：仅在专用工作树中使用 --dangerously-skip-permissions，提示词由你编写，并且必须在之后审查差异。
4. 默认使用 --output-format text 捕获响应。只有调用方需要结构化元数据时，才使用 --output-format json。
5. 你要对结果负责：检查差异、运行相关测试，然后再汇报结果。“Claude 说完成了”不代表任务已完成。

运行保障

claude -p 是联网且需要身份验证的非交互式运行。如果运行失败，先判断失败原因，再决定是否重试。

• 身份验证失败：除非用户要求，否则不要修复凭据；报告阻塞原因。如果沙箱中的 claude -p 提示 Not logged in，则使用所需的审批权限重试一次，因为本地身份验证可能依赖密钥链／会话访问权限。
• 沙箱／网络故障：如果该命令对任务很重要，则使用所需的审批权限重新运行。
• 运行时间过长：优先使用 --max-budget-usd 或缩小提示词范围，再考虑提高工作量。
• 工作区信任：-p 会跳过交互式信任对话框，因此只能在你有意信任的代码仓库或工作树中运行。

规则

• 默认调用方式为 claude -p --model opus --effort high；保持别名不带版本号，以便跟随当前的 Opus 版本。
• 允许用户用普通语言指定模型和工作量，并将其转换为 --model 和 --effort。
• 除非用户明确授权委派，否则不要让 Claude 在工作树中写入内容。
• Claude 正在编辑时，不要改动同一工作树。
• 将 Claude 的输出视为需要验证的证据，而不是可直接转述的权威信息。
• 工具表面必须与输出约定一致；若未授权相关工具，不得让输出中出现相应类型的声明。