产品与设计
为 groove 项目生成新贡献者 GROOVE.md…
在基于 groove 的项目中,为新加入的贡献者生成项目根目录的 GROOVE.md 入门指南,并按需在已有 CONTRIBUTING.md 中追加 groove 使用说明。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15
适用场景
为 groove 项目生成新贡献者 GR特定
解决思路
- 从 `.groove/index.md` 读取 `tasks.backend`、`memory.review_days`、`git.*`;`memory` 路径始终为 `.groove/memory/`,`specs` 路径始终为 `.groove/memory/specs/`。
- 询问用户:「是否有任何项目特定上下文要包含?(例如要领取哪些任务、团队约定)— 按回车跳过」。
- 按以下模板写入 `GROOVE.md`,替换所有实时配置值: ```markdown # Groove Workflow This project uses [groove](https://github.com/andreadellacorte/groove) — an AI-assisted engineering workflow companion. ## Quick start ```bash npx skills add andreadellacorte/groove /groove-admin-install ``` Then start every session with: ``` /groove-utilities-prime ``` ## Daily workflow ``` /groove-daily-start — review yesterday, load tasks, set agenda /groove-daily-end — write memory, commit logs ``` ## Compound loop (for any feature or fix) ``` /groove-work-brainstorm — clarify scope /groove-work-plan — research and plan /groove-work-exec — implement /groove-work-review — evaluate output /groove-work-compound — capture lessons ``` ## Config | Key | Value | |---|---| | Task backend | `<tasks.backend>` | | Memory path | `.groove/memory/` | | Specs path | `.groove/memory/specs/` | | Git strategy (memory) | `<git.memory>` | ## Conventions - Stage tasks are named `YYYY-MM-DD, <Stage>` — no numbers - Task completion requires a "Summary of Changes" in the task body before marking done - Archive is always user-triggered — never automatic ## Where things live - **Config**: `.groove/index.md` - **Daily logs**: `.groove/memory/daily/` - **Learned insights**: `.groove/memory/learned/` - **Specs**: `.groove/memory/specs/` - **Hooks**: `.groove/hooks/` (start.md, end.md) <custom-context> </custom-context> ```
- 如果 `CONTRIBUTING.md` 存在且尚未包含 `<!-- groove:onboard -->`,则追加以下小节: ```markdown <!-- groove:onboard --> ## Using groove This project uses [groove](https://github.com/andreadellacorte/groove) for AI-assisted engineering workflow. See [GROOVE.md](./GROOVE.md) for setup and commands. <!-- groove:onboard:end --> ```
- 报告:`GROOVE.md` 已写入,以及 `CONTRIBUTING.md` 是否已更新。
- 写入前必须读取 `.groove/index.md` 并替换所有占位符值。
- 如果 `GROOVE.md` 已存在,在改动前询问:「`GROOVE.md` 已存在——覆盖、更新还是跳过?」。
- 将 `<custom-context>` 块替换为用户提供的上下文;如果没有提供,则移除该块。
- 如果 `CONTRIBUTING.md` 不存在,不要创建它;只追加到已有文件。
- `GROOVE.md` 应足够短,能在 2 分钟内读完。
- 验收:项目根目录存在 `GROOVE.md`,且其中已替换为项目特定配置值。
- 验收:如果 `CONTRIBUTING.md` 存在,它包含一个 `## Using groove` 小节并链接到 `GROOVE.md`。
- 验收:内容反映实际配置值(任务后端、git 策略)。
适用边界 · 注意事项
- 不适用于未使用 groove 的项目,因为需要 `.groove/index.md`、groove 命令和配置。
- 当 `CONTRIBUTING.md` 不存在时,不要为了本技能而创建它。
- 当 `GROOVE.md` 已存在且用户未选择覆盖/更新时,不要改动它。