athena-requirements

name	athena-requirements
description	维护 .ai_state/requirements/ 长效需求档。需要记录某能力的原始动机与权衡时触发。

/athena-requirements — 需求逃生通道 (v9.8.0 新)

为什么存在 (痛点)

Athena 原本 brainstorm → design → impl, 没有独立的"原始需求 + 当时权衡"长效档. design.md 随实现演化, 半年后回看已认不出"最初到底要解决什么、为什么这么取舍". 本 skill 把需求作为软件要素独立存档 (借 CodeStable), WHY 与 HOW 分离。

档案	答什么	演化性
requirements/{slug}.md (本)	为什么要这能力 + 当时权衡	长效, 只在需求本身变时改
architecture/{type}-{slug}.md	现在长什么样	长效, 随实现刷新
sprints/{slug}/design.md	这次怎么做	一次性, 随 sprint 丢
compound/decision-*.md	为什么这样选 (技术)	永久

逃生通道 (CodeStable 核心价值): 代码烂成一坨时, requirements/ 是弃码重生的依据 —— 留着需求和权衡, 让 agent 重新生成实现, 而不是对着烂代码缝缝补补.

触发

时机	强制度
Feature / System 路径 (新能力) plan 前 (brainstorm 收敛后)	建议 先落 requirement
用户显式 /athena-requirements {slug}	触发
需求变更 (范围 / 验收标准变了)	强制 更新对应 requirements/{slug}.md
roadmap 拆分大需求	每条子 feature 一条 requirement
Bugfix / Quick / Hotfix	跳过 (无新需求, 是修既有)

产出: .ai_state/requirements/{slug}.md

---
slug: jwt-refresh
status: active            # active | superseded | dropped
created: 2026-06-22