用途:在已有 CLAUDE.md(或其符号链接指向的文件)上增补生产级 agent 指令,修复 Claude Code 的部分内置限制,同时保留原有项目专属说明。
主要能力与流程:
- 解析目标文件:如传入了具体路径则使用该路径;否则以 CLAUDE.md 为目标,若为符号链接则用 readlink -f 解析真实路径。
- 完整读取现有文件,理解其结构、约定、目录或编号方式。
- 读取模板:${CLAUDE_PLUGIN_ROOT}/references/claude-md-template.md。
- 差距分析:参照 ${CLAUDE_PLUGIN_ROOT}/skills/analyze/references/source-leak-findings.md,逐项对照 7 个发现点(验证门禁、上下文死亡螺旋、简洁性要求、子代理蜂群、2000 行盲区、工具结果盲区、grep 非 AST),判断现有文件是否已覆盖。
- 合并指令:仅提取缺失或明显弱于模板的部分,按现有文件的标题层级与语气适配,并在文件末尾以“## Agent Override Directives”标题追加;不重复已有等价指令,不重排或重格式化原内容。
- 写入后向用户说明:新增了哪些指令、哪些已存在被跳过、当前覆盖指令总数,并提示可运行 fixclaude:analyze 获取详细差距分析。
适用场景:已有 CLAUDE.md 且希望补充生产级 agent 约束的 Claude Code 项目。
限制:依赖 fixclaude 插件及其模板与参考文件;具体行为受实际文件内容影响;资料未提供收费、价格与平台信息。