Files
Agent-System/.doc/ops/templates/issue-record.md
T

1.9 KiB

issue_id, issue_state, severity, owner, task_ids, created, occurred_at, updated, recurrence_count, evidence_basis, lesson_ids
issue_id issue_state severity owner task_ids created occurred_at updated recurrence_count evidence_basis lesson_ids
ISSUE-YYYYMMDD-<slug> open medium <负责定位/跟进者>
<关联任务 ID>
YYYY-MM-DD <首次发现日期> YYYY-MM-DD 0 current

<问题标题>

按 闭环规范 维护。已有审计/任务承载这些内容时,在原主记录补字段/章节并索引,不复制正文。授权、worktree 与任务状态链接父任务。

事实与证据

预期/实际、触发条件、影响、版本/环境、首次发生与复现方法;证据日期、路径和脱敏范围。无法复现写缺口和下一步。

根因与同类范围

区分已证实、假设、已排除;共用机制、因果链、现有防护失效原因;同类入口、检查结果、未覆盖项及理由。

修复思路与过程

方案选项、选择理由、修复位置、临时止血局限及根治安排;链接既有方案。

日期 假设 / 尝试 / 动作 实际结果与证据 决策 / 下一步 / owner

失败/未知结果保留,不用后续成功覆盖。追加修复提交、合入和部署证据;多轮尝试分别记录。

验收与关闭

原例、同类变体、边界/异常、正常行为,逐项记录真实结果/未运行和证据。记录 resolved 日期和范围;临时止血或研究完成不当作修复完成。deferred 填风险/决策依据/owner/复查触发;duplicate 指向主 ID。

经验与复发

lesson 链接,或不新增经验的理由;测试/规范/门禁落实情况和待办 owner。复发保留前次关闭记录、递增次数,解释旧经验/防护为何未生效。