用途:/retrospect 回答“一次已通过验收的交付教给了项目什么”。它是可选步骤,不审查提案变更、不下发变更请求、不给出证明结论、不修订契约、不授权实施,也不阻塞发布或合并;一次诚实但没有有用发现的评估也是完整结果。
主要能力:检索规范版本化契约及其精确文本、精确候选(完整 commit SHA 或可复现快照)、以及带逐条需求证据的可检索完整 PROVEN 证明,并在依赖其结论前确认证明与契约匹配。读取匹配的已保存评审,先核对其候选与契约身份;身份不匹配要指出并搁置其结论。检查候选、契约、证明、适用标准及实际使用或维护经验,并把实现、修复、评审、证明报告中的 Learning candidates 只当作有归属的线索,独立落到已证实的交付上。为每条观察分配 ID 和可检索来源,说明观察到的影响、后果、不确定性与证据局限,区分直接经验与预测。将观察分类为可选改进或对具名承诺/约束的可能违反;对可能违反要引用义务与证据,建议对精确候选重新运行 /review-implementation 与 /prove 或走普通 issue 跟进,不修复候选、不修改旧报告或其历史 PROVEN 结论。只提出至少由一条具体观察支持的精确、带不确定性的建议。
使用方式:用 python3 <skill-dir>/scripts/p2p_filesystem.py --repo <root> resolve .p2p/work/<slug>/contract.md 解析路径,用 save .p2p/work/<slug>/contract.md <report-name> --from <file> 保存报告并保留历史。评估自动保存到 .p2p/work/<slug>/retrospective.md。建议初始状态为 pending,写前展示确切的处置变更;开发者可明确接受、拒绝或改写后接受,采纳前需确认措辞未超出所引观察的范围与证据限制。确认授权后再写入,写入后重读。被拒建议保留在评估报告中,不进入登记表。使用一个项目本地建议登记表;首个被授权采纳的学习可在 docs/retrospective-learnings.md 创建。
适用场景:交付通过验收后希望沉淀经验、整理证据支撑的改进建议。
限制:验收合同交互、证据形式与报告存储规则以资料所述为准;登记表内学习仅为建议性,不能自动约束;升级为项目规则或契约变更需另行人工授权;登记表条目不自动过期。资料未提供具体性能、收费或价格信息。