diff --git a/4 - Resources/Claude-Code/ECC 编排替代方案 (orchestrate 迁移).md b/4 - Resources/Claude-Code/ECC 编排替代方案 (orchestrate 迁移).md index 7b5e3b0..f2e3ff4 100644 --- a/4 - Resources/Claude-Code/ECC 编排替代方案 (orchestrate 迁移).md +++ b/4 - Resources/Claude-Code/ECC 编排替代方案 (orchestrate 迁移).md @@ -1,7 +1,8 @@ --- created: "2026-04-06" +updated: "2026-04-14" type: resource -tags: [resource, claude-code, AI-tools, orchestrate, migration, feature-dev, GSD, ECC, windows-compatible] +tags: [resource, claude-code, AI-tools, orchestrate, migration, feature-dev, GSD, PRP, devfleet, ECC, windows-compatible] source: "https://github.com/affaan-m/everything-claude-code" --- @@ -9,6 +10,8 @@ source: "https://github.com/affaan-m/everything-claude-code" `/ecc:orchestrate` 已标记为 legacy shim。底层委托给 `dmux-workflows`(需 tmux)和 `autonomous-agent-harness`(部分依赖 tmux)。Windows 上基本不可用。本文档记录迁移路径。 +> **先看决策表**:见文末「一张表选编排方式」。 + 相关笔记:[[Autonomous Agent Harness 自主代理框架]]、[[Everything Claude Code 完整指南]] ## orchestrate 做了什么 @@ -63,7 +66,102 @@ source: "https://github.com/affaan-m/everything-claude-code" | 安全相关 | 任何组合 + `/ecc:security-review` | | 最终验证 | `/ecc:verify` | -### 路线 C:全项目多阶段 — GSD +### 路线 C:PRP 工作流(PRD → 实施 → 提交 → PR) + +**适合结构化 PRD/migration-plan 等带 Implementation Phases 的文档。** 一条龙自动走完: + +``` +/prp-plan # 解析 PRD 找到下一个 pending phase,产出完整实施计划 +/prp-implement <上一步生成的 plan 路径> # 按计划严格实施 + 验证循环 +/prp-commit # 分析变更,起草 conventional commit +/prp-pr # 汇总提交生成 PR +``` + +特点: +- `/prp-plan` 自动检测输入:PRD 文件 → 选下一个 pending phase;自由描述 → 直接规划 +- 黄金原则:把实施时可能要搜的所有模式/惯例**提前抓进 plan**,实施阶段不再回去搜 +- Windows 原生可用 + +### 路线 D:多模型协同 — `/multi-workflow` + +**Claude 编排 + Codex 后端 + Gemini 前端 的 6 阶段流水线。** 适合全栈功能。 + +``` +/multi-workflow "add real-time notifications when market resolves" +``` + +6 阶段:Research → Ideation → Plan → Execute → Optimize → Review。每阶段通过 `~/.claude/bin/codeagent-wrapper` 并行调用 Codex/Gemini(`run_in_background: true`),用 `TaskOutput` 等结果。外部模型**无文件写权限**,所有修改由 Claude 落盘。 + +变体:`/multi-plan`(只规划)、`/multi-backend`、`/multi-frontend`、`/multi-execute`。 + +### 路线 E:DAG 式并行多 agent — `claude-devfleet` + +**用独立 git worktree 跑多个 Claude Code agent,按 DAG 依赖自动调度,Windows 原生可用。** 需本地启 DevFleet 服务并通过 MCP 接入: + +```bash +claude mcp add devfleet --transport http http://localhost:18801/mcp +``` + +核心调用(通过 MCP tool): + +``` +plan_project(prompt="Build a REST API with auth and tests") + → 返回 project_id + 一系列 missions(含 depends_on 链、auto_dispatch=true) +dispatch_mission(mission_id=) + → 根 mission 启动,后续 mission 在依赖满足时自动派发 +get_mission_status / get_dashboard / get_report + → 监控与汇报 +``` + +特点: +- 每个 mission 在独立 worktree 中运行,完成后自动 merge +- 默认最多 3 个并发 agent(`DEVFLEET_MAX_AGENTS` 可配) +- 合并冲突时留在 worker 分支手动处理 +- 长任务建议用 `get_mission_status` 轮询(30-60 秒间隔),避免用 `wait_for_mission` 阻塞会话 + +### 路线 F:会话内并行 — Agent 工具 + worktree 隔离 + +**当前会话里直接 spawn 多个子代理,`isolation: "worktree"` 参数自动建临时 worktree,Windows 原生可用。** 不需要 tmux、不需要外部服务。 + +主代理调用示例(Claude 自身能用): + +``` +并行 3 个子 agent: +- subagent_type: general-purpose, isolation: worktree, prompt: "迁移 module X" +- subagent_type: general-purpose, isolation: worktree, prompt: "迁移 module Y" +- subagent_type: csharp-reviewer, prompt: "审查 module X/Y 结果" +``` + +适合:互相独立的迁移任务、并行审查、互不冲突的多模块改造。不适合:跨模块强耦合、需要相互看到中间状态的任务。 + +### 路线 G:外部 tmux + worktree 脚本 — `scripts/orchestrate-worktrees.js` + +**ECC 自带的长周期/跨 harness 编排助手。需要 tmux(Linux/macOS/WSL)。** + +```bash +node scripts/orchestrate-worktrees.js plan.json --execute +``` + +`plan.json` 结构: + +```json +{ + "sessionName": "skill-audit", + "baseRef": "HEAD", + "seedPaths": ["scripts/helper.js", ".claude/plan/spec.md"], + "launcherCommand": "codex exec --cwd {worktree_path} --task-file {task_file}", + "workers": [ + {"name": "docs-a", "task": "Fix skills 1-4."}, + {"name": "docs-b", "task": "Fix skills 5-8."} + ] +} +``` + +自动完成:每 worker 一个分支+worktree、覆盖 `seedPaths` 中的本地脏文件、写 `.orchestration//` 下的 task/handoff/status 文件、启动 tmux 会话挂 panes。 + +状态快照:`node scripts/orchestration-status.js `。 + +### 路线 H:全项目多阶段 — GSD GSD(Get Shit Done)是 ECC 集成的项目级编排系统,Windows 原生可用。 @@ -105,12 +203,14 @@ npx get-shit-done-cc@latest | 旧命令 | 新命令 | 说明 | | ---------------------------------- | --------------------------------------------- | ------------------------ | -| `/ecc:orchestrate feature "desc"` | `/ecc:feature-dev "desc"` | 单功能全流程 | +| `/ecc:orchestrate feature "desc"` | `/ecc:feature-dev "desc"` 或 `/prp-plan`+`/prp-implement` | 单功能全流程 | | `/ecc:orchestrate bugfix "desc"` | `/ecc:tdd` + `/ecc:code-review` | 先写失败测试再修 | | `/ecc:orchestrate refactor "desc"` | `/ecc:plan` + `/ecc:tdd` + `/ecc:code-review` | 先规划再重构 | | `/ecc:orchestrate security "desc"` | 任何路线 + `/ecc:security-review` | 加安全审查 | | 多阶段自动执行 | `/gsd:autonomous` | GSD 接管 | -| 并行编排 | 不可用(Windows) | 用 Agent/Task tool 做进程内并行 | +| 并行编排(tmux) | `claude-devfleet` MCP 或 Agent+worktree | Windows 原生替代 | +| PRD → 实施 | `/prp-plan ` → `/prp-implement` | 自动解析 phases | +| 多模型协同 | `/multi-workflow` | Codex+Gemini+Claude | ## CLAUDE.md 更新 @@ -138,13 +238,35 @@ npx get-shit-done-cc@latest |------|---------|------| | `/ecc:feature-dev` | 可用 | Claude Code 内部,不依赖外部工具 | | `/ecc:plan` + `/ecc:tdd` + ... | 可用 | 同上 | +| `/prp-plan` / `/prp-implement` / `/prp-commit` / `/prp-pr` | 可用 | 全部 Claude Code 内部 | +| `/multi-workflow` (含 Codex/Gemini) | 可用 | 需装 codeagent-wrapper,不依赖 tmux | | `/gsd:autonomous` | 可用 | 用 Claude Code Task tool 做并行 | +| Agent 工具 + `isolation: "worktree"` | 可用 | 原生 git worktree,不依赖 tmux | +| `claude-devfleet` (MCP) | 可用 | HTTP MCP 接入,worker 在独立 worktree | | `/ecc:orchestrate` | **不可用** | Legacy,底层依赖 tmux | -| `dmux-workflows` | **不可用** | 需要 tmux | +| `dmux-workflows` | **不可用** | 需要 tmux(除非 WSL) | +| `scripts/orchestrate-worktrees.js` | **WSL 可用** | 建 tmux session 挂 panes | | `auto-pilot.sh` 脚本 | 可用 | Git Bash,每阶段独立 `claude -p` | --- +## 一张表选编排方式 + +| 我要... | 选 | 入口 | +|---------|-----|------| +| 规划单个功能,确认后再写 | `/plan` | 命令 | +| 单功能全流程(含 TDD+审查) | `/ecc:feature-dev` | 命令 | +| 已有 PRD/migration-plan 带 phases | `/prp-plan ` → `/prp-implement` | 命令 | +| 前后端都动(Codex/Gemini 辅助) | `/multi-workflow` | 命令 | +| 会话内并行几个独立任务 | Agent 工具 + `isolation: worktree` | 主代理直接 spawn | +| DAG 调度多 worker 自动合并 | `claude-devfleet` | MCP | +| 整个项目/多 milestone 生命周期 | `/gsd:new-project` → `/gsd:autonomous` | 命令 | +| 无人值守长时间跑 | `autonomous-agent-harness` + crons | MCP scheduled-tasks | +| 定时重复同一个任务 | `/loop-start ` | 命令 | +| 跨 harness 长周期编排(Linux/WSL) | `scripts/orchestrate-worktrees.js` | 脚本 | + +--- + ## 什么时候需要外部脚本 大部分情况下 Claude Code 自己编排(`/ecc:feature-dev` 或 GSD)就够了。外部脚本(`auto-pilot.sh`)只在以下场景有价值: diff --git a/4 - Resources/Claude-Code/Everything Claude Code 完整指南.md b/4 - Resources/Claude-Code/Everything Claude Code 完整指南.md index 523e938..d3fe547 100644 --- a/4 - Resources/Claude-Code/Everything Claude Code 完整指南.md +++ b/4 - Resources/Claude-Code/Everything Claude Code 完整指南.md @@ -1,5 +1,6 @@ --- created: "2026-03-08 21:30" +updated: "2026-04-14" type: resource tags: [resource, claude-code, AI-tools, development-workflow, reference] source: "https://github.com/affaan-m/everything-claude-code" @@ -7,24 +8,35 @@ source: "https://github.com/affaan-m/everything-claude-code" # Everything Claude Code 完整指南 -生产级 Claude Code 插件系统。v1.10.0 (2026-04-06 更新),包含 215 skills、112 agents、82 commands、hooks 和 rules (608 files total)。方法论与最佳实践见 [[Everything Claude Code 方法论与最佳实践]],按场景速查见 [[Everything Claude Code 用法速查]]。 +生产级 Claude Code 插件系统。v1.10.0(本地仓库实测 183 skills / 48 agents / 79 commands;marketplace 版可能更多——以本地 `ls` 结果为准)。方法论与最佳实践见 [[Everything Claude Code 方法论与最佳实践]],按场景速查见 [[Everything Claude Code 用法速查]]。 + +> **仓库关键参考文档**(实测路径 `C:\Users\yaoji\git\OpenSource\everything-claude-code\`): +> - `docs/COMMAND-AGENT-MAP.md` — 命令↔agent↔skill 的官方对照表 +> - `COMMANDS-QUICK-REF.md` — 59 命令速查(按作者口径) +> - `the-longform-guide.md` / `the-shortform-guide.md` — 官方长/短指南 +> - `skills/dmux-workflows/SKILL.md`、`skills/autonomous-agent-harness/SKILL.md`、`skills/claude-devfleet/SKILL.md` — 三类编排机制 +> - `scripts/orchestrate-worktrees.js` — 外部 tmux+worktree 编排脚本 自主循环和并行编排详见:[[Autonomous Loops 自主循环模式]]、[[dmux 多Agent并行编排]]、[[Ralphinho RFC-DAG 编排模式]]、[[Autonomous Agent Harness 自主代理框架]]、[[ECC 编排替代方案 (orchestrate 迁移)]] ## 项目架构 ``` -everything-claude-code/ (v1.10.0, 608 files) -├── agents/ (112个) - 专用子代理 (.agents/ + agents/) -├── skills/ (215个) - 工作流定义和领域知识 -├── commands/ (82个) - slash 命令 -├── hooks/ - 基于事件的自动化 -├── rules/ - 始终遵循的规则(15种语言 + common) -├── scripts/ (93个) - 跨平台 Node.js 工具脚本 +everything-claude-code/ (v1.10.0) +├── agents/ (~48) - 专用子代理(code-reviewer、planner、tdd-guide、...) +├── skills/ (~183) - 工作流定义和领域知识 +├── commands/ (~79) - slash 命令 +├── hooks/ - 基于事件的自动化(hooks.json + scripts/hooks/*) +├── rules/ - 始终遵循的规则(python/typescript/golang/... + common + zh) +├── scripts/ - 跨平台 Node.js 工具脚本(orchestrate-worktrees、harness-audit、...) ├── mcp-configs/- MCP 服务器配置模板 -└── contexts/ - 动态注入的上下文文件 +├── contexts/ - 动态注入的上下文文件 +├── docs/ - COMMAND-AGENT-MAP、SKILL-PLACEMENT-POLICY 等 +└── plugins/ - 独立子插件(gsd、obsidian、planning-with-files、...) ``` +> 数字随版本浮动,以 `ls commands/*.md | wc -l` 等实测为准。 + ## 安装 ```bash @@ -85,7 +97,21 @@ Rules 新增:java, kotlin, dart, csharp, cpp, rust, perl, php, web, zh (中文 --- -## 全部 65 Skills +## 精选 Skills(curated subset,非全量) + +> 实际 skills 总数 ~183(v1.10.0)。以下只列最常用的按领域分组。完整清单:`ls skills/` 或看 `docs/COMMAND-AGENT-MAP.md`。 + +### 编排三件套(本文档重点) + +| Skill | 用途 | Windows 可用 | +|-------|------|--------------| +| `dmux-workflows` | tmux pane 多 agent 并行 | ❌(需 WSL) | +| `autonomous-agent-harness` | 自主循环 / 定时 / 持久记忆 | ✅ | +| `claude-devfleet` | DAG 式多 worker + 独立 worktree + 自动 merge | ✅(需本地 DevFleet MCP) | + +其它相关:`autonomous-loops`、`continuous-agent-loop`、`ralphinho-rfc-pipeline`、`council`、`gan-style-harness`。 + + ### 核心基础设施 (9) @@ -229,7 +255,11 @@ Rules 新增:java, kotlin, dart, csharp, cpp, rust, perl, php, web, zh (中文 --- -## 16 Agents +## 精选 Agents(非全量) + +> 实际 agents 总数 ~48。以下是最常被命令调用或主代理手动 spawn 的核心子代理。完整清单:`ls agents/` 或看 `docs/COMMAND-AGENT-MAP.md`。 + + | Agent | 职责 | | ---------------------- | ----------------- | @@ -255,16 +285,22 @@ Rules 新增:java, kotlin, dart, csharp, cpp, rust, perl, php, web, zh (中文 ## 常用 Commands ### 开发核心 -`/plan` `/tdd` `/e2e` `/code-review` `/build-fix` `/verify` `/test-coverage` `/refactor-clean` +`/plan` `/tdd` `/e2e` `/code-review` `/build-fix` `/verify` `/test-coverage` `/refactor-clean` `/feature-dev` + +### PRP 工作流(PRD→实施→PR 一条龙) +`/prp-prd` `/prp-plan` `/prp-implement` `/prp-commit` `/prp-pr` ### 多 Agent 编排 -`/multi-plan` `/multi-execute` `/multi-frontend` `/multi-backend` `/orchestrate` +`/multi-plan` `/multi-workflow` `/multi-execute` `/multi-frontend` `/multi-backend` `/devfleet` `/orchestrate`(legacy shim) + +### GSD 项目生命周期(独立子插件) +`/gsd:new-project` `/gsd:plan-phase` `/gsd:execute-phase` `/gsd:verify-work` `/gsd:next` `/gsd:autonomous` `/gsd:ship` `/gsd:complete-milestone` ### 学习演化 -`/learn` `/learn-eval` `/evolve` `/instinct-status` `/instinct-export` `/instinct-import` +`/learn` `/learn-eval` `/evolve` `/instinct-status` `/instinct-export` `/instinct-import` `/skill-create` `/skill-health` `/rules-distill` -### v1.8.0 新增 -`/loop-start` `/loop-status` `/model-route` `/quality-gate` `/harness-audit` `/promote` +### 循环/自动化 +`/loop-start` `/loop-status` `/model-route` `/quality-gate` `/harness-audit` `/promote` `/claw` --- @@ -303,9 +339,12 @@ ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck" ### Resources - [[Everything Claude Code 方法论与最佳实践]] - [[Everything Claude Code 用法速查]] +- [[ECC 编排替代方案 (orchestrate 迁移)]] ← **编排机制全景表** - [[Autonomous Loops 自主循环模式]] +- [[Autonomous Agent Harness 自主代理框架]] - [[dmux 多Agent并行编排]] - [[Ralphinho RFC-DAG 编排模式]] +- [[GSD 方法论与最佳实践]] ### Zettelkasten - [[Everything Claude Code 最佳实践]] diff --git a/6 - Zettelkasten/20260414230719 Agent 工具 worktree 隔离是 Windows 原生并行的关键.md b/6 - Zettelkasten/20260414230719 Agent 工具 worktree 隔离是 Windows 原生并行的关键.md new file mode 100644 index 0000000..8144282 --- /dev/null +++ b/6 - Zettelkasten/20260414230719 Agent 工具 worktree 隔离是 Windows 原生并行的关键.md @@ -0,0 +1,53 @@ +--- +created: "2026-04-14 23:07" +type: zettel +tags: [zettel, claude-code, ECC, orchestration, parallel, windows, worktree] +source: "Claude Code Agent tool 参数: isolation" +--- + +# Agent 工具 worktree 隔离是 Windows 原生并行的关键 + +ECC 的 `dmux-workflows`、`scripts/orchestrate-worktrees.js` 都依赖 tmux,Windows 原生环境跑不了。绕过这个限制最干净的方案不是切 WSL,是用 Claude Code 内置 `Agent` 工具的 `isolation: "worktree"` 参数。 + +## 机制 + +`Agent` 工具在 spawn 子代理时接受 `isolation: "worktree"`——平台会自动为该子代理建一个临时 git worktree,子代理在隔离分支上做修改,无改动时自动清理,有改动则把 path 和 branch 返还给主代理,由主代理决定合并还是丢弃。 + +这和 `claude-devfleet` 的 worktree 策略本质一致,只是调度层从 HTTP MCP 变成主代理自己。 + +## 为什么重要 + +1. **零外部依赖** — 不需要 tmux、不需要额外服务,Claude Code 开箱即用 +2. **天然隔离** — git worktree 保证多个子代理改同一个仓库也不会互相踩脚 +3. **失败可丢弃** — 改坏了直接扔掉 worktree,主会话干净无污染 +4. **和现有 agent 生态复用** — 任何 `subagent_type`(general-purpose、csharp-reviewer、security-reviewer……)都能套 worktree + +## 适用边界 + +- ✅ 互相独立的迁移任务、并行审查、多模块改造 +- ✅ 想在 Windows 上复刻 dmux 「多 pane 并行」效果 +- ❌ 跨模块强耦合、子代理需要实时看到彼此中间状态 +- ❌ 需要长时间运行、跨会话存活(用 `claude-devfleet` 或 `autonomous-agent-harness` crons) + +## 和其他编排方式的关系 + +| 需求 | 用这个 | +|------|--------| +| 几个独立子任务,当前会话内搞定 | **Agent + isolation: worktree**(本 zettel) | +| DAG 依赖、跨会话、自动 merge | `claude-devfleet`(MCP) | +| Linux/WSL 上可视化多 pane | `dmux-workflows` | +| 定时 / 长周期无人值守 | `autonomous-agent-harness` + crons | + +--- + +## Related + +- [[ECC 编排替代方案 (orchestrate 迁移)]] +- [[dmux 多Agent并行编排]] +- [[Autonomous Agent Harness 自主代理框架]] +- [[Everything Claude Code Agent 编排模式]] + +## Source + +- Claude Code `Agent` tool 原生参数 `isolation` +- ECC `skills/claude-devfleet/SKILL.md` 的 worktree 隔离策略(同源思路)