Menu
Bugfix 路径的结构化问题流程: report → analyze → fix-note 三件套档案, 落在 sprints/{slug}/. 把"偏轻"的 Bugfix 升级成可复现 / 可追溯 / 可复盘. 借 CodeStable issue 实体, 适配 agent-in-loop.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | athena-issue |
| description | Bugfix 路径的结构化问题流程: report → analyze → fix-note 三件套档案, 落在 sprints/{slug}/. 把"偏轻"的 Bugfix 升级成可复现 / 可追溯 / 可复盘. 借 CodeStable issue 实体, 适配 agent-in-loop. |
| effort | medium |
原 Bugfix 路径 plan → impl → review → ship 偏轻: 无 design.md、无根因记录、修完即忘。
同一个坑反复踩, 因为没有可检索的 report / analysis / fix-note。delivery-gate 当前完全不拦 Bugfix (无 design 跳过所有门禁), ship 零问责。
本 skill 给 Bugfix 配三件套档案 (借 CodeStable issue 流程), 落在 sprints/{slug}/, 并补一道最小 ship 门禁。
| 阶段 | 产出 (sprints/{slug}/) | 干什么 |
|---|---|---|
| report | issue-report.md | 把脑子里的问题落成可复现: 现象 / 复现步骤 / 期望 vs 实际 / 环境 |
| analyze | issue-analysis.md (根因不显然才写) | 定位根因 / 评估修复风险 / 给方案。agent 自己查代码定位, 不猜 |
| fix-note | fix-note.md | 修复记录: 改了什么 / 为什么 / 验证命令 + 输出。delivery-gate 验它 |
Bugfix: report → (analyze) → impl(fix) → review → ship
Bugfix + stage=ship → 检查 sprints/{slug}/fix-note.md 存在。缺 → block。
这是 Bugfix 路径第一道 ship 门禁 —— 原本 Bugfix 完全不拦, 现在至少要求"修了什么、怎么验证的"落盘。
Bugfix 默认跳过 runtime-verify (改动小, 单测够)。但若 bug 涉及接口 / 状态 / 并发, 在 fix-note 里附实跑验证, 借 runtime-verify 的"晒命令 + 输出"纪律 —— 只写"修好了"无效, 写"改前 curl.. → 500, 改后 → 200"才算数。
issue-report.md (复现步骤是硬要求, 复现不了先复现)issue-analysis.md (查代码定位, 列候选根因 + 证据)fix-note.md: 改动 + 根因 + 验证命令&输出/compound add learning 沉淀Athena 全局首次配置 (跨项目, 一次性). 从分发包部署 settings/config/rules/standards/hooks/agents/skills 到 ~/.claude/ (CC) 与 ~/.codex/ (CX). 和 athena-init 区别: setup 全局一次性, init 每项目一次. 已装则转 verify/upgrade (走 athena-migrate).
会话记忆固化 skill (v9.8.0 新). 会话结束/中途, agent 自己总结本会话增量写进 .ai_state (_index.md 当前状态 + sprints/{slug}/session-log.md), 免去用户每次手动描述一堆让它存. 手动 /checkpoint 触发. 与 compact-snapshot hook 互补 (hook 机械兜底, skill 做需推理的总结).
Athena 主入口 skill. 接收用户任务, 做 PACE 路由分诊 (brainstorm/roadmap/plan/...), 启动对应 stage. v9.7.0: 铁律引用名称化 (CC/CX 编号非对称, 引用一律用 铁律[名称]).
Athena 项目初始化 skill. 在项目中执行 /athena-init 时调用. 职责: 探测平台 / 工具可用性, 创建 .ai_state/ 目录 + 复制 _index.md 模板 + 填入探测结果.
Athena 版本迁移工具. v9.6.4 重写: 含 v9.6.2 → v9.6.4 破坏式重构 (sprints/ + compound/ + 4 新 ai_state 文件 + lessons.md 三选项交互).
维护 .ai_state/requirements/ 长效需求档 (软件要素: 为什么要这个能力). 原始用户故事 + 当时权衡, 独立于会演化的 design.md —— 代码烂掉时弃码重生的逃生通道. 借 CodeStable requirements 实体, 适配 agent-in-loop: 需求落盘可召回, 隐知识不丢.