SuperAPI AI 工具集

swain-retro

通用与其它

查看项目

更新于 10-15 20:29

技能介绍

用途:在自然收尾点捕获并沉淀经验,既可由 swain-design 在 EPIC 进入终态(Complete、Abandoned、Superseded)时自动触发,也可手动通过 /swain-retro 调用。

主要能力:EPIC 范围回顾会把 ## Retrospective 章节追加到 EPIC 工件、位于 Lifecycle 表之前;跨 EPIC 或基于时间的回顾生成独立文档 docs/swain-retro/YYYY-MM-DD-{topic-slug}.md。支持自动(非交互,如派发代理、批处理)、交互(现场会话,逐条提出“顺利/意外/想改变/模式”四类反思问题)、手动与限定范围(/swain-retro EPIC-NNN 或 SPEC-NNN)四种模式。会依上下文提取学习项:消费者项目写入 Claude 记忆文件(feedback/project 类型)并更新 MEMORY.md;swain 仓库本身则输出 SPEC/ADR/EPIC 候选或 GitHub issue。

使用方式:先判定证据来源,有活跃会话用会话证据,否则回退到 git log。示例命令包括:REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"、bash "$REPO_ROOT/.agents/bin/swain-session-check.sh"、bash "$REPO_ROOT/.agents/bin/chart.sh" deps <EPIC-ID>、bash "$REPO_ROOT/.agents/bin/swain-bookmark.sh" "Completed retro for {scope} — {N} learnings captured"。写完后可用 resolve-artifact-link.sh 为裸工件 ID 加链接,并用 artifact-context.sh 取上下文。

适用场景:开发流程复盘、EPIC 收尾沉淀、跨迭代主题归纳。

限制:禁止用 tickets(tk / .tickets/)作为回顾证据(ADR-015),应以会话日志和 git 历史构建叙述;每次回顾最多 3-5 个记忆文件;回顾不创建 SPEC/EPIC/ADR,交由 swain-design 处理;swain-retro 不可用时 EPIC 转换仍可完成,只是缺少回顾章节。README 漂移检查依赖 README.md 存在。