用途:在用户级(user scope)为 Claude Code、Codex、Copilot CLI、Cursor 安装共享的个人默认 AI 编码指令,并支持更新与审计,避免把全局规则复制进每个仓库。
主要能力:只读检测可用系统(command -v 加已有目标文件),不默认修改所有检测到的系统;读取 references/platform-paths.md 解析各系统路径与 home 覆盖;内容可选内置 assets/global-instructions.md 或经 --template 指定的用户文件;默认预览模式,--apply 才写入;仅管理 <!-- research-skills:global-instructions:start --> 与 end 标记之间的块,块外内容逐字节保留,标记不匹配或重复时报错;审计当前仓库中重复的通用规则,仅报告精确重复或冲突,删除项目内容需另行批准。
使用方式:先选择要配置的系统,再运行脚本预览:uv run python scripts/install_user_instructions.py --systems claude,codex,copilot;确认后加 --apply 写入。Cursor 需手动在 Cursor Settings > Rules 粘贴,不虚构文件路径。脚本不在当前目录时用绝对路径。
适用场景:统一个人跨工具默认指令、审计仓库中重复的通用规则。
限制:写入工作区外可能需运行时文件系统批准;Cursor 保持手动;通用个人默认留在用户级,仓库内 AGENTS.md、CLAUDE.md、.github/copilot-instructions.md、.cursor/rules 只放项目事实或系统/路径级差异;CLAUDE.md 不重复共享项目规则,应导入 AGENTS.md 并追加 Claude 专属差异。内置默认编码了 agent-fanout 路由契约(最强层主导判断、中间层细化已批准计划、工作层实现并带测试与门禁),并要求关闭/移除已完成的一次性 agent。散文源一般用语义换行;GitHub issue 与 PR 正文例外,每段保持一行,段间空行,段内不插入句级或子句级换行。