메뉴
Bugfix 路径的结构化问题流程: report → analyze → fix-note 三件套档案, 落在 sprints/{slug}/. 把"偏轻"的 Bugfix 升级成可复现 / 可追溯 / 可复盘. 借 CodeStable issue 实体, 适配 agent-in-loop.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| 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: 需求落盘可召回, 隐知识不丢.