用途:该阶段为生成的 Rust CLI 技能定义统一、获批的描述契约,确保后续各下游界面复用同一措辞,避免各自编写互相冲突的表述。它回答“这个技能是什么”,详细的 CLI 契约(命令、标志、格式)属于下游的 Plan 阶段。
主要能力:定义或刷新一行式用途摘要与一段式定位声明;记录需保持同步的下游界面,包括 Cargo.toml 的 package.description、SKILL.md 用途段、README.md 标题与描述、各帮助文本摘要行、发布说明摘要、npm 包描述(发布范围内时);记录帮助契约:叶子命令默认返回结构化失败而非自动帮助,非叶子默认自动渲染类 man 可读帮助,--help 渲染类 man 可读帮助,help 返回结构化输出,可读帮助保持 NAME -> SYNOPSIS -> DESCRIPTION -> OPTIONS -> FORMATS -> EXAMPLES -> EXIT CODES 顺序;记录发布契约:Publish 同时负责仓库原生 GitHub Release 与 npm 发布。
使用方式:需满足入口条件(存在 classification: design 的 handoff.yml,技能范围至少部分已知)。确认是新建技能还是刷新已有契约,读取 ./planning-brief.md,填写并生成 .cli-forge/design-contract.yml(格式见 ./contracts/design-contract.yml.tpl)。生成后必须停止执行并请求用户明确批准,可用运行时对话框选择器(如 AskUserQuestion)提供批准继续、请求修改、暂时停止三项,不可用时改用编号文本菜单并附 Other: <自定义回复>;接受 1、2、3 或 Other: ...,若数字回复附带额外文字需先澄清。
限制:本阶段是用户可见用途与定位的权威来源,下游只消费已批准契约,不得重新定义;不得在此定义 CLI 命令、标志或输出格式;未获批准不得自主进入 Plan 或 Scaffold 阶段;npm 包描述及所有发布措辞必须复用同一获批契约。官方说明与定价等信息暂未提供。