用途:这是 cli-forge 技能家族中的 Description 阶段,用于在后续阶段推进前,为生成的 Rust CLI 技能建立一份权威的描述契约。当工作被归类为新生成的技能、请求的变更影响技能用途或用户可见契约,或后续阶段发现 Cargo 元数据、SKILL.md、README、帮助文本、发布摘要、克隆优先安装指引之间出现漂移时使用。
主要能力:产出经批准的一行用途摘要与定位声明;列出必须复用同一契约的描述载体,包括 Cargo.toml 包描述、SKILL.md、README.md、帮助文本/结构化帮助摘要、打包或发布面向的摘要、仓库原生发布/安装指引,以及可选的 npm 发布指引;给出渠道感知的发布摘要指导,仓库原生发布为主,npm 发布仅作为显式的次要 CLI 分发路径;明确下一阶段交接与完成标准。
使用方式:先确认是新建生成技能还是修改现有技能的用户可见契约;定义或刷新用途摘要与定位声明;记录需同步的下游载体;确认允许消费该契约的下一阶段;将契约向前传递。规范参考包括 ./instructions/new.md、./instructions/add-feature.md、./planning-brief.md。
适用场景与限制:适用于新技能进入 scaffold、现有技能契约变更进入 extend、描述对齐后进入 validate、验证完成后进入 publish 的流程。description 是用户可见用途与定位的权威阶段,scaffold、extend、validate、publish 只消费契约而不重新定义;publish 可汇总契约但不得覆盖已批准的描述载体。完成条件为所有必需描述载体均已命名、摘要与定位可供复用、下一阶段明确。资料未提供具体命令、价格或平台信息。