kxc7558 AI Crew Rules 安装器
你要为用户的项目安装一套"AI 施工队规矩"。按以下流程执行，每一步完成后用一句非技术语言向用户汇报，涉及写入用户配置的操作必须先说明再执行。
第 0 步：了解环境
- 确认目标项目目录（当前工作目录，或用户指定的目录）
- 检查项目是否已有 git 仓库、已有的 CLAUDE.md / AGENTS.md / 规则文件（避免覆盖，已有内容要走合并）
- 询问用户（一次问完）：
- 项目是长期维护还是一次性脚本？（决定要不要分层）
- 除了 Claude Code 还在用哪些 AI 编程工具？各自的额度情况（免费/订阅）？（决定派工单分工）
第 1 步：铺设分层骨架
仅当项目需要长期维护时执行；一次性脚本跳过并说明原因。
- 把
templates/layered-project/下的内容复制到项目根目录：CLAUDE.md— 项目宪法api/README.md、service/README.md、db/README.md、shared/README.md— 各层守则
- 若项目已有 CLAUDE.md，把宪法的"分层地图与调用方向"一节合并进去，不整体覆盖
- 若项目类型使目录名不合适（如纯前端项目），参照宪法中的映射说明改名（如 pages/store），方向规则不变
- 复制完成后立即
git init（若无 git）并提交首个节点，commit message:feat: ai-crew layered scaffold
第 2 步：安装启动关卡钩子
- 把
hooks/project-startup-gate.py复制到用户全局钩子目录：- Claude Code：
~/.claude/hooks/project-startup-gate.py
- Claude Code：
- 编辑
~/.claude/settings.json，在hooks下合并加入（保留已有配置，禁止覆盖整个文件）：
{
"hooks": {
"UserPromptSubmit": [
{
"hooks": [
{
"type": "command",
"command": "python \"<用户主目录>/.claude/hooks/project-startup-gate.py\"",
"timeout": 10
}
]
}
]
}
}
- Windows 下用绝对路径的 python.exe 和脚本路径
- 改完用 JSON 解析验证合法性，再向用户确认已安装
- 若用户主要工具不是 Claude Code（如 Codex 为主），跳过钩子，改为在
~/.codex/AGENTS.md（或对应工具的全局规则文件）中写入"开源优先 + 分层评估"两条硬规则（内容见第 4 步模板）
第 3 步：配置规则文件
- 把
templates/rules/layered-architecture.md复制到~/.claude/rules/common/（Claude Code 全局规则，目录不存在则创建） - 该文件末尾引用的骨架路径若与第 1 步实际路径不同，改成实际路径
第 4 步：生成多 AI 派工单
- 向用户确认各工具的额度格局（第 0 步已问）
- 基于
templates/rules/ai-dispatch.md生成定制版派工单，写入~/.claude/rules/common/ai-dispatch.md：- 按用户实际的工具清单填工种表（额度多的当施工队，额度稀缺最强的当主攻手+质检员，免费的当杂活工）
- 若用户只用 Claude Code 一个工具，生成简化版：仅保留防打架三原则和知识库规范，删除多工具工种表
- 若用户使用 Codex：把同一套厂规（分层、开源优先、git 节点、知识库）写入
~/.codex/AGENTS.md（已有内容走合并）
第 5 步：收尾验证与汇报
- 验证清单：
- 骨架四目录 + 各层 README 存在（若适用）
- settings.json JSON 合法且原有配置未丢失
- 钩子脚本存在且管道测试通过：
echo '{"prompt":"开发一个新功能"}' | python <钩子路径>应输出含 additionalContext 的 JSON - 规则文件就位
- git 提交所有变更（若适用）
- 用大白话向用户汇报装了什么、每件东西干什么，并提示：新会话开始生效；当前已打开的其他会话需重启或打开一次 /hooks 菜单
注意事项
- 全程 fail-open：钩子安装失败不阻塞对话，向用户说明后继续
- 不覆盖用户已有配置，只做合并；合并前先展示 diff 要点
- 用户是非技术背景时，汇报禁止出现 JSON/钩子/路径等技术细节堆砌，用类比和结果说话