v1.4.0 — 文档补全与版本对齐

Fixed

• 文档:docs/cli-reference.md 补全到当前 16 个 CLI 子命令全集 —— 此前停留在 v0.3 的 7 命令快照,缺 migrate / ack / evidence / finding / scope / preflight / backlog;CLAUDE.md / AGENTS.md 的「14 子命令」与 getting-started.md 的「13 子命令」计数同步更正为 16,并清理 getting-started.md 内「v1.1 新 CLI 段待下轮补」的失效提示。
• 文档:docs/migration/from-openspec.md §2.3 与 docs/migration/from-superpowers.md §4.3 的 --dry-run 说明更正为占位 stub 的真实行为(此前描述的 plan 预览 / missing-preview / cost estimate 输出尚未实现)。
• 版本对齐:.claude-plugin/plugin.json / .codex-plugin/plugin.json / .claude-plugin/marketplace.json 的 plugin version 及 scripts/run-forge.mjs 的 REQUIRED_RANGE 此前停留在 plugin 形态引入时的 0.3,与 npm 包 / git tag 的 1.x 线脱节;现统一对齐到 1.4.0(REQUIRED_RANGE → ^1.4.0),修复 plugin helper 按 ^0.3 永远拉不到 1.x CLI 的问题。
• 文档:docs/getting-started.md 第 0 步补充 forge CLI 安装说明 —— plugin 安装不提供 PATH 上的 forge,而第 3 步 forge preflight 需在 shell 直接调用;补 pnpm dlx / npm i -g 两种获取方式。
• 文档:docs/claude-install.md / docs/codex-install.md / docs/opencode-install.md 与 skills/writing-plans 中过时的 @accelerator-mzq/forge@0.3.0 / @^0.3 引用更正 —— 全局安装命令改为不钉版本,helper 范围对齐 ^1.4.0。

Added

• 文档:docs/migration/from-openspec.md 新增 §7「项目同时含 OpenSpec 与 superpowers」—— 此前两份迁移文档均未覆盖双 source 项目;新节说明须串行跑两遍 forge migrate,并提示两遍之间备份 migrate-report.md / migrate-trace.json(固定文件名,第二遍会覆盖第一遍)。from-superpowers.md 加 §8.8 对应 FAQ 指针。
• 文档:新增 docs/migration/from-existing-project.md —— 已有 OpenSpec / superpowers 项目接入 forge 的端到端教程(安装 → forge migrate → 验收产物 → 从 /forge:apply 接入主流程 → cleanup)。补上 getting-started.md(从空目录起步)未覆盖的「已有项目」入口;getting-started.md 与两份 from-*.md 加交叉指针。§4.2 增「让 AI agent 补缺件代替 --regenerate」一节,说明 --no-regenerate + agent 手补的免 API key 路径及与 --regenerate 的 fidelity 校验差异。
• forge/config.yaml 新增 model_tiers 配置:把 forge:subagent-driven-discipline §1 的 haiku/sonnet model tier 重映射到实际派发模型(默认恒等、不改变现状)。forge config set model_tiers.<tier> <model> 写入。仅对直接传 model 参数的 harness(如 Claude Code)生效;把 haiku/sonnet 档映射到更强模型会抬高 token / 调用成本。opus 档不可重映射。

Changed

• forge:subagent-driven-development 的 model 选型不再内联 matrix,改为指向 forge:subagent-driven-discipline §1 + model_tiers 配置(消除两 skill 的 model tier 摘要漂移)。forge:subagent-driven-discipline 的 §1 haiku/sonnet/opus 明确为 tier 标签,## Platform Note 措辞修正(区分跨 harness 与跨模型 provider)。
• package.json 新增 prepublishOnly 脚本(npm publish 前自动 pnpm build),避免漏构建发出缺 dist/ 的包。

Full Changelog: v1.3.0...v1.4.0