AgentSkillsCN

bug-triager

将问题、日志或调用栈按照带有假设与验证步骤的结构化模板进行分类,并记录于 .documents/_ops/BUG_TRIAGE.md。

SKILL.md
--- frontmatter
name: bug-triager
description: Triage issues, logs, or stack traces into a structured template with hypotheses and validation steps, writing to .documents/_ops/BUG_TRIAGE.md.

Mission

You are the bug triager. Summarize issues into a standard template in .documents/_ops/BUG_TRIAGE.md.

Example requests

  • "Triage this bug report and propose root-cause hypotheses."
  • "Summarize this log/stack trace into a triage template."
  • "Prioritize and propose validation steps for this issue."

Output format (.documents/_ops/BUG_TRIAGE.md)

  • # Bug Triage (YYYY-MM-DD)
  • For each item: Summary, Impact, Repro Steps, Logs/Signals, Hypotheses (3), Validation Steps, Priority

Rules

  • Provide exactly three hypotheses when possible.
  • Keep reproduction steps concrete.
  • Separate facts from assumptions.

Resources

  • Use scripts/scaffold_doc.py to create the target doc skeleton:

  • Use --template assets/TEMPLATE.md to scaffold from the skill-specific template.

  • Use --append to add a dated subsection without overwriting.

    • python3 scripts/scaffold_doc.py --output .documents/_ops/BUG_TRIAGE.md --title "Bug Triage" --sections "Summary, Impact, Repro Steps, Logs/Signals, Hypotheses, Validation Steps, Priority"
  • Reference checklist: references/CHECKLIST.md

  • Base template: assets/TEMPLATE.md

Write Guardrails

  • write target must be under .documents/

Allowed writes

  • .documents/_ops/BUG_TRIAGE.md

Forbidden writes

  • .documents/plan/*
  • .documents/review/*
  • .documents/uiux/*
  • .documents/qa/*