SuperAPI AI 工具集

claude

智能体与模型

查看项目

更新于 10-16 05:39

技能介绍

Claude 是一个独立的命令行代理,位于 PATH 中(命令为 claude),与当前工作树共享并已完成认证。它的定位是第二意见或受委派的执行者,而非权威结论:需要验证其声明、对任何改动负责,并保持任务契约足够窄。

用途

当用户明确要求 Claude、希望获得来自 Claude 的第二代理意见,或要求委派任务时,可使用 Claude Code 作为独立的 claude -p 子代理。它可用于咨询(读取代码、给出判断)和实现(仅在用户明确要求时)。

主要能力与默认设置

默认调用为 claude -p --model opus --effort high,除非用户或任务要求不同的模型或思考等级。模型接受 opus、sonnet、fable 等别名或完整模型名,默认 opus。思考等级通过 --effort 传入,有效值为 low、medium、high、xhigh、max,默认 high。对于探索性请求,当用户给出预算或任务可能发散时,可添加 --max-budget-usd <amount> 作为成本护栏。示例:claude -p --model opus --effort high "<prompt>"。

提示方式

应像操作员一样提示 Claude:紧凑、块状结构,并明确说明所需产物。更清晰的契约胜过更高的思考等级。每次运行只做一件事,将审查、实现和文档拆分为不同的提示。相关时可点名仓库技能,例如说“follow write-docs for the doc”或“obey refactor-clean: no compatibility wrappers”,而不是把技能内容粘贴进提示。可用块包括:<task>(具体工作、上下文和预期终态)、<output_contract>(精确的响应形态,最高价值优先)、<default_follow_through>(采取低风险解释并继续,仅在缺失细节影响正确性、安全性或不可逆操作时停止)、<verification_loop>(对照需求检查结果并在定稿前修订)、<grounding>(每个声明都基于代码或工具输出,标注推断)、<action_safety>(保持 diff 范围紧凑,不做顺手重构)。反模式包括:模糊提示、混合任务、没有输出契约、要求它“再想想”而不是收紧任务,以及不检查证据就接受其答案。

咨询

当用户询问 Claude 的看法,或第二代理的解读能实质性降低风险时,使用 Claude 进行咨询。除非用户明确要求其编辑,否则保持只读导向。要求证据而非感觉:要求提供文件路径、观察到的行为、命令输出或标注的推断。审查时优先使用只读工具面:--tools "Read,Grep,Glob,Bash" --permission-mode dontAsk。在行动前对每条发现对照代码进行分诊,报告 Claude 标记了什么、你接受了什么、驳回了什么。

实现——仅在明确要求时

仅当用户为该任务点名 Claude 时,才将实现委派给 Claude。不要主动交给它工作,也不要在没有新请求的情况下重新委派后续工作。将任务切分清晰:目标、约束、允许范围、验证方式。规格不足的任务留在自己手中,直到一个新代理不会误读它。从干净的工作树开始,或记录基线提交,以便 Claude 的 diff 与你的可分离。告诉 Claude 将临时文件(探针、转储、笔记)排除在工作树之外——其 diff 必须只包含交付物。按任务必须执行的操作选择权限:读取/审查用 --tools "Read,Grep,Glob,Bash" --permission-mode dontAsk;窄范围编辑则添加编辑工具并保持提示中的允许路径明确;广泛自主工作仅在专用工作树中使用 --dangerously-skip-permissions,配合自撰提示,并在之后强制审查 diff。默认用 --output-format text 捕获响应,仅当调用方需要结构化元数据时使用 --output-format json。你拥有结果:检查 diff、运行相关测试,然后才报告。“Claude 说完成了”不算完成。

存活性与失败处理

claude -p 是联网、已认证的非交互运行。若失败,先分类再重试。认证失败:除非用户要求,不要修复凭据,报告阻塞。若沙箱中的 claude -p 提示 Not logged in,在获得所需批准后重试一次,因为本地认证可能依赖钥匙串/会话访问。沙箱/网络失败:若该命令对任务重要,在获得所需批准后重跑。长时间运行:优先使用 --max-budget-usd 或更窄的提示,而不是提高思考等级。工作区信任:-p 会跳过交互式信任对话框,因此仅从你有意信任的仓库或工作树中运行。

规则

使用 claude -p --model opus --effort high 作为默认调用。允许用户用自然语言覆盖模型和思考等级,并将其转换为 --model 和 --effort。除非明确委派,否则让 Claude 的写入远离工作树。Claude 进行编辑时不要触碰同一工作树。将 Claude 的输出视为需要验证的证据,而非可直接转述的权威。