Agent Skills › boshu2/agentops › postmortem

postmortem

GitHub

用于对已完成或中断的目标进行回溯性因果分析。明确区分事实与假设,验证必要性与可避免的返工,生成基于证据的结论而非代码验收判定。

images/gemini/skills/postmortem/SKILL.md boshu2/agentops

Trigger Scenarios

用户明确要求对已停止或完成的任务进行事后复盘 需要分析特定时间段内的结果、意图及可用判断证据

Install

npx skills add boshu2/agentops --skill postmortem -g -y
More Options

Non-standard path

npx skills add https://github.com/boshu2/agentops/tree/main/images/gemini/skills/postmortem -g -y

Use without installing

npx skills use boshu2/agentops@postmortem

指定 Agent (Claude Code)

npx skills add boshu2/agentops --skill postmortem -a claude-code -g -y

安装 repo 全部 skill

npx skills add boshu2/agentops --all -g -y

预览 repo 内 skill

npx skills add boshu2/agentops --list

SKILL.md

Frontmatter
{
    "name": "postmortem",
    "context": {
        "intent": {
            "mode": "task"
        },
        "window": "fork",
        "sections": {
            "exclude": [
                "HISTORY"
            ]
        }
    },
    "consumes": [],
    "metadata": {
        "tier": "judgment",
        "effects": [
            "write_postmortem_report"
        ],
        "disposition": "keep_strategy",
        "capabilities": [
            "postmortem"
        ],
        "dependencies": [],
        "canonical_status": "canonical"
    },
    "produces": [
        "postmortem-report.md"
    ],
    "practices": [
        "sre",
        "lean-startup"
    ],
    "context_rel": [],
    "description": "Analyze outcomes or an interim cutoff. Use when: a postmortem is explicitly requested; consumes available judgment, never gates code acceptance or requires a lesson.",
    "hexagonal_role": "domain",
    "user-invocable": true,
    "output_contract": "concise inline causal analysis; a requested durable report is YYYY-MM-DD-postmortem-<topic>.md in caller-selected protected external non-Git storage",
    "skill_api_version": 1,
    "disable-model-invocation": true
}

Postmortem

Answer an explicit retrospective causal question about a completed or stopped goal, session or change using its actual intent, outcome and judgment evidence. For an explicitly requested interim analysis, pin the cutoff and pending checks; its conclusions describe that interval and do not establish a final outcome.

Prompt

Postmortem this stopped change using its accepted intent, native session,
check results and reviewer messages. Which correction cycles were avoidable,
and which checks were necessary? No verdict file was saved. Answer inline.

Critical Constraints

  • Postmortem is retrospective causal analysis, not the general learning umbrella or a code-acceptance gate: acceptance proof and causal inference are different judgments. A request for code and a postmortem does not make the postmortem an input to code judgment. Wait for a known outcome unless interim analysis was requested; keep the caller's overall request incomplete until its requested analysis exists.
  • Existing verdicts and native judgments remain unchanged. It does not re-run acceptance validation or fabricate missing proof to enable a retrospective. An existing verdict.v2 is optional evidence; its absence does not exclude a stopped or unvalidated subject.
  • Because the caller owns subsequent action, do not rewrite proof, operate tracker state, change the remaining plan, reopen work or promote a rule.
  • Empty or inconclusive analysis is valid; recommend no change when warranted. Manufacture neither certainty nor a lesson.

Workflow

  1. Pin the explicit question, accepted intent, subject identity, actual outcome and available judgment. Cite native work/session references, commits, checks and reviewer messages as applicable; cite an existing verdict by exact id. Keep missing evidence explicit before drawing conclusions.
  2. Reconstruct only the relevant evidence-backed timeline. Keep delivered behavior, failed/stopped work and process output distinct; hidden author reasoning is not fact. Missing judgment is not a PASS or a FAIL.
  3. Separate delivered facts from causal hypotheses. Test contributing conditions against cited evidence, at least one plausible alternative and a counterfactual. Distinguish necessary validation and compatibility work from avoidable rework; repeated review alone proves no waste.
  4. For time/token claims, state source, interval, units, included/excluded actors and uncertainty. Separate elapsed time, overlapping work and accounting scopes; never equate totals with waste, savings or money without supporting evidence.
  5. Optionally seek independent support or challenge for contested causal claims within caller authority. Return supported/rejected claims, unknowns and at most three supported changes with limits or small suggested experiments. Stop; suggestions do not authorize implementation.

Correlation-to-cause discrimination

Treat causal statements as hypotheses until the mechanism is demonstrated. Promoting a claim from correlation to cause requires all three:

  • a stated mechanism — the specific path by which the condition produced the outcome, in terms a reader could check against the subject;
  • discriminating evidence — an observation that the mechanism predicts and at least one plausible alternative does not;
  • a counterfactual test — what should have differed if the claim were false, with the cited evidence showing it did differ.

