Files

T

laily d7a74578dc refactor(agent-collaboration-kit): split stable core from project overrides

- Reorganize flat files into core/ templates/ examples/ scripts/ with VERSION
- Deduplicate: single-source state machine, three-round policy, acceptance signals
- Abstract orchestration in closed-loop.md with manual mode; move Orca commands to orca-adapter.md
- Add tasks.schema.json + validate_tasks.py (jsonschema or builtin rules, no hard deps)
- Add filled examples, concurrency write rule, kitVersion tracking; unify to Chinese

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-07-06 10:01:09 +08:00

3.3 KiB

Raw Blame History

Agent Collaboration Kit

一套可复用到其它项目的多 Agent 协作规范：产品/测试负责定义与验收，开发负责实现与白盒验证，协调者做闭环调度。

当前版本见 VERSION。这不是 Agent Skill（无 SKILL.md），不由 skiff 安装，而是复制/引用到目标项目。

适用场景

多个 Agent 分工协作，而非单个 Agent 从需求写到代码。
需要区分规格、测试、实现、复测的责任边界。
需要把失败项派发给开发 Agent，worker_done 后由测试 Agent 复测。
需要连续修复多个问题，并把三轮仍未修好的问题留档。

目录结构

agent-collaboration-kit/
  VERSION                       # kit 版本，接入时记入项目
  README.md
  adoption-checklist.md
  core/                         # 稳定核心：跨项目通用，随 kit 升级，尽量别改
    roles-and-permissions.md    #   角色/权限/状态机/完成定义（SSOT）
    closed-loop.md              #   编排无关闭环 + 手动模式 + worktree 对齐
    optimization-method.md      #   验收信号 + 三轮失败策略（SSOT）
    prompt-templates.md         #   派发 prompt 模板
    orca-adapter.md             #   Orca 具体命令（一种编排实现，可选）
  templates/                    # 项目覆盖层：复制一次并填空
    AGENTS.template.md
    tasks.template.yaml
    tasks.schema.json           #   任务板权威结构（跨语言）
  examples/                     # 填好的最小可跑示例
    AGENTS.example.md
    tasks.example.yaml
  scripts/
    validate_tasks.py           # 校验 tasks.yaml（参考实现）

核心原则：core/ 是稳定核心，每个概念只定义一次；templates/ 是项目覆盖层。二者分离，让 kit 升级和项目定制互不干扰。

分发方式（二选一）

方式 A：引用稳定核心（推荐，可升级）

core/ + scripts/ 通过 symlink / git submodule / sparse checkout 映射到项目 docs/agent-collaboration-kit/；项目只维护自己的 AGENTS.md、tasks.yaml。kit 升级时稳定核心自动生效，项目定制不受影响。

方式 B：整份复制（简单，手动升级）

整目录复制到 docs/agent-collaboration-kit/。务必在项目 AGENTS.md 与 tasks.yaml 的 kitVersion 记录来源版本，日后照 VERSION diff 升级 core/。

无论哪种方式，项目的 AGENTS.md 只填差异（路径、命令、handle），不复制 core/ 内容。

快速接入

选定分发方式，把 kit 放到项目 docs/agent-collaboration-kit/。
复制 templates/AGENTS.template.md → 项目根 AGENTS.md，填项目差异，记 kitVersion。
复制 templates/tasks.template.yaml → 项目根 tasks.yaml，填 project 与首个任务。
跑 python3 docs/agent-collaboration-kit/scripts/validate_tasks.py tasks.yaml 确认结构。
按 core/closed-loop.md 跑闭环（Orca 见 core/orca-adapter.md，无 Orca 用手动模式）。
逐项对照 adoption-checklist.md。

参考 examples/ 里填好的 AGENTS.example.md 与 tasks.example.yaml。

默认口令

用 Agent 协作闭环处理 tasks.yaml 里的未通过项；每个问题最多派发开发 Agent 修三轮，三轮仍不过就记录为遗留，然后继续下一个。

3.3 KiB Raw Blame History Unescape Escape