cli-forge-scaffold

cli-forge Scaffold

当任务是基于基线模板创建全新的 Rust CLI Skill 项目，并且详细的 CLI 合约（Plan）已明确定义并获批时，使用此阶段。

目的

使用获批的 cli-plan.yml 和权威模板，为新 Skill 生成基线代码库。

此阶段不做设计决策；它严格遵循 Plan 阶段提供的蓝图。

规范参考

• ./instructions/new.md
• ./planning-brief.md
• ./contracts/scaffold-receipt.yml.tpl
• ./templates/

入口门槛

#	检查项	来源
1	cli-plan.yml 存在且已获批	Plan 阶段
2	skill_name 已知	Plan 阶段
3	目标项目目录不存在	文件系统

必需输入

• skill_name
• 获批的 cli-plan.yml
• 可选的 author、version、rust_edition

工作流

1. 按照 ./instructions/new.md 中的要求运行预检查：要求提供 Skill 名称、验证 cli-plan.yml，并拒绝覆盖现有目录。
2. 创建目录结构。
3. 严格按照 cli-plan.yml 和指令文件中的定义展开 ./templates/ 中的模板，并将任何适用于安装的 dot-* 资源别名还原为其预期的点号前缀输出路径。
4. 验证不存在未解析的 {{token}} 占位符。
5. 在生成项目的根目录中运行所需的验证命令：
   • cargo build
   • cargo clippy -- -D warnings
   • cargo fmt --check
   • cargo test
6. 确认生成的软件包布局未超出文档所述的范围：基线生成文件加上功能专属支持文件。仓库拥有的 CI 工作流和发布脚本必须留在生成项目之外，直到 Publish 阶段。
7. 使用 ./contracts/scaffold-receipt.yml.tpl 中的模板生成 .cli-forge/scaffold-receipt.yml。

输出

• 新的 Rust CLI 软件包目录
• .cli-forge/scaffold-receipt.yml

出口门槛

#	检查项
1	所有模板均已展开，且没有未解析的占位符
2	cargo build 通过
3	cargo clippy -- -D warnings 通过
4	cargo fmt --check 通过
5	cargo test 通过
6	已生成 scaffold-receipt.yml

防护要求

• 此阶段只能使用随附 ./templates/ 目录中的模板。不得在此 Skill 软件包之外查找脚手架模板。
• 仅将 ./templates/ 中的 dot-* 资源名称视为适用于安装的别名。生成输出必须还原为预期的点号前缀文件名。
• 不得自行设想项目结构或依赖项。所有内容都必须以 cli-plan.yml 为依据。
• 脚手架基线仅生成可运行的一次性 CLI。不包含可选功能（repl、stream、daemon）；这些功能必须在基线项目通过验证后由 Extend 阶段添加（../cli-forge-extend/SKILL.md）。如果 cli-plan.yml 将任何功能标记为 in_scope，则继续生成基线，在 scaffold-receipt.yml 的 deferred_capabilities 下记录延期功能，并告知用户哪些功能需要下一步进入 Extend 阶段。
• 如果任何 Cargo 验证步骤失败，则阻止工作流继续，并在移交工作前修复脚手架生成的文件。

下一步

如果 scaffold-receipt.yml 列出了延期的功能，请在交接前使用 AskUserQuestion 提示用户。提出立即为每项延期的功能运行 extend。如果用户确认，请按顺序为每项延期的功能调用 extend。如果用户拒绝，请改为列出每项功能对应的确切 /cli-forge-extend 调用方式（参见 instructions/new.md 中的 Capability Deferral）。否则，继续使用 ../cli-forge-validate/SKILL.md 运行完整的合规规则集。