用途:从现有代码库中逆向提取规格说明,适合理解遗留或无文档系统、为已有代码补文档、上手新代码库、规划既有功能增强,以及从实现中提取需求。
主要能力:以两种视角工作——Arch Hat 关注系统架构与数据流,QA Hat 关注可观察行为与边界情况。核心流程为:Scope 确定分析边界(整体系统或特定功能);Explore 用 Glob、Grep、Read 映射结构;Trace 跟踪数据流与请求路径;Document 以 EARS 格式记录观察到的需求;Flag 标记需澄清之处。探索前设验证检查点,确认文件覆盖足够再继续。
用法:先加载 references/analysis-process.md 开始探索、使用 Glob/Grep 模式;写需求时参考 references/ears-format.md;生成最终规格文档时用 references/specification-template.md;用 references/analysis-checklist.md 确保分析完整。EARS 格式提供四种模式:Ubiquitous(The <system> shall <action>.)、Event-driven(When <trigger>, the <system> shall <action>.)、State-driven(While <state>, the <system> shall <action>.)、Optional(Where <feature> is supported, the <system> shall <action>.)。最终规格保存为 specs/{project_name}_reverse_spec.md,包含技术栈与架构、模块/目录结构、EARS 格式的观察性需求、非功能观察、推断的验收标准、不确定性与问题、建议。该技能由 @jeffallan 维护。
限制:所有观察必须基于实际代码证据,不得无证据假设;不得跳过安全模式分析,不得忽略错误处理模式,不得在未充分探索时生成规格;需区分观察事实与推断,不确定性单列章节,每条观察需附代码位置。关于授权许可、收费与价格、平台支持等信息暂未提供。