关于 groove-work-spec
groove-work-spec 是用于编写可执行项目规格的 skill。它引导 Agent 先研究代码库并询问用户，再整理决策、实施步骤和边界情况。
主要功能
- 01起草前研究代码库
- 02访谈用户以明确范围和决策
- 03规划父规格与子规格
- 04整理实施步骤和验证标准
适用场景
- 01为现有代码库规划功能
- 02将工作拆分为顺序或独立规格
- 03记录技术选择与边界情况
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/groove-work-spec确认已加载。
详细介绍
groove-work-spec
如果提供了 $ARGUMENTS，请将其用作规格主题。
目标
一份完整的成果规格，定义要构建什么以及如何验证——由 Agent 确定具体流程。
验收标准
规格文件包含：
- 概述：要构建什么以及原因
- 决策：关键技术选择及其理由
- 实施步骤：具体且有序的步骤
- 边界情况：错误处理和边界条件
约束
- 清理主题，使其可用作文件名——删除路径分隔符、特殊字符和路径遍历模式（
../） - 规格目录始终为
.groove/memory/specs/ - 确保规格目录存在（如果缺失则创建）
- 先研究代码库（使用 Explore Agent）
- 就决策、边界情况、测试方法和范围采访用户
- 评估范围：如果工作存在自然的切分点（独立组件、连续阶段、可分离的关注点），建议拆分为一份父规格和多份子规格
- 父规格：完整功能的概述、指向子规格的链接，以及顺序执行时的执行顺序
- 子规格：每份规格均自成一体，包含自己的概述、决策、步骤和边界情况
- 命名：单份规格使用
<topic>.md，拆分后的规格使用<topic>/index.md+<topic>/01-<part>.md - 由用户决定：说明拆分建议及其理由，由用户确认或提出其他方案
- 在隔离的上下文中编写规格（使用通用 Agent）
- 完成前确认所有必需章节均已存在
- 引用代码库中实际的模式，而非泛泛的建议
质量指标
- 决策引用实际的代码模式
- 步骤包含实际的文件路径和函数名称
- 边界情况反映已发现的约束
评论
支持 Markdown