Post-hoc fix attribution — "we changed X and the failure stopped, therefore X was the cause" — satisfies none of these alone. The symptom may be intermittent, or recovery and the change may share an unobserved cause. Keep such claims as correlations with untested alternatives and a suggested discriminating experiment. Every supported causal claim needs all three elements with citations; anything less stays a correlation or unknown.

Output Specification

  • Default to concise inline Markdown: question, pinned inputs, relevant timeline, hypotheses/evidence/counterfactuals, unknowns and bounded suggestions. No mandatory report or worksheet.
  • Only when requested, save YYYY-MM-DD-postmortem-<topic>.md in caller-selected protected external non-Git storage. Missing routing does not authorize a repository fallback; preserve existing requested evidence under owner policy.
  • bash skills/postmortem/scripts/validate.sh checks package structure and contract markers. It does not inspect report truth, causal support or acceptance.
  • The caller owns bookkeeping, planning and delivery. Optional Memory owns any separately authorized curation, support and destination-disclosure review; retrospective evidence cannot promote itself.

Quality Checklist

  • The causal question and actual inputs are pinned; gaps are explicit.
  • Supported and rejected claims cite discriminating evidence.
  • Alternatives, counterfactuals, and unknowns remain visible.
  • The report stops short of proof, planning, tracker, and delivery authority.

Behavior examples are in postmortem.feature.

Version History

  • 9f8a711 Current 2026-09-22 11:00

    澄清了回溯分析的时间点与协调开销,明确代码接受与回溯分析的消费者分离;强化了上下文传递与所有权指引。

  • 8061085 2026-09-09 05:17

    新增 Prompt 示例、It's working if 验收标准及详细 Workflow 章节,强化因果推断的可观测性与规范性。

  • d9f9c50 2026-08-27 19:42
  • 7b07a7d 2026-08-19 22:00

    更新输出契约为真实Markdown报告路径;效应从空改为写入报告;制品目录迁移至标准scratch路径。

  • 3f402e5 2026-07-24 22:07

Same Skill Collection

images/gemini/skills/account-rotation/SKILL.md
images/gemini/skills/agent-mail/SKILL.md
images/gemini/skills/agent-native/SKILL.md
images/gemini/skills/agy-native/SKILL.md
images/gemini/skills/anti-ceremony/SKILL.md
images/gemini/skills/automation-shape-routing/SKILL.md
images/gemini/skills/bootstrap/SKILL.md
images/gemini/skills/cass/SKILL.md
images/gemini/skills/cc-hooks/SKILL.md
images/gemini/skills/codebase-recon/SKILL.md
images/gemini/skills/codex-exec/SKILL.md
images/gemini/skills/converter/SKILL.md
images/gemini/skills/council/SKILL.md
images/gemini/skills/craft-goal/SKILL.md
images/gemini/skills/crank/SKILL.md
images/gemini/skills/dcg/SKILL.md
images/gemini/skills/doc/SKILL.md
images/gemini/skills/domain/SKILL.md
images/gemini/skills/fitness/SKILL.md
images/gemini/skills/goals/SKILL.md
images/gemini/skills/handoff/SKILL.md
images/gemini/skills/human-only-skills/SKILL.md
images/gemini/skills/idea-genie/SKILL.md
images/gemini/skills/implement/SKILL.md
images/gemini/skills/learn/SKILL.md
images/gemini/skills/memory/SKILL.md
images/gemini/skills/ms/SKILL.md
images/gemini/skills/ntm/SKILL.md
images/gemini/skills/one-way-door/SKILL.md
images/gemini/skills/operationalize/SKILL.md
images/gemini/skills/pattern-mining/SKILL.md
images/gemini/skills/plan/SKILL.md
images/gemini/skills/premortem/SKILL.md
images/gemini/skills/product/SKILL.md
images/gemini/skills/rch/SKILL.md
images/gemini/skills/reality-check/SKILL.md
images/gemini/skills/refactor/SKILL.md
images/gemini/skills/research/SKILL.md
images/gemini/skills/reverse-engineer/SKILL.md
images/gemini/skills/route/SKILL.md
images/gemini/skills/rpi/SKILL.md
images/gemini/skills/sbh/SKILL.md
images/gemini/skills/scaffold/SKILL.md
images/gemini/skills/scope/SKILL.md
images/gemini/skills/security/SKILL.md
images/gemini/skills/shared/SKILL.md
images/gemini/skills/skill-builder/SKILL.md
images/gemini/skills/skill-eval/SKILL.md
images/gemini/skills/standards/SKILL.md

Metadata

Files
0
Version
9f8a711
Hash
a9a6e157
Indexed
2026-07-24 22:07

Home - Wiki
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-09-26 12:08
浙ICP备14020137号-1