用途
init-workflow 用于在当前项目中初始化 Persistent Context Workflow(持久化上下文工作流),创建必要的文件和目录结构,使 AI Agent 在不同会话甚至不同 Agent CLI 之间保持上下文连续性。
何时使用
- 新项目的第一次设置。
- 在现有项目中添加工作流支持。
- 用户明确说 "init-project"、"初始化工作流" 或 "setup context workflow"。
主要能力与执行步骤
-
检查现有结构:检查 AGENTS.md 是否存在,docs/progress.md 是否存在,docs/memory/ 目录是否存在,docs/postmortem/ 目录是否存在。
-
复制模板文件:从 Skill 内置模板目录复制文件:
- templates/AGENTS.md → 项目根目录 AGENTS.md
- templates/progress.md → docs/progress.md
- templates/memory-readme.md → docs/memory/README.md
- templates/postmortem-readme.md → docs/postmortem/README.md
模板文件内嵌在 Skill 中,无需访问用户根目录,可直接读取。
-
创建目录结构:
project/ ├── AGENTS.md # [已创建] ├── docs/ │ ├── progress.md # [已创建] │ ├── memory/ # [已创建] │ │ └── README.md # [已创建] │ └── postmortem/ # [已创建] │ └── README.md # [已创建] -
更新 AGENTS.md:如果项目已有 AGENTS.md,追加工作流部分,包括 Agent-Agnostic 工作流说明、三层记忆系统表格和工作流命令列表。
-
确认初始化完成:向用户报告哪些文件已创建、哪些文件已更新,以及下一步建议(运行 recap 或 checkpoint)。
工作流设计
该工作流设计用于在 Claude Code、Codex、OpenCode 等不同 AI Agent CLI 之间保持上下文连续性。三层记忆系统如下:
| 层级 | 位置 | 用途 | 更新频率 |
|---|---|---|---|
| 1. Auto Memory | Agent 自带 | 用户偏好、纠正过的行为 | 自动 |
| 2. 工作日志 | docs/memory/YYYY-MM-DD.md |
每日完成事项、决策 | 每次 checkpoint |
| 3. 状态快照 | docs/progress.md |
当前进行中的工作 | 每次 checkpoint |
工作流命令包括:recap(恢复上下文)、checkpoint(存档当前进度)、postmortem(事后复盘)、init-workflow(初始化工作流)。
注意事项与限制
- 如果文件已存在,询问用户是否覆盖。
- 保留用户已有的项目特定配置。
- 不要删除现有内容,只追加工作流相关部分。
- 成功标准:AGENTS.md 包含工作流说明;docs/progress.md 已创建;docs/memory/ 目录和 README 已创建;docs/postmortem/ 目录和 README 已创建。
- 资料未提供收费、价格、平台支持范围等更多信息。