memory

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

memory

Memory

Two responsibilities in one skill: log (structured markdown memory files) and session (named, parallel session tracking with start/resume/end lifecycle).

一个技能兼具两项职责：日志（结构化Markdown记忆文件）和会话（支持命名、并行会话跟踪，包含启动/恢复/结束生命周期）。

Git Root Detection

Git根目录检测

Before running any command, detect the git root:

bash

git rev-parse --show-toplevel

All paths (

memory:

config value, log files) are relative to git root.

运行任何命令前，先检测Git根目录：

bash

git rev-parse --show-toplevel

所有路径（

memory:

配置值、日志文件）均相对于Git根目录。

Commands

命令

Log Commands

日志命令

Command	Description
`log daily`	Write daily closeout log to `<memory>/daily/YYYY-MM-DD.md`
`log weekly`	Roll up weekly memory from daily files
`log monthly`	Roll up monthly memory from daily files
`log git`	Write git summary to `<memory>/git/YYYY-MM-DD-GIT-N.md`

命令	描述
`log daily`	将每日收尾日志写入 `<memory>/daily/YYYY-MM-DD.md`
`log weekly`	从每日文件汇总每周工作记录
`log monthly`	从每日文件汇总每月工作记录
`log git`	将Git摘要写入 `<memory>/git/YYYY-MM-DD-GIT-N.md`

Session Commands

会话命令

Command	Description
`session start [name]`	Start a new named session
`session resume [name]`	Resume an existing active session
`session end [name]`	End a session and capture work done
`session spec <topic>`	Create an outcome spec
`session doc <topic>`	Create documentation
`session review`	Review current work

命令	描述
`session start [name]`	启动新的命名会话
`session resume [name]`	恢复已有的活跃会话
`session end [name]`	结束会话并记录完成的工作
`session spec <topic>`	创建成果规格文档
`session doc <topic>`	创建说明文档
`session review`	回顾当前工作

Other

其他命令

Command	Description
`install`	Install configured sessions backend

命令	描述
`install`	安装已配置的会话后端

$ARGUMENTS Routing

$ARGUMENTS 路由

$ARGUMENTS	Action
`help`	→ `commands/help.md`
`doctor`	→ `commands/doctor.md`
`log daily`	→ `commands/log/daily.md`
`log weekly`	→ `commands/log/weekly.md`
`log monthly`	→ `commands/log/monthly.md`
`log git`	→ `commands/log/git.md`
`session start`	→ `commands/session/start.md`
`session resume`	→ `commands/session/resume.md`
`session end`	→ `commands/session/end.md`
`session spec`	→ `commands/session/spec.md`
`session doc`	→ `commands/session/doc.md`
`session review`	→ `commands/session/review.md`
`install`	→ `commands/install.md`
(empty)	→ `commands/help.md`

$ARGUMENTS	操作
`help`	→ `commands/help.md`
`doctor`	→ `commands/doctor.md`
`log daily`	→ `commands/log/daily.md`
`log weekly`	→ `commands/log/weekly.md`
`log monthly`	→ `commands/log/monthly.md`
`log git`	→ `commands/log/git.md`
`session start`	→ `commands/session/start.md`
`session resume`	→ `commands/session/resume.md`
`session end`	→ `commands/session/end.md`
`session spec`	→ `commands/session/spec.md`
`session doc`	→ `commands/session/doc.md`
`session review`	→ `commands/session/review.md`
`install`	→ `commands/install.md`
(空)	→ `commands/help.md`

Bootstrap

初始化流程

.groove/index.md

does not exist, create from

skills/groove/templates/index.md

before proceeding.

If the

memory:

path does not exist, create the full directory structure:

bash

mkdir -p <memory>/daily <memory>/weekly <memory>/monthly <memory>/git

若

.groove/index.md

不存在，需先从

skills/groove/templates/index.md

创建该文件，再继续后续操作。

若

memory:

路径不存在，创建完整的目录结构：

bash

mkdir -p <memory>/daily <memory>/weekly <memory>/monthly <memory>/git

File Structure

文件结构

<memory>/              # default: .groove/memory/
├── daily/
│   └── YYYY-MM-DD.md
├── weekly/
│   └── YYYY-Www.md
├── monthly/
│   └── YYYY-MM.md
└── git/
    └── YYYY-MM-DD-GIT-N.md

skills/memory/
├── SKILL.md
├── commands/
│   ├── log/
│   │   ├── daily.md
│   │   ├── weekly.md
│   │   ├── monthly.md
│   │   └── git.md
│   ├── session/
│   │   ├── start.md
│   │   ├── resume.md
│   │   ├── end.md
│   │   ├── spec.md
│   │   ├── doc.md
│   │   └── review.md
│   └── install.md
└── templates/
    └── log/
        ├── daily.md
        ├── weekly.md
        ├── monthly.md
        └── git.md

<memory>/              # 默认路径: .groove/memory/
├── daily/
│   └── YYYY-MM-DD.md
├── weekly/
│   └── YYYY-Www.md
├── monthly/
│   └── YYYY-MM.md
└── git/
    └── YYYY-MM-DD-GIT-N.md

skills/memory/
├── SKILL.md
├── commands/
│   ├── log/
│   │   ├── daily.md
│   │   ├── weekly.md
│   │   ├── monthly.md
│   │   └── git.md
│   ├── session/
│   │   ├── start.md
│   │   ├── resume.md
│   │   ├── end.md
│   │   ├── spec.md
│   │   ├── doc.md
│   │   └── review.md
│   └── install.md
└── templates/
    └── log/
        ├── daily.md
        ├── weekly.md
        ├── monthly.md
        └── git.md