用途:在 GHE 工作流中管理需求(requirements/specs)文档。需求以版本化 Markdown 文件存放在 REQUIREMENTS/ 目录,作为功能实现的唯一事实来源;每个 DEV 线程在开始工作前必须链接一个需求文件。
主要能力:按 epic/wave 或 standalone 组织目录,使用 REQUIREMENTS/templates/REQ-TEMPLATE.md 模板;每个 REQ 文件包含 frontmatter(req_id、version、status、created、updated、epic、wave、linked_issues)与概述、用户故事、验收标准、技术需求(功能/非功能)、原子变更、测试需求、依赖、修订历史等章节。支持语义化版本 MAJOR.MINOR.PATCH:PATCH 为笔误澄清,MINOR 为新增标准或原子变更,MAJOR 为验收标准的破坏性变更。要求报告同时发布到 GitHub Issue 线程和 GHE_REPORTS/(扁平结构),文件名格式为 <TIMESTAMP><title>_(<AGENT>).md。支持自动备份需求到 SERENA(.serena/memories/requirements)。
使用方式:从模板复制生成 REQ 文件并填入内容;创建后把 status 由 draft 改为 approved,用 git 提交(如 git commit -m "REQ-${NEXT_REQ} v1.0.0: ${FEATURE_NAME} - approved");创建 DEV issue 时正文加入需求链接与版本;需求变更后更新所有关联 issue 的评论;可用命令校验 issue 是否已链接需求、需求文件是否存在、链接版本与当前版本是否一致。
适用场景:GitHub Elements 多智能体协作下的需求版本化、关联与变更同步。
限制:资料强调“用户规格神圣”,不得未经讨论修改用户规格;后台代理仅可写入项目目录及子目录、父目录(子 git 项目)、~/.claude 与 /tmp。需求文件仅在用户明确因空间原因要求删除时才可删除。具体安装与平台信息暂未提供。