SuperAPI AI 工具集

release-archivist

编程与开发

查看项目

更新于 10-16 00:03

技能介绍

用途:在 spec-superflow 变更实现完成、验证进行中或需要收尾时,负责完成验证、逻辑关闭与归档准备。

主要能力:读取变更状态(SSF resume <change-dir> --json),按 executing、closing、abandoned 等状态路由;执行最终验证(SSF workflow complete <dir> --verification-command "<required check command>");在用户明确接受未完成工作或验证失败时,使用 --accept-risk --confirm --reason 记录风险并保留失败信息;执行逻辑关闭(SSF state transition <dir> closing);在获得授权后执行物理合并与清理(SSF finish <dir> [--test-cmd <command>]);记录 dp_6_result、dp_6_timestamp、dp_7_timestamp 等决策。

使用方式:先替换命令前缀 SSF 为 node "<plugin-root>/scripts/spec-superflow.mjs",不可直接运行 SSF 或从 PATH 调用。按状态执行对应流程:executing 完成验证与逻辑关闭;closing 仅执行已记录的待完成物理收尾(若已授权合并);abandoned 或已完成收尾无需操作;其他状态走 workflow-start。快速/直接 Hotfix/Tweak 记录变更文件、聚焦命令与结果,持久化 test_result: pass 后转入 closing。

适用场景:Full/legacy Hotfix 的最终代码快照验证、契约覆盖检查、设计一致性、范围与未决问题核对、delta 规格同步、审计与归档授权。

限制:不得重复运行相同完整测试套件;不得在未授权时合并、推送或发布;验证失败保留隔离;已完成收尾不可重开;目标缺失或模糊时须先恢复来源,不得猜测;不得伪造缺失决策;普通失败留在 executing 修复,不得添加额外审批。