Self-hosted workflows for coding-agent delivery. Orchestrate CodeBuddy, Codex and Claude Code with scripts and human approval gates. Includes Local workflows for coding assistants.
JavaScript agent-orchestrationagentic-workflowai-agentsai-codingclaude-codecode-reviewcodebuddycodexcoding-agentscursordeveloper-toolshuman-on-the-loopllmmcpmulti-agentsdlcself-hostedsopworkflow-automationworkflow-engine
CodeBuddy 适配器
仅在 task、team_create、send_message、team_delete、use_skill 均可调用时使用;CodeBuddy 必须使用 Team 拓扑,Shell/Python 不能替代 Agent 生命周期工具。
- 如托管 Agent 或命令缺失,运行
python3 <SKILL_ROOT>/adapters/codebuddy/install.py --project-root . --refresh-managed。安装器不删除项目自有文件,但会报告architect.md、leader.md等旧版 DevFlow 冲突;它们不得用于当前/devflow。 - medium/large 使用
--execution-mode isolated --host-adapter codebuddy初始化。状态机会生成带run_id的team_name。创建前只对.codebuddy/teams/<team_name>做一次存在性判断;同名存在就立即调用team_delete(team_name=<team_name>),失败则运行python3 <SKILL_ROOT>/adapters/codebuddy/cleanup_team.py --project-root . --team-name <team_name>删除这个精确目录,然后直接team_create。不得读取 Team 配置、成员、inbox 或状态,不得尝试恢复。 - REQUIREMENT 执行
prepare --emit-prompt → start,由主 Agent 调用devflow-clarify-requirements并填写需求报告,再校验和finish;此时状态必须为awaiting_approval=REQUIREMENT。主 Agent 展示报告摘要并等待用户明确确认,之后才执行approve --stage REQUIREMENT --user-confirmed。不得调用task创建需求分析 Agent,也不得在确认前创建 DESIGN member。 - route 中其他 Agent 阶段第一次执行时,用
prepare --emit-prompt一次完成准备和完整提示生成,再直接创建并启动唯一 Team member:Task(name="devflow-<stage>-<task_slug>", team_name=<team_name>, subagent_name="devflow-stage-executor", mode="bypassPermissions", prompt=<完整阶段提示>)。核心规则、阶段规则、专项规则、角色边界、输入输出和自检命令必须全部包含在这一次prompt中。严禁省略team_name,严禁使用“待命”占位 Prompt,严禁把完整提示交给无 Team 的普通tasksubagent,也不预建未进入阶段的 member。 Task返回真实 member ID 后立即用assign --executor-type devflow-stage-team-member --dispatch-tool task --team-name <team_name>登记并调用start;首次执行不得再用send_message重复派发阶段提示。member 通过send_message(recipient="main")交接,协调者校验并finish。只有当前主会话内的失败重试才复用当前 Team 的 member ID;显式 resume 一律按第 8 条创建新 Team,不得联系旧 member。- SUMMARY 与 REQUIREMENT 一样由主 Agent执行,不调用
task。 - 阶段成功完成后向当前 member 发送
shutdown_request。SUMMARY 完成后删除当前 Team;只处理状态或工具返回的精确 Team 名,不枚举其他 Team。 - CodeBuddy 的用户入口固定为
/devflow resume <slug>或/devflow 继续 <slug>,内部调用resume --project-root . --slug <slug> --fresh-team。返回rotate-team时,先对delete_team_name执行第 2 条的直接删除,再执行返回的rotate-team命令并创建新 Team;旧 in-progress 阶段会恢复为 pending。返回restart-required时,也只删除返回的delete_team_name,随后用一句话说明状态文件缺失、无法 resume,要求用户重新提交原始需求;禁止继续检查或重复调用 resume。
只读检索助手先生成有边界的完整提示,再把该提示直接作为 Task(..., team_name=<team_name>, subagent_name="devflow-research-helper", prompt=<完整检索提示>) 的初始 Prompt;不得先发“待命”再二次派发。随后通过 helper --executor-type devflow-research-team-member --dispatch-tool task --team-name <team_name> 登记。完成后它向 main 返回事实并接受关闭;不得创建无 team_name 的 helper subagent。
除第 2 条已定义的精确目录删除降级外,任一 Team 生命周期调用失败时停止并报告,不得静默降级成 subagent 或 single-context。通用 agents/ 保存逻辑角色,CodeBuddy 专有目录只保存两个宿主执行器和一个命令适配。