用途:为编写、编辑和审查技能提供原则,核心目标是让智能体每次运行采取相同流程(可预测性),而非产出相同结果。适用于新增技能、审查 PR、技能误触发或该触发未触发、同一输入多次运行行为不一致,以及判断某内容应做成技能、命令还是 CLAUDE.md 中的散文。
主要能力与要点:描述需说明技能是什么并列出应触发的分支,每个分支一个触发词,避免同义重复,并检查是否与现有技能或 hooks/user-prompt-submit.sh 冲突。信息分层为技能内步骤、技能内参考、外部参考(如 skills/blocks/),按每次运行是否都需要来决定内联或指针。每个步骤需有可检查的完成条件,避免“生成摘要”这类模糊标准。默认显式调用,技能带 disable-model-invocation: true;命令体直接从 ${HOME}/.claude-octopus/plugin/.claude/skills/<name>/SKILL.md 加载源文件,不调用 Skill 工具。涉及提供方、模型、访问、计费、评审或投票时加载 skills/blocks/domain-modeling.md,复用共享定义,不得仅凭二进制或传输名称推断认证、权益、计费模式、配额或模型族独立性。
限制:不适用于机械检查清单(文件布局、注册、必需章节,见 docs/PLUGIN-ASSEMBLY-STANDARD.md 与 CI)以及非技能的提示词编写(见 skill-meta-prompt)。若触发词与现有技能重叠应停止新增并扩展现有技能;若“智能体行为有何不同”的答案是“没有不同”则停止;若内容只是一段无流程的建议,应并入已有技能。审查时需报告结论、可预测性风险、触发冲突、不可检查的标准及错位内容。验证包括描述分支无同义词对、每步可评估、无触发冲突、已在 .claude-plugin/plugin.json 注册且 make sync 干净、声明 disable-model-invocation: true、tests/unit/test-explicit-activation.sh 通过。