SuperAPI AI 工具集

cli-forge-takeover

编程与开发

查看项目

更新于 10-15 20:09

技能介绍

用途:cli-forge Takeover 是 cli-forge 技能族的恢复阶段,用于把已存在但尚未携带所需 .cli-forge/ 契约的 Rust CLI Skill 项目纳入 cli-forge 流水线,且不假装该项目由 cli-forge 脚手架生成。

主要能力:从现有实现、文档、测试和帮助界面重建缺失的流水线产物,并写入专用接管回执供下游阶段信任。产出 .cli-forge/design-contract.yml、.cli-forge/cli-plan.yml 与 .cli-forge/takeover-receipt.yml。

使用方式:入口要求 project_path 已知且存在、目标目录含 Cargo.toml、项目缺少已批准的 cli-forge 契约基线或用户要求刷新,且用户接受歧义须先解决。需提供接管后的目标(validate、extend、publish 或一般流水线采纳)、接管模式(first_adoption、baseline_establishment 或 contract_refresh),以及检查实现、文档、测试和帮助输出的许可。流程包括读取 ./planning-brief.md 与 ./instructions/takeover.md,盘点 Cargo.toml、SKILL.md、README.md、src/、tests/ 及可观察的帮助与运行时行为,运行 Discovery Gate、Design Gate、Plan Gate 与 Baseline Gate,确保 .cli-forge/ 存在、.gitignore 忽略 .cli-forge/,并生成 takeover-receipt.yml。

适用场景:既有 Rust CLI Skill 项目需要加入 cli-forge 流水线、建立基线或刷新契约时。

限制:不得编造无法追溯到实现或用户明确决定的行为;重建契约须记录观察到的当前行为,不得静默替换为 cli-forge 默认值;代码、文档、测试与帮助输出不一致时应停下询问用户;不得伪造脚手架来源;接管本身不保证项目兼容 Extend,仅当仓库已匹配 Extend 的脚手架兼容布局时才可扩展;编辑限于流水线产物及托管所需的最小仓库卫生;若重写契约或 .gitignore 等受验证覆盖的基线表面,既有 validation-report.yml 视为过期;存在守护进程行为时须与 app-server 规划契约比对并明确指出不匹配;不自动发布。后续步骤按记录目标移交 Validate、Publish 或 Extend。