gugug168/cc-delegate

Dernière activité source enregistrée: 15 août 2026 à 07:07

Catalogue SkillsMP mis à jour: 9 novembre 2026 à 14:22

skills collectés: 1

Étoiles GitHub: 2
Forks GitHub: 0

Installer avec un assistant IA

Copiez ce prompt dans l’assistant IA que vous utilisez.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/gugug168/cc-delegate.

README du dépôt

Fichier source du README : README.md

Lire le README source

Afficher le README complet

<p align="center"> <img src="./assets/readme/hero.svg" width="100%" alt="cc-delegate：把长任务以可恢复的状态交给本机 Claude Code。"> </p> WorkBuddy Skill：经由 claude-code-mcp 调度本机 Claude Code，并用状态化恢复避免长任务在跨调用时丢失上下文。 ## 一眼看懂 | 价值 | 真实证据 | | --- | --- | | 把长任务以可恢复的状态交给本机 Claude Code。 | 任务边界 · --resume · 可审计回执 | ## 从这里开始 ```text Read SKILL.md and ARCHITECTURE.md ``` ## 完整说明 > 让 Codex 与 Claude Code 独立做双计划对照，也能把本机任务委派给 Claude Code，续干、监控并独立验收。当前版本：**v1.16.0**。 ## 它解决什么直接执行 `claude -p` 很容易遇到五类问题： - Codex 单模型规划时，容易遗漏另一条实现路径或验证维度； - 工作目录传错，产物落到意外位置； - 前台命令超时后重复派活； - 多步任务找不到该恢复哪个会话； - Claude Code 自报“测试通过”，但实际命令或产物并不一致。 `cc-delegate` 把这些风险收成一条协议： ```text Plan 模式: Codex Plan A + Claude 只读 Plan B -> 严格解析 -> 差异对照 -> 合并计划执行模式: 确定 workFolder -> 创建隔离 HANDOFF_DIR -> 生成 marker 并派活 -> transcript 监控 -> result.json + HANDOFF.md -> 命令对账 + 独立复验 ``` ## v1.16.0 变化 - 每次完整使用后按 marker 或 Plan B `state.json` 写一条优化复盘；重复收工不会重复计数。 - 同一未解决 fingerprint 在 3 个独立复盘中重复出现，才进入自动优化队列；三个无关建议不会误触发。 - 新增并发安全的 `claim/resolve` 租约，避免 Codex 与 WorkBuddy 同时修改 Skill。 - 活动锁按 PID+token 校验，不按固定时长误删；人工门需用户明确决定后才能留痕接管。 - 自动优化只改已配置的 cc-delegate Git 真相源，并强制完整测试、哈希校验后同步安装副本。 - 同步前备份变化文件，拒绝链接逃逸且不删除安装目录额外文件，WorkBuddy `sessions.json` 保持不动。 - 自动流程不会修改被委派项目，也不会自动 commit、push、发布或放宽安全边界。 ## v1.15.0 变化 - 四个可执行入口默认自动记录每次调用，启动先写 `RUNNING`，完成后原子更新状态。 - 记录统一落到 `~/.cc-delegate/run-history/`，不污染项目仓库，也不与安装副本绑定。 - 新增 `run_history.py list/show/stats/path`，可按状态、调用方、时间和 marker/state 关联查询。 - 记录耗时、退出码、Plan B 费用/格式告警及回执摘要；原始 prompt 和 transcript 正文不落盘。 - 硬中断保留 stale `RUNNING`，失败、超时和无记录不再被成功样本覆盖。 ## v1.14.0 基础 - Codex 进入 Plan 模式时默认触发 Claude Code 独立 Plan B；只有用户明确说不需要 CC 计划时才跳过。 - Plan A 与 Plan B 隔离生成，Claude 看不到 Codex 方案，减少相互迎合。 - Peer Plan 固定使用 `--permission-mode plan`，不授予编辑、提交、发布或外部操作权限。 - 新增 `assemble-plan` / `run-plan` / `plan-status` / `parse-plan`，对 Claude 外层回执和七段计划 schema 失败关闭。 - `run-plan` 只开放 `Read/Glob/Grep` 并隔离 MCP；前台超时不杀 Claude，stdout 仍会落盘供 `plan-status` 续查。 - 启动前读取 `claude --help`，缺少 Plan 权限、工具收口或输出参数时直接 `CC_PLAN_UNAVAILABLE`，不静默降级。 - Claude 偶尔在 JSON 前后加说明时，只提取唯一且字段精确匹配的计划并标记 `NON_JSON_WRAPPER`；多个候选或 schema 偏差仍拒绝。 - 对数组字段只允许一种无歧义兼容：单个字符串转为单元素数组，并标记 `NORMALIZED_SINGLETON_ARRAYS`；不补字段、不删字段、不改对象结构。 - 统一输出“共识、Claude 补漏、Codex 补漏、分歧、合并计划”，避免只做表面投票。 ## v1.13.0 基础 - Codex、WorkBuddy 共用同一套 CLI 主流程，不再假设固定工具分工。 - 主 `SKILL.md` 从 864 行压到约 300 行，平台配置按需加载。 - 新增 `preflight`，一次检查工作目录、交接目录和 Claude CLI。 - 代码修改和耗时不确定的任务默认用 Claude Code `--background`，立即交还控制权。 - 默认交接位为 `~/.cc-delegate/tasks/<task-id>`，避免 Git 工作区污染和历史回执串线。 - 验证对账忽略末尾无害的 `2>&1`，但仍拒绝真实参数差异。 - 会话登记本与安装副本解耦，Codex 和 WorkBuddy 可读取同一状态。 - 新增 `agents/openai.yaml`，便于 Codex 展示和调用。 ## 目录 ```text cc-delegate/ ├── SKILL.md ├── agents/ │ └── openai.yaml ├── scripts/ │ ├── cc_delegate.py │ ├── cc_protocol.py │ ├── cc_monitor.py │ ├── poll_tick.py │ ├── session_registry.py │ ├── run_history.py │ ├── optimization_tracker.py │ └── sync_installations.py ├── references/ │ ├── audit-parsing.md │ ├── monitor-reference.md │ ├── optimization-loop.md │ ├── peer-plan.md │ ├── run-history.md │ └── workbuddy-mcp.md ├── tests/ ├── ARCHITECTURE.md └── mcp-config.example.json ``` ## 前置条件 | 依赖 | 要求 | |---|---| | Claude Code CLI | `claude` 在 `PATH` 且已登录 | | Python | 3.7+，脚本只用标准库 | | Node.js | 仅 WorkBuddy MCP 备用通道需要 | ## 安装把仓库安装到编排器可发现的 Skill 目录。需要 Codex 与 WorkBuddy 共用时，推荐保存一份实体，再用目录 Junction 暴露给两个运行时，避免复制后版本漂移。本机当前采用： ```text C:\Users\Administrator\.agents\skills\cc-delegate (Codex 直接发现) <- Junction: C:\Users\Administrator\.claude\skills\cc-delegate C:\Users\Administrator\.workbuddy\skills\cc-delegate <- 独立镜像，发布时同步代码，保留 sessions.json ``` `session_registry.py` 会优先复用已有的 WorkBuddy 登记本。若要配置 MCP 备用通道，见 [references/workbuddy-mcp.md](references/workbuddy-mcp.md)。 ## 自动运行记录 `cc_delegate.py`、`cc_monitor.py`、`poll_tick.py` 和 `session_registry.py` 的每次进程调用都会自动写入： ```text ~/.cc-delegate/run-history/YYYY/MM/DD/<run-id>.json ``` 启动时先写 `RUNNING`，结束后原子更新，因此崩溃或强杀仍会留下可分析记录。运行记录只保存元数据、路径、状态、耗时、费用和回执摘要；任务原文、transcript 正文与 `--json` 内容不会复制进账本。若初始记录无法写入或正常运行试图关闭 history，命令以退出码 70 失败关闭；只有隔离测试可显式设置 `CC_DELEGATE_HISTORY_TESTING=1` 后关闭。 ```powershell $history = Join-Path $skillRoot "scripts\run_history.py" python -X utf8 $history list --limit 20 python -X utf8 $history stats --days 30 ``` 详细字段、关联查询和优化方法见 [references/run-history.md](references/run-history.md)。 ## 三次阈值自动优化一次完整的 Peer Plan 或执行委派收工时，必须对新关联的 run ID 写一次复盘： ```powershell $optimizer = Join-Path $skillRoot "scripts\optimization_tracker.py" python -X utf8 $optimizer review ` --correlation "<marker-or-absolute-state-path>" ` --no-point ``` `--no-point` 只表示编排器没有人工优化建议；运行失败、陈旧 `RUNNING`、 Peer Plan 超时/不可用/格式恢复和无验证的 `DONE` 仍会自动生成客观优化点。同一 fingerprint 自上次 `APPLIED`/`NO_CHANGE` 后累计 3 个不同复盘，返回 `AUTO_OPTIMIZE_READY`。当前编排器须先独占认领，再读三条证据、完成最小修复、全量回归、安全同步安装副本并记录解决结果。配置、手工优化点、并发租约、安全边界和恢复命令见 [references/optimization-loop.md](references/optimization-loop.md)。 ## Codex Plan 模式双计划 Codex 先独立形成 Plan A，再从目标仓库目录调用 Claude Code 生成只读 Plan B： ```powershell $delegate = Join-Path $skillRoot "scripts\cc_delegate.py" $planDir = Join-Path $env:USERPROFILE ".cc-delegate\plans\$taskId" New-Item -ItemType Directory -Force -Path $planDir | Out-Null $promptFile = python -X utf8 $delegate assemble-plan ` --base-file $originalTaskFile --workfolder $workFolder ` --output-file (Join-Path $planDir "prompt.txt") python -X utf8 $delegate run-plan ` --prompt-file $promptFile --workfolder $workFolder ` --output-file (Join-Path $planDir "claude-output.json") ` --stderr-file (Join-Path $planDir "claude-stderr.txt") ` --state-file (Join-Path $planDir "state.json") --timeout 180 # run-plan 返回 IN_PROGRESS/exit 3 时，继续检查同一 worker，不要重派。 python -X utf8 $delegate plan-status ` --state-file (Join-Path $planDir "state.json") ``` 不要把 Plan A 写进 `$originalTaskFile`。完整的触发、超时和对照规则见 [references/peer-plan.md](references/peer-plan.md)。 ## 最小使用示例以下为 PowerShell。`$skillRoot` 必须指向本次实际加载的 Skill 根目录，不要硬编码 `.workbuddy` 或 `.codex`： ```powershell $workFolder = "C:\path\to\repo" $taskId = "fix-parser-001" $handoffDir = Join-Path $env:USERPROFILE ".cc-delegate\tasks\$taskId" $marker = "TID=cc_${taskId}_20260730" $delegate = Join-Path $skillRoot "scripts\cc_delegate.py" $monitor = Join-Path $skillRoot "scripts\cc_monitor.py" python -X utf8 $delegate preflight ` --workfolder $workFolder --handoff-dir $handoffDir --create-handoff $promptFile = python -X utf8 $delegate assemble ` --base "修复解析器并运行相关测试" ` --workfolder $workFolder --handoff-dir $handoffDir ` --marker $marker --output-file "$env:TEMP\$taskId-prompt.txt" ` --begin-step $prompt = Get-Content -Raw -LiteralPath $promptFile $launch = claude --background --dangerously-skip-permissions $prompt 2>&1 python -X utf8 $monitor ` --workfolder $workFolder --handoff-dir $handoffDir ` --marker $marker --show ``` Claude Code 2.1.204 不允许 `--background` 与 `-p` 同用。短任务改为 `claude --dangerously-skip-permissions -p $prompt`，前台等待结果。每次 dispatch 都生成新 marker。`--begin-step` 会封存上一棒回执并写入 `IN_PROGRESS`，防止 resume 后误读旧 `DONE`。background resume 可能产生新 SID；启动后用新 marker 重新执行 `--print-sid`，再更新登记本。使用 `set-sid --sid <new> --marker <current>` 同时更新两者。保存 launch 输出里的 `backgrounded · <id>`。完成后执行 `claude stop <id>`，避免 `idle/done` 后台服务残留；非交互环境用 `claude agents --json` 查看状态。 ## 回执协议 Claude Code 必须在声明的交接目录写： ```text result.json HANDOFF.md ``` `result.json` 至少包含： ```json { "status": "DONE", "summary": "完成了什么", "artifacts": ["path/to/file"], "issues": [], "next_suggestions": [], "verification": { "command": "python -X utf8 -m unittest -v", "pass": true } } ``` 六个顶层字段都必须存在；`artifacts`、`issues`、`next_suggestions` 只能是字符串数组，不能写成 `{path, change}` 对象。schema 不合法时按坏回执处理，不会猜测兼容。完成后用精确 transcript 对账： ```powershell python -X utf8 $delegate parse ` --workfolder $workFolder --handoff-dir $handoffDir ` --transcript $transcript python -X utf8 $delegate decide ` --workfolder $workFolder --handoff-dir $handoffDir ` --transcript $transcript ``` 只有 `result.json` 与 `HANDOFF.md` 同时精确 `DONE`、`decide` 返回 `CONSUME`，且独立复验通过，才算完成。任一回执先完成时只允许 `POLL`。 ## 跨会话续干长任务取得 SID 后登记： ```powershell $registry = Join-Path $skillRoot "scripts\session_registry.py" python -X utf8 $registry register ` --project $project --sid $sid --workfolder $workFolder ` --desc $summary --marker $marker ``` 恢复前必须 `claim`，结束后 `release`，项目完成后 `close`。登记本默认位于 `~/.cc-delegate/sessions.json`；若只存在旧 WorkBuddy 登记本，则继续使用旧文件。 ## 测试 ```powershell python -X utf8 -m unittest discover -s tests -v ruff check scripts tests python -X utf8 -m compileall -q scripts tests ``` 架构与安全边界见 [ARCHITECTURE.md](ARCHITECTURE.md)。 ## 许可证 [MIT](LICENSE)

Chargement du README du dépôt…

Skills dans ce dépôt

Autres occupations informatiques

1 catégories métier · 100% classifié

skill

métier

description

mis à jour

cc-delegate

Autres occupations informatiques

Delegate local repository tasks from Codex, WorkBuddy, or another orchestrator to Claude Code with an independent read-only Peer Plan, scoped paths, resumable sessions, automatic run history, a three-use optimization loop, receipts, monitoring, and…

Langue du texte source : anglais

2026-08-15

Affichage de 1 skills collectés sur 1.