用途:为要构建的功能产出完整“成果规格”(outcome spec),说明构建什么以及如何验证,具体流程由智能体决定。若提供 $ARGUMENTS,则作为规格主题使用。
主要能力:规格文件包含四部分——概览(构建什么、为什么)、决策(关键技术选择及理由)、实现步骤(有序的具体步骤)、边界情况(错误处理与边界条件)。
使用方式:先将主题清洗为合法文件名(去掉路径分隔符、特殊字符与 ../ 遍历模式);规格目录固定为 .groove/memory/specs/,不存在时创建;先用 Explore 智能体调研代码库;就决策、边界情况、测试方式和范围询问用户;评估范围,若存在自然接缝(独立组件、顺序阶段、可分离关注点),建议拆分为父规格加子规格——父规格含整体功能概览、指向子规格的链接及顺序执行顺序,子规格各自包含概览、决策、步骤、边界情况,用户确认或否决该建议;在隔离上下文中(使用通用智能体)写入规格,完成前校验所有必需章节齐全,并引用真实代码库模式而非泛泛建议。
命名规则:单一规格为 <topic>.md;拆分规格为 <topic>/index.md 加 <topic>/01-<part>.md。
质量信号:决策引用真实代码模式,步骤包含实际文件路径与函数名,边界情况反映已发现的约束。
限制:资料未提供该技能的安装方式、依赖版本、收费或平台支持信息。