legacy-bootstrap

Legacy Bootstrap v2.0

概述

使用 npx repomix@latest 汇总当前本地 legacy 项目上下文，通过类型驱动的产物管线分析项目结构、架构、模块、依赖、风险和未知项，并将结果逐一沉淀到目标项目的 cadence/ 目录。

该 skill 属于 cadence-init 插件，面向已经在 Claude Code 或 Codex 中打开的本地 clone 项目。

核心原则

• 只处理当前打开的本地项目，不 clone 远程仓库。
• 默认使用 npx repomix@latest。
• 所有认知产物写入 cadence/，不生成 .ai/。
• 逐产物生成，边做边报告，禁止批量输出后遗漏。
• 按项目类型条件触发专属产物，确保覆盖完整。
• 产物生成完成后必须更新 CLAUDE.md 与 AGENTS.md。
• 不直接重构业务代码。
• 不把未知业务事实写成确定结论。
• --skill-generate 只作为结构参考，不作为主流程。

何时使用

使用场景

• 用户要求为 legacy 项目初始化项目认知。
• 用户要求使用 repomix bootstrap 当前项目。
• 用户要求生成架构、模块、风险、构建测试画像等 Cadence 文档。
• 进入历史项目并计划修改前，需要先建立项目认知。
• 当前 Claude Code 或 Codex 已经打开目标项目的本地 clone。

不使用场景

• 目标是全新空项目，没有 legacy 代码或历史结构需要梳理。
• 用户只要求查看少量文件或回答局部问题。
• 用户明确要求不生成 Cadence 文档。
• 用户要求分析远程 GitHub 仓库，但没有提供或打开本地 clone。

整体流程架构

Phase 1: 环境检测
  ├─ 确认项目根目录
  ├─ 读取项目规则（CLAUDE.md / AGENTS.md）
  └─ 运行 repomix 生成快照

Phase 2: 项目类型识别
  ├─ 从 repomix 输出中提取信号（框架、依赖、目录结构）
  ├─ 判定项目类型（可多选，取并集）
  ├─ 向用户展示判定结果并请求确认
  └─ 确定产物清单 = 核心产物 + 类型专属产物

Phase 3: 逐产物生成管线
  ├─ 按清单顺序，逐个产物：
  │   ├─ 从 repomix 提取相关信息
  │   ├─ 写入 cadence/ 对应路径
  │   └─ 输出确认行："✓ [N/总数] 已生成: <路径>"
  └─ 若某产物证据不足 → 输出："⚠ [N/总数] 跳过: <产物名> — 原因: <说明>"

Phase 4: 收尾验证 + 报告
  ├─ 检查所有应生成文件是否存在于磁盘且非空
  ├─ 更新 CLAUDE.md / AGENTS.md 认知链接
  └─ 输出 Bootstrap 汇总表

Phase 1: 环境检测

1.1 确认目标项目根目录

读取目标项目规则前，必须先确认当前工作目录是目标项目根目录。判断信号包括：

• .git。
• 主项目清单或包管理文件，例如 package.json、Cargo.toml、pyproject.toml、go.mod、pom.xml、build.gradle。
• 常见项目配置文件，例如 Makefile、README.md、tsconfig.json、vite.config.*、docker-compose.yml。

如果无法判断当前目录是否为目标项目根目录，先询问用户确认；确认不是根目录时停止执行，提示用户在目标项目根目录重新运行，不要对上级目录或不确定目录写入产物。

1.2 读取目标项目规则

在目标项目根目录优先读取：

• CLAUDE.md
• AGENTS.md
• .claude/rules/document-storage.md
• .claude/rules/markdown-format.md
• .claude/rules/code-usage.md
• cadence/project-rules/README.md

如果目标项目没有 Cadence 规则文件，使用默认目录约定：所有项目认知产物写入 cadence/ 下对应子目录，入口规则写入根目录 CLAUDE.md 与 AGENTS.md。

读取规则时只采纳与当前 bootstrap 相关的约束；不得修改目标项目 .claude/rules/ 中的框架规则文件。