SuperAPI AI 工具集

close-feature

部署与运维

查看项目

更新于 10-16 02:22

技能介绍

用途

close-feature 用于在生命周期实现协调器关闭之后执行特性收尾。它接受与 /start-feature 相同的人工特性选择器,将已交付的代码转化为经过对账、验证、可审计的产品状态。核心目录 <core-dir> 解析为已安装的 ../dstack-core 技能目录。

主要能力

  • 文档对账:对比已交付行为与特性 design.md、Documentation Impact 中列出的页面、实现改动的面向读者页面、架构与参考页面,以及 docs/src/planned-features.md、docs/src/features/index.md、docs/src/SUMMARY.md。创建或更新 docs/src/features/<slug>/index.md,并在 SUMMARY.md 与 features/index.md 的相应标记之间注册设计与已实现记录。
  • 验证:将每项必需检查分类为 passed、failed、unavailable、waived 或 not-applicable。根据设计验证策略、子验证命令、变更路径归属、生成/文档一致性等构建受影响的检查集,并在文档变更时运行 check-docs.py。
  • 双评审:派生实现完整性(dstack-implementation-reviewer)与交付完整性(dstack-delivery-integrity-reviewer)两个独立瞬态任务,并发启动两个全新只读评审者。
  • 交付动作:支持 pr(创建拉取请求)、merge(合并并收尾)、ready(保持就绪)、no action(完成收尾后询问用户)。

使用方式

  1. 运行 bd prime,只读解析特性选择器,获取根 ID 后运行 migrate-review-topology.py guard。
  2. 在启动版本记录或任何收尾 Beads 变更前,解析规范基础工作树并运行 reconcile-beads-interactions.py preflight。
  3. 依次执行文档对账、验证、双评审、提交对账、确定交互边界、选择交付动作。
  4. merge 模式默认仅授权快进合并;仅当目标仓库 AGENTS.md 明确接受合并提交时才授权合并提交。

适用场景

适用于使用 Beads 工作流管理、已完成实现协调器关闭、需要将代码交付转化为可审计产品状态的特性收尾阶段。

限制

  • 工作流从不强制推送、删除远程分支、绕过钩子或在确认合并前移除工作树。
  • 收尾评审子代理为只读。
  • 仅显式 pr 模式授权创建拉取请求;仅显式 merge 模式授权合并与合并后工作树移除;ready 与 no action 模式均不授权。
  • 同一评审边界没有第三次验证通过;material/protected 验证发现或验证后重叠将变为 redesign_required。
  • 受保护发现在任何严重级别下均不可豁免。
  • 基础工作树存在其他脏状态时阻止合并。
  • 具体收费、价格、平台支持等信息暂未提供。