SuperAPI AI 工具集

cli-forge-scaffold

编程与开发

查看项目

更新于 10-15 20:10

技能介绍

用途:cli-forge-scaffold 是 cli-forge 技能族的脚手架阶段,用于在 CLI 契约(Plan)已明确批准后,从基线模板创建全新的 Rust CLI Skill 项目。该阶段不做设计决策,只严格按 Plan 蓝图生成代码。

主要能力:按已批准的 cli-plan.yml 与 ./templates/ 模板展开目录结构与文件;将模板中的 dot-* 资源别名还原为点前缀输出路径;检查无未解析的 {{token}} 占位符;生成 .cli-forge/scaffold-receipt.yml 回执。

使用方式:入口条件为 cli-plan.yml 已存在并获批、skill_name 已知、目标项目目录不存在。必填输入为 skill_name 与已批准的 cli-plan.yml,可选 author、version、rust_edition。流程为:按 ./instructions/new.md 执行预检查,创建目录结构,严格按 cli-plan.yml 展开模板,验证无残留占位符,然后在生成项目根目录运行 cargo build、cargo clippy -- -D warnings、cargo fmt --check、cargo test,最后用 ./contracts/scaffold-receipt.yml.tpl 生成回执。

适用场景:需要从零生成符合既定契约的 Rust CLI 项目基线时使用。

限制:模板只能取自本技能包内的 ./templates/,不得外部引用;不得自行发挥项目结构或依赖;基线仅生成一次性 CLI,repl、stream、daemon 等可选能力不在基线内,需由 Extend 阶段添加,若 cli-plan.yml 标记 in_scope,需在回执 deferred_capabilities 中记录并提示用户;任一 Cargo 校验失败须阻断流程并修复后再移交。若存在延迟能力,需先询问用户是否立即运行 extend,否则继续 ../cli-forge-validate/SKILL.md 执行完整合规规则集。