SuperAPI AI 工具集

init-workflow

通用与其它

查看项目

更新于 10-19 19:17

技能介绍

用途

init-workflow 用于在当前项目中初始化 Persistent Context Workflow(持久化上下文工作流),创建必要的文件和目录结构,使 AI Agent 在不同会话甚至不同 Agent CLI 之间保持上下文连续性。

何时使用

  • 新项目的第一次设置。
  • 在现有项目中添加工作流支持。
  • 用户明确说 "init-project"、"初始化工作流" 或 "setup context workflow"。

主要能力与执行步骤

  1. 检查现有结构:检查 AGENTS.md 是否存在,docs/progress.md 是否存在,docs/memory/ 目录是否存在,docs/postmortem/ 目录是否存在。

  2. 复制模板文件:从 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 中,无需访问用户根目录,可直接读取。

  3. 创建目录结构:

    project/
    ├── AGENTS.md              # [已创建]
    ├── docs/
    │   ├── progress.md        # [已创建]
    │   ├── memory/            # [已创建]
    │   │   └── README.md      # [已创建]
    │   └── postmortem/        # [已创建]
    │       └── README.md      # [已创建]
    
  4. 更新 AGENTS.md:如果项目已有 AGENTS.md,追加工作流部分,包括 Agent-Agnostic 工作流说明、三层记忆系统表格和工作流命令列表。

  5. 确认初始化完成:向用户报告哪些文件已创建、哪些文件已更新,以及下一步建议(运行 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 已创建。
  • 资料未提供收费、价格、平台支持范围等更多信息。