Back to Details

groove-admin-config

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
<!-- groove:managed — do not edit; changes will be overwritten by groove update -->
<!-- groove:managed — do not edit; changes will be overwritten by groove update -->

groove-admin-config

groove-admin-config

Outcome

执行结果

.groove/index.md
is created or updated with values confirmed by the user. The git strategy is applied immediately. User is ready to run 
/groove-admin-install
.
.groove/index.md
将使用用户确认的配置值创建或更新。Git策略会立即生效，用户后续可执行 
/groove-admin-install
命令。

Acceptance Criteria

验收标准

  • .groove/index.md
    exists with all config keys populated
  • Each key was either confirmed by the user or accepted as default
  • Git strategy is applied (
    .groove/.gitignore
    written) before exiting
  • User is shown a summary of the final config and told to run 
    /groove-admin-install
  • .groove/index.md
    已存在，且所有配置键均已填充
  • 每个配置键要么经用户确认，要么使用默认值
  • 退出前已应用Git策略（已写入
    .groove/.gitignore
    文件）
  • 向用户展示最终配置的摘要，并提示用户运行 
    /groove-admin-install

Steps

执行步骤

Walk the user through each config key in order. For each key: show the current value (or default if new), explain what it does, and ask to confirm or change.
按顺序引导用户完成每个配置键的设置。针对每个配置项：展示当前值（新配置则展示默认值），说明其作用，询问用户是否确认或修改。

Keys and defaults

配置项与默认值

KeyDefaultOptionsQuestion to ask
tasks
beans
beans | linear | github | none
"Which task backend? beans tracks tasks as markdown files in your repo."
memory
.groove/memory/
any path"Where should groove store memory logs? (default: .groove/memory/)"
git.memory
ignore-all
ignore-all | hybrid | commit-all
"Git strategy for memory logs? ignore-all keeps them local, hybrid commits logs but ignores sessions, commit-all commits everything."
git.tasks
ignore-all
ignore-all | commit-all
"Git strategy for task files (.groove/tasks/)? ignore-all keeps them local, commit-all tracks them in git."
git.hooks
commit-all
ignore-all | commit-all
"Git strategy for hooks (.groove/hooks/)? commit-all shares hooks with the team, ignore-all keeps them local."
After all keys are confirmed:
  1. Write 
    .groove/index.md
    with confirmed values and 
    groove-version: <installed version>
  2. Apply git strategy — write 
    .groove/.gitignore
    (see constraints)
  3. Show summary of written config
  4. Tell user: "Run 
    /groove-admin-install
    to install backends."
KeyDefaultOptionsQuestion to ask
tasks
beans
beans | linear | github | none
"使用哪款任务管理后端？beans会将任务作为markdown文件存储在你的代码仓库中。"
memory
.groove/memory/
任意路径"groove应该将内存日志存储在什么位置？(默认值：.groove/memory/)"
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将钩子保留在本地。"
所有配置项确认完成后：
  1. 使用确认后的配置值写入
    .groove/index.md
    ，同时添加
    groove-version: <已安装版本号>
  2. 应用Git策略 — 写入
    .groove/.gitignore
    文件（见约束条件）
  3. 展示已写入的配置摘要
  4. 提示用户："运行 
    /groove-admin-install
    以安装后端。"

Constraints

约束条件

  • If 
    .groove/index.md
    already exists, pre-fill each question with the current value
  • If run non-interactively (arguments provided), apply them without prompting: e.g. 
    groove-admin-config tasks=linear git.memory=hybrid
  • Always write 
    groove-version:
    matching the installed version from 
    skills/groove/SKILL.md
  • 如果
    .groove/index.md
    已存在，每个询问项将预先填充当前值
  • 如果以非交互方式运行（已提供参数），则无需提示直接应用参数：例如 
    groove-admin-config tasks=linear git.memory=hybrid
  • 始终写入与
    skills/groove/SKILL.md
    中已安装版本匹配的
    groove-version:
    值

Git strategy → 
.groove/.gitignore

Git策略对应
.groove/.gitignore
规则

After writing 
.groove/index.md
, generate 
.groove/.gitignore
from the 
git.*
sub-keys:
ComponentStrategyEntry added to 
.groove/.gitignore
git.memory
ignore-all
memory/
git.memory
hybrid
memory/sessions/
git.memory
commit-all
(none)
git.tasks
ignore-all
tasks/
git.tasks
commit-all
(none)
git.hooks
ignore-all
hooks/
git.hooks
commit-all
(none)
Write the generated entries to 
.groove/.gitignore
, replacing the file entirely. If no entries are generated (all 
commit-all
), write an empty file with a comment: 
# groove git strategy: commit-all
.
Always append these lines at the end of 
.groove/.gitignore
, regardless of strategy:
undefined
写入
.groove/index.md
后，根据
git.*
子配置项生成
.groove/.gitignore
文件：
ComponentStrategyEntry added to 
.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
末尾追加以下行：
undefined

cache — always local

cache — always local

.cache/* !.cache/.gitkeep

- If `.groove/` is listed in the root `.gitignore`, warn the user: "Note: `.groove/` is in your root .gitignore — any commit-all strategies require removing it."
- Do not modify the root `.gitignore` automatically — flag it for the user to resolve
.cache/* !.cache/.gitkeep

- 如果根目录`.gitignore`中已列出`.groove/`，警告用户："注意：`.groove/`已加入根目录.gitignore中 — 若要使用任意commit-all策略，需要将其从.gitignore中移除。"
- 不要自动修改根目录`.gitignore` — 标记该问题由用户自行解决