SuperAPI AI 工具集

quality-retrospective

测试与质量

查看项目

更新于 10-15 20:11

技能介绍

用途:在完成一个开发阶段(phase)后做质量回顾,从阶段产物中提取经验教训、可复用模式和改进机会。

主要能力:支持四种模式——无参数为扫描模式,列出未回顾的已完成阶段;单个数字为单阶段模式;N..M 为区间模式;--all 为批量模式。可用 --lens 限定技术、流程、质量、决策四类视角之一(可重复);--no-route 只生成回顾文件,跳过自动创建 spec/note/issue;--compare M 生成与阶段 M 既有回顾的差异对比;-y 自动接受所有路由建议。

使用方式:命令示例 $quality-retrospective、$quality-retrospective "3"、$quality-retrospective "2..4"、$quality-retrospective "--all"、$quality-retrospective "3 --lens technical --no-route"、$quality-retrospective "3 --compare 2 -y"。执行流程为:解析模式并校验产物(要求阶段目录存在、index.json 状态为 completed、存在 .task/ 任务)→ 生成上下文 agent 加载全部阶段产物 → 并行派生四个视角 agent(技术、流程、质量、决策)→ 综合 agent 去重、生成 INS 稳定 id 并按 spec/issue/knowhow/none 分类路由 → 写入 retrospective.md 与 retrospective.json,并把洞察追加到 .workflow/specs/learnings.md。

输出与写入:回顾写入阶段回顾目录,另可写入 state.json、issues.jsonl 和 specs(仅追加)。输出边界为绝不修改源代码、verification.json、review.json、plan.json 等既有产物。

限制与错误:未初始化 .workflow 报 E001,未知 --lens 报 E002,--compare 需单阶段模式报 E003,阶段无执行产物报 E004,阶段目录缺失或未完成报 E005;视角 agent 超时产生 W001 部分覆盖,存在既有 retrospective.json 时提示覆盖并归档;对比目标无回顾则省略差异段。实际执行细节依赖该技能所在 maestro-flow 环境,具体环境配置暂未提供。