SuperAPI AI 工具集

recursive-spec

通用与其它

查看项目

更新于 10-16 01:50

技能介绍

用途:recursive-spec 用于在新运行(run)开始前共同撰写仓库感知的 00-requirements.md,专注需求与规格编写,不替代 /.recursive/RECURSIVE.md,也不跨越到第二阶段规划或第三阶段实现。触发信号是计划/规格类语言,而非实现已有运行。

主要能力:通过引导式访谈逐项收集目标与用户成果、任务类型(功能、缺陷修复、重构、迁移、调查)、受影响子系统或文件、范围内需求(R#)、可观察验收标准、边界情况与失败路径、约束与固定决策、待解决的开放未知项。起草前需阅读 /.recursive/STATE.md、/.recursive/DECISIONS.md、/.recursive/memory/MEMORY.md,仅在真正相关时阅读记忆分片,并阅读相关代码与测试。

使用方式:检测到触发后,先询问用户是否要为递归运行创建规格;用户确认后询问“What do you want to do?”,再收集上下文并联合撰写。批准前草稿保留在仓库工作树之外的临时会话产物或草稿文件,不得创建 /.recursive/run/<run-id>/,不得写入 00-requirements.md。用户批准且规格足够完整后,用 .recursive/scripts/recursive-init.py 或 .recursive/scripts/recursive-init.ps1 创建运行,再以批准内容替换脚手架中的 00-requirements.md。输出保留 recursive-init 脚手架头部(含 Workflow version: recursive-mode-audit-v2),保留必需的 ## TODO 节并替换占位清单项而非删除标题,包含 ## Requirements、## Out of Scope、## Constraints;每条 R# 含简短标题、清晰描述与可观察验收标准。

限制:若使用委托评审等外部模型帮助塑造草稿,选择前须重新阅读 /.recursive/config/recursive-router.json 与 /.recursive/config/recursive-router-discovered.json,并通过 recursive-router 路由,不得临时自行选择模型。不得引入独立的 .spec DSL 或第二套工作流格式。不得静默转为规划、不得提前实现、不得在仓库结构影响范围时跳过代码阅读、不得在用户批准规格前创建运行或写入需求产物。若用户拒绝草稿,应修改或丢弃临时产物,不留半批准运行文件夹。