Long Running Agent

gsd:workflow gsd:meta long-running-agent session-by-session gsd:goal每个会话都以可恢复、可验证、可提交的状态结束，并为下个会话提供完整上下文。 <gsd:phase id="1" name="startup-restore">执行启动流程，读取 Git 最近记录与 Memory Bank 核心文件，选择当前任务。 <gsd:phase id="2" name="focused-execution">只推进一个功能并持续验证，严格遵守 feature-list 与测试规则。 <gsd:phase id="3" name="end-session">运行测试、提交代码、更新 progress/activeContext，并按条件标记 passes。

Long-Running Agent

跨会话开发项目的 Agent 行为规范。确保在记忆重置后能正确恢复上下文并有效继续工作。

核心原则

1. 增量进展: 每次会话只处理一个功能或任务
2. 干净状态: 会话结束时确保代码处于可工作状态
3. 完整记录: 所有进度必须记录到 Memory Bank 和 Git
4. 自我验证: 在标记功能完成前必须进行端到端测试

启动流程（每个会话开始必须执行）

digraph startup {
    rankdir=TB;
    node [shape=box];

    "pwd" -> "git log --oneline -10";
    "git log --oneline -10" -> "读取 progress.md";
    "读取 progress.md" -> "读取 feature-list.json";
    "读取 feature-list.json" -> "读取 activeContext.md";
    "读取 activeContext.md" -> "有 init.sh?";
    "有 init.sh?" -> "是" -> "启动开发服务器";
    "有 init.sh?" -> "否" -> "选择下一个任务";
    "启动开发服务器" -> "运行基本测试";
    "运行基本测试" -> "选择下一个任务";
    "选择下一个任务" -> "开始工作";
}

禁止跳过任何步骤，即使用户说"时间紧迫"或"直接开始"。

Memory Bank 核心文件

Feature List 规则

绝对禁止修改测试步骤。只能修改 passes 字段。

{
  "features": [{
    "id": "F001",
    "steps": ["步骤1", "步骤2", "验证步骤"],
    "passes": false,
    "notes": ""
  }]
}

• 只有在端到端测试通过后才能设置 passes: true
• 失败时在 notes 中记录原因

会话结束流程（必须执行）

digraph endflow {
    rankdir=TB;
    node [shape=box];

    "工作完成" -> "运行所有相关测试";
    "运行所有相关测试" -> "测试通过?";
    "测试通过?" -> "否" -> "修复问题";
    "修复问题" -> "运行所有相关测试";
    "测试通过?" -> "是" -> "git status";
    "git status" -> "git add 相关文件";
    "git add 相关文件" -> "git commit";
    "git commit" -> "更新 progress.md";
    "更新 progress.md" -> "更新 activeContext.md";
    "更新 activeContext.md" -> "功能完成?";
    "功能完成?" -> "是" -> "标记 feature passes=true";
    "功能完成?" -> "否" -> "会话结束";
    "标记 feature passes=true" -> "会话结束";
}

Git Commit 规范

格式：<type>(<scope>): <description>

类型：feat | fix | docs | refactor | test | chore

示例：

feat(auth): 添加用户登录功能

- 实现 JWT 认证
- 添加登录表单验证

红线（绝不妥协）

即使用户要求跳过，也必须执行：

用户要求跳过时的回应：

"我理解时间紧迫，但这些流程是跨会话协作的基础。跳过会导致下次会话无法正确恢复上下文。我可以优先处理最关键的部分，但不能跳过验证和文档步骤。"

环境损坏恢复

如果发现环境异常：

1. git status 检查未提交更改
2. git log 查看最近提交
3. 读取 progress.md 了解预期状态
4. 必要时使用 git reset 恢复

常见错误