project-consistency-installerlisted

<!-- 一致性机制 version: 2026-08-18 --> # Project Consistency Installer 把 Project Consistency Kit 增量引入当前项目。安装器既能使用用户已有的本地源码 checkout 或干净分发目录,也能先从 GitHub Release 获取经过双层校验的只读套件源,再继续项目迁移。 核心原则: 1. **先定位源,再分析目标。** 套件源只读;当前工作目录才是目标项目。 2. **先计划、后确认、再写入。** 不静默覆盖已有内容,不擅自初始化 Git、commit 或 push。 3. **职责分离。** PROJECT 保存项目事实,AGENTS 保存 Agent 规则,README 保持用户自有,CLAUDE 只做链接适配。 4. **行为只有一个正本。** 本 Skill 是安装工作流正本;宿主命令只允许做薄适配。 ## 步骤 0 · 确定目标项目与套件源 1. 把 Skill 被调用时的当前工作目录���为 `TARGET_DIR`;后续切换目录后仍不得丢失这个目标。 2. 按以下顺序寻找套件源: - 用户本次明确提供的本地路径; - 环境变量 `PROJECT_CONSISTENCY_KIT_DIR` 指向的路径; - 当前目录本身就是套件源码仓库或干净分发目录(仅用于识别,若 `TARGET_DIR` 等于套件根则停止,不得把套件安装进自身); - 运行本 Skill 随附的 `scripts/fetch-kit.sh`,从规范 GitHub Release 获取干净分发包到机器缓存。 3. 运行下载脚本前,说明将访问网络并写入机器缓存,按当前 Harness 权限机制取得批准。脚本路径必须相对于**当前已加载的本 Skill 文件**解析,不得相对于目标项目猜测: ```bash bash "<本 Skill 所在目录>/scripts/fetch-kit.sh" ``` 可选参数: ```bash bash "<本 Skill 所在目录>/scripts/fetch-kit.sh" --release <v-tag> bash "<本 Skill 所在目录>/scripts/fetch-kit.sh" --offline ``` 用户提供的本地路径若含 `DISTRIBUTION-METADATA.txt`,先用该目录内部同版本脚本做只读校验,再把 stdout 路径作为套件源: ```bash bash "<本地分发目录>/skills/project-consistency-installer/scripts/fetch-kit.sh" \ --verify-dir "<本地分发目录绝对路径>" ``` 4. 脚本 stdout 的最后一行是干净分发目录绝对路径。完整读取该路径下的 `skills/project-consistency-installer/SKILL.md`;若它不是当前已加载文件,把获取到的版本视为后续行为正本,从步骤 1 继续,不要再次运行步骤 0。 5. 验证套件源至少包含: - `skills/project-consistency-installer/SKILL.md` - `.agents/skills/catchup/SKILL.md` - `.agents/skills/wrapup/