用 AI 安全重构
大型系统到 Cosmos

访问 https://cc.gjs.ink/ ，读取页面上提供的「一键安装提示词」，然后照它执行，把这套 Claude Code 增强配置（来自 hongnono-wdh/claude-config，含插件 + Skill + MCP）装好。要求：
1. 严格按页面上最新的步骤执行；
2. 保留我已有的全局配置，绝不整体覆盖；
3. 每一步执行后确认成功，最后逐项验证安装结果；
4. 装完告诉我需要重启 Claude Code，让插件 / Skill 生效。

重启后第一件事：确认下面这些 skill 已经全部可用：
- /understand · /understand-dashboard · /understand-explain
- /understand-domain · /understand-diff · /understand-chat · /understand-onboard
- /brainstorming · /dispatching-parallel-agents · /executing-plans · /loop
任何一个缺失，按 RUNBOOK.md 的兜底列表补装：
  /plugin marketplace add Lum1104/Understand-Anything
  /plugin install understand-anything@understand-anything
  /plugin install superpowers@claude-plugins-official
全部齐了再告诉我，齐了才能进下一步。

我要重构这个项目，先建知识图谱：
1. 用 ls / find / wc / git ls-files 评估代码量级：文件数、总行数、顶级目录数。
2. 决策：
   - 文件数 < 5000 或总行数 < 30 万 → 整库 /understand。
   - 否则 → 不要全仓 understand（开销爆炸）。先列顶级模块清单，按"核心业务域"分批，只对核心域跑 /understand <子目录>，外围/平台代码跳过。
3. 报告：图谱产物路径、覆盖了哪些目录、跳过了哪些目录（说明为什么跳）。
建图谱期间禁止改任何代码，禁止进入下一步。

图谱建好后：
1. 启动 /understand-dashboard，告诉我访问地址。
2. 给我列"建议先看的 5 个核心模块"，每个附一句"看这个模块该重点关注什么"。
3. 同时你自己抽样校验 2-3 个核心模块的图谱：图谱里的依赖/职责，与真实代码是否一致？算错的列出来。
等我在 dashboard 上逛过、确认大方向对了，再进入下一步。

进入【对齐阶段】——这是 10 步里最关键的一步，做错全部白做。

1. 用 /understand-domain 提取业务领域 / 流程 / 步骤，整理"业务模块清单"：每个模块 → 职责、对外接口、依赖、是否核心、是否疑似死代码。
2. 主动调用 superpowers 的 brainstorming skill，跟我对齐"为什么要重构"：
   - 先反问我：当前最痛的点是什么？怎样算成功？硬约束（停服、API、前端、预算、deadline）？
   - 基于我回答，列 3-5 条"总主要矛盾"候选，让我选 / 补 / 否决。
3. 我确认了主要矛盾后，再给"重构思路与逻辑"：
   - 目标架构 + 每条要点对应解决哪个主要矛盾
   - 哪些模块要替换、哪些保留、哪些不动（次要矛盾不分心）
   - 明确"非动不可" vs "动了也没用"
4. 停下来问我："业务模块清单 + 主要矛盾 + 重构思路，正确吗？"

我答"正确"之前禁止进入下一步，禁止改任何代码。

建立"开模块前必做"的强制清单——每次开始重构一个新模块前都执行：
1. 调用 superpowers brainstorming skill，列出这个模块的：
   - 主要矛盾（这个模块为什么必须重构、最大风险/不确定性是什么）
   - 替代方案 ≥ 3 个，比较利弊
   - 不做哪些（划定本次不动的边界，避免一锅炒）
2. 把 brainstorming 产出写入 docs/refactor-log/<模块>.md：包括决策 + 理由 + 替代方案。
3. 把决策结论摘要给我，等我确认后才进入实际编码。

卡住 2 次以上 → 回到这里重新 brainstorming（同时调 nopua skill 换思路），不许硬刚。

建立重构工作日志机制：
1. docs/refactor-log/ 下每个模块一份 .md：目标、主要矛盾、TODO、checkpoints、决策记录、回滚指令、当前状态。
2. 维护 docs/refactor-log/INDEX.md：所有模块清单 + 当前状态 + 上次 checkpoint。
3. 并发多模块重构时，用 superpowers 的 dispatching-parallel-agents 或 TeamCreate：
   - 每个 teammate 负责互斥的模块/文件，避免覆盖冲突。
   - 每完成一个 checkpoint，立即更新自己的日志 + 提交原子 commit（绝不和功能改动混 commit）。
   - 主代理定期 TaskList 检查所有 teammate 进度。
4. 每天结束：主代理读所有日志，汇总成"今天进展 + 明天主要矛盾"给我。

没有日志记录的改动视为"未完成"，回滚或补记录。

每个 checkpoint 编码前后强制执行（写入 SOP）：

编码前：
1. /understand-explain <当前文件> — 吃透目标文件结构、依赖、被引用情况。
2. /understand-domain — 确认你要改的代码对应哪个业务流程的哪个步骤。

编码后、commit 前：
3. /understand-diff — 评估改动影响面与风险，列出受影响的下游模块。
4. 若改动涉及结构调整：跑增量 /understand 刷图谱（或对该子目录单独 /understand <path>）。
5. 把每次 understand 的结论摘要写进当前模块的 refactor-log。

跳过 understand 视为"未完成"，该次 checkpoint 必须回滚重做。

模块重构完成后，进入"完整验收"——所有项不过禁止合并：

1. 单元测试：覆盖率不低于原模块；用 characterization 测试锁定原行为。
2. 接口集成测试：该模块所有对外接口写 contract + golden snapshot 测试；新旧版本并行跑，影子 diff = 0 才算通过。
3. 用户视角验证：列出涉及该模块的所有用户业务流程（来自 /understand-domain 产出），逐个跑一次（先脚本、再人工抽样），确认页面表现与旧系统一致。
4. 端到端（e2e）：调用 webapp-testing 或 playwright-cli skill，把前端代码拉起来，从浏览器发请求，覆盖核心用户路径，截图前后对比。
5. 输出"验收报告"：覆盖率 / 契约 diff / e2e 通过率 / 不一致项处理方案。

任何一项不过，回对应步骤继续修，不允许"先合并再补"。

长任务长跑模式：

1. docs/refactor-goal.md — 当前阶段目标（具体到模块级，单一明确，可验证）。
2. docs/refactor-log/INDEX.md — 所有正在进行模块的日志索引 + 当前状态 + 上次 checkpoint。
3. docs/refactor-sop.md — 每次循环必做的事（基于步骤 6/7/8/9 的当前阶段子集）。
4. 启动 /loop（30-60 分钟较常用）：
   a. 读 goal + log + SOP，决定本轮做什么（不许做 SOP 外的事）。
   b. 调 brainstorming 确认本轮主要矛盾。
   c. 执行 + 更新日志 + 原子提交。
   d. 给我一份本轮纪要（完成 / 卡住 / 待我决策）。
5. 卡住 2 次以上 → 自动调 nopua skill 换思路，不许硬刚同一方向。
6. 动到禁区（前端 / 数据迁移 / 生产配置）一律拦截。

我每天/每周看一次纪要，调整 goal / SOP，剩下时间不打扰你。