核心用法
longrunning-agent 是一套面向复杂项目的结构化工作流技能，专为需要跨多次会话持续迭代的AI代理设计。其核心机制围绕四个工作文件展开：
- CLAUDE.md：项目指令与工作流指南
- task.json：带优先级和依赖关系的任务清单
- progress.txt：工作完成的增量日志
- init.sh（可选）：环境初始化脚本
使用流程遵循八步闭环：读取进度 → 选择任务（筛选未完成的、依赖已满足的任务）→ 初始化环境 → 实现任务 → 测试验证 → 文档记录 → 标记完成 → 原子化提交。
显著优点
1. 会话连续性保障：通过标准化文件格式，彻底解决了AI代理"记忆断层"问题，任意会话均可无缝接续
2. 任务依赖管理：JSON格式的任务清单支持显式声明依赖关系，自动确保执行顺序合理性
3. 增量可追溯：progress.txt的时间戳日志形成完整的工作审计链，便于复盘与交接
4. Web UI集成：与Agent Workflow Web App深度集成，支持任务同步、进度捕获、会话日志和Git提交追踪
5. 原子化工作流：强制"单任务单会话"原则，配合自动提交，降低复杂项目的失控风险
潜在局限
- 人工维护成本：task.json和progress.txt需要人工或脚本维护，小型项目可能显得笨重
- 学习曲线：相比直接对话式开发，需要理解特定文件格式和工作流约定
- Claude Code CLI依赖：技能文档明确依赖Claude Code CLI环境，通用性受限
- 模板有限：仅提供基础模板，复杂场景需自行扩展
适合人群
- 需要数周/数月持续开发的复杂软件项目团队
- 多开发者轮换使用AI代理协助的场景
- 对项目可追溯性和审计有要求的组织
- 已采用Claude Code CLI作为主力工具的专业开发者
常规风险
1. 文件同步冲突：多会话并发时，task.json和progress.txt可能产生写冲突，需配合版本控制
2. 任务粒度失控：若任务拆解过细，管理开销可能抵消收益；过粗则失去增量意义
3. 依赖声明错误：手动维护的依赖关系可能出现循环依赖或遗漏，导致任务死锁
4. Claude Code CLI版本漂移：CLI更新可能破坏技能兼容性，需锁定版本或持续跟进适配