Add：基于状态机的智能体驱动开发工作流系统

Add 是一套个人可插拔的智能体技能集合，专为管理软件开发生命周期而设计。其核心创新在于采用状态机模型组织工作流，每个状态转换对应全新会话，解决长期智能体会话的上下文漂移问题。工作状态保存在 MASTER.md 跟踪器和结构化故事文件中，而非对话历史，支持 Claude Code 和 Codex 双平台。

Add 系统针对的核心问题是长期智能体会话中的上下文漂移：当上下文窗口填满时，模型易产生幻觉文件路径、丢失早期指令，且单个错误决策因无干净状态重置而级联放大。

Add 定义了清晰的状态生命周期，每个故事从规划到完成需经历完整流程：从 /epic-plan 创建史诗生成 MASTER.md，到 /epic-story-plan 规划待办故事，再通过 /epic-story-claim 认领并以 TDD 方式实现，可通过 /epic-story-resume 恢复中断工作，最后用 /epic-story-review 审查实现。设计原则为每个命令只做一件事、每个会话只执行一个命令，且评审与编码会话分离以避免偏见。

Add 将 TDD 提升为规划阶段约束：/epic-story-plan 要求提供验证证明矩阵，映射验收标准到测试接缝，确保编码前测试策略明确。会话交接机制通过写入“会话交接”部分记录变更、剩余工作和下一步；知识沉淀通过 /memorize 反思摩擦点并建议文档补丁，/epic-squash 合并完成规范到 CONTRACT.md，防止重复学习。

Add 支持 Claude Code 和 Codex 双平台，提供两种安装路径：Claude Code 插件市场安装，或自定义 shell 脚本安装（支持用户级/项目级作用域，通过符号链接实现，更新只需 git pull，脚本幂等性避免非符号链接覆盖）。

Add 包含10个核心工作流命令（如 /epic-plan 创建史诗、/epic-story-claim 认领故事、/epic-story-review 审查实现等）和2个工具命令：/grillme 用于计划/设计的持续提问达成共识，/memorize 反思会话摩擦并建议文档改进。所有命令共享状态生命周期和协调文件约定。

Add 适合复杂长期项目或多开发者协作场景，通过外化状态解决智能体会话限制。对个人开发者：结构化工作方式保持专注，减少上下文切换成本；对团队：标准化协作语言与流程，降低沟通开销。更展示新协作范式：分解为多个短专注会话，利用 AI 能力同时规避局限性。

Add 项目核心洞察为：真正的状态应保存在文件系统而非对话历史。基于此构建的状态机工作流不仅解决上下文漂移问题，更提供与 AI 协作的新思维方式。对其他开发者，Add 提供参考实现，其会话交接与知识沉淀流程可适配到其他工作流和工具链。