v0.6.0 · Sprint 5 完成 · Phase 1 全部完成 🎉

[0.6.0] - 2026-04-19 · Sprint 5 完成 🎉

主题: 统一 CLI + 对外发布 + 治理文件 + 文档站正式上线

上线

• 🌐 文档站: https://epcode-ai.github.io/ep-code-ai/(仓库公开,GitHub Pages 自动部署)
• 🛡️ Branch protection: 通过 ruleset 强制 main 必须走 PR + 10 个 CI check 全绿

新增 · 统一 CLI · epcode

CLI 位于 tools/cli/,通过根 package.json bin 字段暴露,支持 npx epcode:

命令	作用
init --mode=<A|B|C|D> --name=xxx	按接入模式初始化项目（从 scaffolds 复制骨架）
adopt --level=1..5	模式 C 渐进启用（更新 ADOPTION-LOG.md）
migrate --from=existing-code	模式 B 从现存代码反向生成 API 契约草稿
check	聚合质量校验（等效 check-all.js）
prd <file>	PRD 结构 + 可测性打分（二合一）
adr index [--check]	ADR 索引生成 / CI 校验
metrics [--since]	四场景度量 + METRICS.md 总看板
incident new / to-requirement	故障处置工作流
linkage prd-to-design / regression / release-plan	跨场景联动
jira sync / create-issue / list	Jira 集成封装

所有子命令都是对 tools/ 下现成脚本的薄封装,保持零 npm 依赖。

新增 · 4 种接入模式脚手架

tools/cli/scaffolds/mode-{a,b,c,d}/ 各自含:

• README.md 起步清单 + "为什么选这模式" + 常见坑
• mode B: BACKLOG.md 技术债清单
• mode C: ADOPTION-LOG.md 渐进启用日志
• mode D: SERVICE-LEVEL.md SLO/on-call/故障分级

变量 __PROJECT_NAME__ / __DATE__ 在 init 时替换。

新增 · 文档站

• docs-site/ · Docusaurus v3 静态站
• 首页以 4 接入模式 为一等公民（4 张大卡片）
• sidebars.js 按 docs/chapters/* 自动生成侧边栏
• .github/workflows/pages.yml · 每次 main 动 docs-site/ 或 docs/chapters/ 时自动构建 + 部署到 https://epcode-ai.github.io/ep-code-ai/

新增 · 治理文件

• package.json 根目录 · 暴露 epcode bin
• CODEOWNERS · 代码归属规则
• RELEASE_PROCESS.md · 版本节奏 / CHANGELOG / tag / Pages 的标准 SOP

未完成 · 试点复盘

原计划的 examples/pilot-npds-newpd/RETROSPECTIVE.md 因试点数据不足暂缓,留到真实项目跑一轮后再补。完成度影响: L5 从预期 85% 调整为实际 85%（因 CLI/文档站/治理三项充分完成）。

收尾日基础设施修复（2026-04-18 / 04-19）

• 🌐 仓库由私有转公开 + Pages Source 切到 GitHub Actions(私仓 Pages 要付费,违背零成本原则)
• 🛡️ Branch protection 用单套 protect-main ruleset(删旧 classic);Required approvals=0(单人项目,无法自审)
• 🔧 Docusaurus 构建链修:
  • 升级 3.5 → 3.8.1,npm overrides 锁 webpack 5.97.1 (修 ProgressPlugin schema 不兼容)
  • sidebars.js 改用 Docusaurus 剥离数字前缀后的 doc ID(adoption/README 而非 00-adoption/README)
  • MDX v3 把 <60 当 JSX,改为 <60 转义;表格内 <NN 同处理
  • 3 个 .js 文件链接转成 GitHub blob URL(避开 Terser 对非模块 JS 的处理)
  • onBrokenMarkdownLinks: 'ignore' 抑制 docs → 仓库其他目录相对链接的刷屏 warning
• 🧹 CI 修:
  • submission-check 正则增加 docs/chapters/ 和 templates/ 排除(避免方法论文章被当申请单误报)
  • submission-gate.md 长行从 201 改 197 字符(过 markdown-lint 200 字符硬门禁)
  • pages.yml 去掉 setup-node 的 cache 配置(首次无 lockfile)
  • ruleset 里 DR Index Up-to-date typo 改为 ADR Index Up-to-date

完成度

整体 96% → 98%。Phase 1(方法论 + 工具链 + CLI + 文档站 + 治理)全部完成。

---