用途：把仓库接入 CodeStable 工作流体系，只做两件事——搭骨架、归旧档。骨架完成后 feature/issue/compound 等子工作流可直接运行。启动后先扫描自动判断路径（空仓库或迁移），不交给用户选择；扫描结果模糊时说明依据并询问。
两条路径。空仓库（无 spec 类文档、无 .codestable/）：创建 requirements、roadmap、goals、features、issues、refactors、audits、brainstorms、compound 各聚合根目录，安装 .codestable/.gitignore，创建最小 attention.md 骨架，并从技能包整目录复制 gates/、tools/、reference/、hooks/。requirements/CONTEXT.md 与 adrs/ 不在骨架内，交由 cs-domain 在首次需要时创建。迁移（已有零散文档或部分结构）：先生成审计报告，列出文件、推测内容类型、建议归入位置与置信度；中/低置信度逐条与用户对齐，高置信度只列不逐条问；补齐缺失骨架；已有内容不覆盖，但 gates/、tools/、reference/ 一律用技能包新版本覆盖；用户选择跳过的文件不移动、不删除、不重命名，仅标注保留原位。
关键技术要求：复制共享目录必须用 cp -rf 或 Copy-Item -Recurse -Force 整目录覆盖，不要 Read + Write 手工搬（会截断大文件、改缩进）；复制后清理 pycache 与 .pyc；技能包路径一般为 skill 安装目录，可用 ls 定位；拷完用 ls 验证。可选分支保护 hook：hooks.codex.json 注册 PreToolUse 钩子，调用 codestable-ai-branch-guard.py，拦截在 main/master 上的代码改动，需手动合并进 agent hook 配置，onboard 不自动改全局配置。可选行级审查工具 open-code-review：用 which ocr 检测，未装时询问 owner 后 npm install -g @alibaba-group/open-code-review；ocr 独立配置 LLM，需用 provider 体系（ocr config set provider / providers.<name>.url / api_key / model），旧 llm. 块不生效，配后跑 ocr llm test 确认；再跑 python3 .codestable/tools/codestable-doctor.py --root . 自检，报告 OCR tool 状态。
限制：attention.md 实质内容必须由项目 owner 提供，AI 只给模板；迁移不得未经确认移动或删除文件；不重新引入 AGENTS.md/CLAUDE.md 兼容入口；搭完骨架不立即开始 feature/issue；低置信度必须问；不替 owner 编造或硬编码 API key；具体项目路径与命令中的占位符需按实际环境替换。