groove-admin-config

groove-admin-config

结果

创建或更新 .groove/index.md，其中的值均已由用户确认。立即应用 Git 策略。用户可以运行 /groove-admin-install。

验收标准

• .groove/index.md 存在，且所有配置键均已填写
• 每个键的值均已由用户确认或接受默认值
• 退出前已应用 Git 策略（写入 .groove/.gitignore）
• 向用户展示最终配置摘要，并告知运行 /groove-admin-install

步骤

如果传入 --defaults：跳过所有提示，应用所有默认值，并直接开始写入配置（“所有键均已确认”中的第 1 步）。告知用户正在应用的默认值。

否则，按顺序引导用户逐一配置每个键。对于每个键：显示当前值（如果是新配置，则显示默认值），说明其作用，并询问用户是否确认或修改。

键与默认值

键	默认值	选项	要询问的问题
tasks.storage	beans	beans | linear | github | none	“选择哪个任务后端？beans 会将任务作为 Markdown 文件保存在你的仓库中。”
tasks.list_limit	15	正整数	“task-list 最多显示多少个任务？（默认值：15）”
tasks.analyse_limit	30	正整数	“task-analyse 最多显示多少个任务？（默认值：30）”
memory.review_days	5	正整数	“每天开始时回顾最近多少个工作日？（默认值：5）”
git.memory	ignore-all	ignore-all | hybrid | commit-all	“记忆日志的 Git 策略是什么？ignore-all 会将它们保留在本地；hybrid 会提交日志，但忽略会话；commit-all 会提交所有内容。”
git.tasks	ignore-all	ignore-all | commit-all	“任务文件（.groove/tasks/）的 Git 策略是什么？ignore-all 会将它们保留在本地；commit-all 会在 Git 中跟踪它们。”
git.hooks	commit-all	ignore-all | commit-all	“钩子（.groove/hooks/）的 Git 策略是什么？commit-all 会与团队共享钩子；ignore-all 会将它们保留在本地。”
groovebook	andreadellacorte/groovebook	<owner>/<repo> 或留空	“用于分享经验的 Groovebook 仓库是什么？默认值：andreadellacorte/groovebook。留空以禁用。”

所有键均已确认后：

1. 将已确认的值和 groove-version: <installed version> 写入 .groove/index.md
2. 应用 Git 策略——写入 .groove/.gitignore（参见约束）
3. 显示已写入配置的摘要
4. 告知用户：“运行 /groove-admin-install 以安装后端。”

约束

• 如果 .groove/index.md 已存在，则在每个问题中预填当前值
• 始终写入 groovebook:（默认值为 andreadellacorte/groovebook；留空表示禁用）。记忆路径（.groove/memory/）和规格路径（.groove/memory/specs/）是硬编码的——不要询问这些路径。
• 如果传入 --defaults，则无需任何提示即可应用所有默认值——供 groove-admin-install 用于实现零摩擦的首次设置
• 如果提供了其他参数（例如 tasks=linear git.memory=hybrid），则无需提示即可应用这些参数，并为任何未指定的键使用默认值
• 始终写入 groove-version:，其值须与 skills/groove/SKILL.md 中的已安装版本一致

Git 策略 → .groove/.gitignore

写入 .groove/index.md 后，根据 git.* 子键生成 .groove/.gitignore：

组件	策略	添加到 .groove/.gitignore 的条目
git.memory	ignore-all	memory/
git.memory	hybrid	memory/sessions/
git.memory	commit-all	(无)
git.tasks	ignore-all	tasks/
git.tasks	commit-all	(无)
git.hooks	ignore-all	hooks/
git.hooks	commit-all	(无)

将生成的条目写入 .groove/.gitignore，并完全替换该文件。如果没有生成任何条目（全部为 commit-all），则写入一个带注释的空文件：# groove git strategy: commit-all。

无论策略如何，始终在 .groove/.gitignore 末尾追加以下行：

# cache — always local
.cache/*
!.cache/.gitkeep

• 如果根目录的 .gitignore 中列出了 .groove/，请提醒用户：“注意：.groove/ 已列入根目录的 .gitignore——任何 commit-all 策略都需要将其移除。”
• 不要自动修改根目录的 .gitignore——请标记出来，由用户处理