forge-deliver

文档落地路径：遵循 forge-doc-policy 规范。完整白名单 + frontmatter schema 见 ~/.claude/skills/forge-doc-policy/doc-paths.md。 当前文档加载顺序：编排层先读项目 CLAUDE.md、docs/README.md、docs/INDEX.md、 .features/_registry.md 和相关根级当前真相源；历史账本只按需追溯。 详细规则见 ~/.claude/skills/_shared/current-doc-loading.md。

/forge-deliver v2：端到端交付编排层

一句话描述你的想法，拿到完整交付。

---

三条铁律

1. 编排不实现 — deliver 不写任何业务逻辑、不做设计、不写代码。所有领域工作由对应 forge-* 子 Skill 完成。deliver 只负责：调度顺序、传递输入输出、管理状态。
2. 状态必持久 — 每个 Phase 完成必须更新 state.json + 保存检查点。崩溃后 --resume 能从任意 Phase 恢复。
3. 证据先于断言 — 每个 Phase 完成必须有可验证的产出文件。不接受"已完成"的口头声明，必须检查文件存在且非空。

---

前置脚本（每次先运行）

_BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)
echo "当前分支: $_BRANCH"
echo "项目根目录: $_ROOT"

# 检测项目环境
[ -f "$_ROOT/package.json" ] && echo "检测到: Node.js 项目" && head -5 "$_ROOT/package.json"
[ -f "$_ROOT/requirements.txt" ] && echo "检测到: Python 项目"
[ -f "$_ROOT/go.mod" ] && echo "检测到: Go 项目"
[ -f "$_ROOT/Cargo.toml" ] && echo "检测到: Rust 项目"
[ -f "$_ROOT/Makefile" ] && echo "检测到: Makefile"

# 检查 .deliver 状态
if [ -f "$_ROOT/.deliver/state.json" ]; then
  echo "====== 发现未完成的交付流水线 ======"
  cat "$_ROOT/.deliver/state.json"
  echo ""
  echo "提示：使用 --resume 从检查点恢复"
fi

---

参数解析

从用户输入中解析：

参数	默认值	示例
模式	交互	--auto（全自动）
需求	用户输入的文字	"给信息雷达加 RSS 订阅"
恢复	否	--resume（从检查点恢复）

---

模式说明

交互模式（默认）

在 3 个硬卡点暂停等待用户确认：

1. Phase 0 完成后 — 需求方案确认
2. Phase 2 完成后 — 工程实现确认
3. Phase 7 — 验收报告交付

其他 Phase 自动推进，遇到不确定问题时用 AskUserQuestion 询问。

自动模式（--auto）

前置沟通（1-2 轮，必须）：

执行任何阶段之前，先完成前置沟通。这不是可选的。

第 1 轮（必选）— 需求对齐： 通过 AskUserQuestion 确认：

• "我理解你要做的是 [复述需求]，对吗？"
• "项目类型判断：[frontend / backend / fullstack]"（决定是否跳过 Phase 1 的设计部分）
• "我的方案大纲是：[1-3 句话概括方案方向]"
• "预计影响 [N 个文件 / 新建 N 个文件]"

第 2 轮（按需）— 依赖确认： 只在以下情况触发：

• 检测到需要外部依赖（API key、数据库、第三方服务）
• 需求存在歧义
• 项目结构复杂（多个入口、微服务架构）

前置沟通完毕后： 全自动执行 Phase 0-7，不再暂停。