用途:spec-forge-cli 是 spec-forge 工作流家族的包内 Rust CLI 运行时,负责初始化工作区、解析交互、应用答案、检查与修改持久化 YAML 产物、记录审批、选择焦点批次、检查门禁、推进阶段、校验 UX 契约,以及返回帮助信息。
主要能力:命令面包括 init、resolve、apply、focus、artifact get、artifact put、artifact merge、approve、gate check、stage advance、ux validate、help。输入为各命令专用标志和内联 YAML 值;多数命令支持 --target 解析项目目录、.spec-forge 集合或 spec 工作区,支持 --spec-id 在工作区状态不明确时显式选择活动 spec。结构化命令默认输出 YAML,并支持 --format json 与 --format toml。
使用方式:已发布二进制为 spec-forge-cli;开发调用为 cargo run --;发布二进制位于 target/release/spec-forge-cli。示例:spec-forge-cli init --target . --request-title "My Spec";spec-forge-cli resolve --target . --runtime-mode plan --write --format json;spec-forge-cli artifact get --target . --spec-id demo --file framing/request-context.yaml;spec-forge-cli help gate check --format toml。
帮助契约:非叶子命令默认在 stdout 输出人类可读帮助;--help 输出人类可读帮助;help [COMMAND_PATH ...] 输出 yaml、json 或 toml 结构化帮助;叶子命令缺少必需输入时在 stderr 输出结构化错误并返回非零退出码。
限制:源码构建需 Rust 1.85 或更新版本;运行开发命令需已检出的 spec-forge 仓库;仅在使用发布自动化工具时需要 Node.js 与 npm。该包只负责 Rust CLI 实现及其包内文档与测试,不重新定义阶段顺序、Plan 模式要求、审批门禁行为或更广泛的技能家族语义。其他细节暂未提供。