afk-retrospective
GitHub自动读取AFK批次数据，提取并评估候选项，生成包含推荐决策的中文HTML复盘报告，供用户进行最终裁决。
Trigger Scenarios
Install
npx skills add ArcReel/ArcReel --skill afk-retrospective -g -y
SKILL.md
Frontmatter
{
"name": "afk-retrospective",
"description": "为刚完成的 AFK 批次生成中文 HTML 复盘报告。",
"disable-model-invocation": true
}
AFK 复盘
读取当前会话刚结束的 AFK 批次，生成只读报告供用户裁决。只在无法从会话确定 batch-id 时询问用户。
1. 提取候选
通读 .afk/<batch-id>.jsonl 与 .afk/<batch-id>/handoff-*.md，提取 follow-up、CONTEXT、ADR、agent instructions 和待用户裁决项。fault、merge 与普通 decision 只进入执行历程；pushback 只作来源，除非 handoff 已将其提升为候选。
运行 git fetch origin，在最新 origin/main 验证工程候选。淘汰已修复、不可达或前提错误的项；按“同一触发路径 + 同一预期改变”去重。为保留项分配临时 CAND- ID，确保每条原始候选都有保留项或淘汰理由。
2. 独立评估
有候选时，读取 evaluator-prompts.md，同时委派三个干净上下文的只读 evaluator；没有候选时跳过。team-lead 确认每个临时 ID 收齐三个结果并复查冲突事实；无法消解的冲突写入对应候选的未知项。每个临时 ID 收齐三个结果后，本步骤完成。
3. 生成报告
读取 report-content-contract.md 决定推荐强度、知识动作并编写正文，再按 analysis-contract.md 在操作系统临时目录写 analysis.json。待裁决项同时写结构化互斥选项。确认每个报告 ID、来源和保留候选都已纳入后运行：
uv run python .agents/skills/afk-retrospective/scripts/render_report.py \
--repo-root <repo-root> \
--batch-id <batch-id> \
--analysis <analysis-json>
renderer 负责校验批次边界、可渲染字段与来源引用，嵌入 ledger/handoff 快照并生成 HTML。失败时报告错误并停止；成功条件是报告覆盖所有保留候选、每篇正文满足内容契约、所有来源可到达对应 ledger 事件或 handoff、每个待裁决项至少有两个互斥选项，且存在可行动候选时已给出 Top recommendation。达成后删除临时 JSON、打开报告并提供绝对路径。
只问用户要处理哪些报告 ID；待裁决项接受 DEC-01 = DEC-01-A 形式的回答。用户裁决前保持仓库内容不变。
Version History
- feafcb4 Current 2026-08-20 00:23
