.pouch/kits/agent-collaboration-kit/AGENTS-template.md

Agent Protocol

本项目使用 docs/agent-collaboration-kit/ 中的多 Agent 协作规范。本文填入本项目自己的路径、命令和权限边界。

Project Overview

• Project: <project_name>
• Stack: <tech_stack>
• Main app command: <run_command>
• Base URL: <base_url>
• Task board: tasks.yaml

Roles

Role	Responsibility	Validation
Product/Test Coordinator	Defines requirements, writes task evidence, runs black-box retest, marks verified	Browser/API/integration tests
Developer Worker	Implements fixes/features, writes unit tests, runs build and white-box tests	Unit tests/build/local run

Path Scoping

Path	Product/Test	Developer	Notes
<spec_paths>	R/W	Read-only	Product specs, API docs, plans
<integration_test_paths>	R/W	Read-only	Browser/API regression
<test_records_path>	R/W	Read-only	Run records
<source_paths>	Read-only	R/W	Application source
<unit_test_paths>	Read-only	R/W	Unit tests
<shared_config_templates>	Read-only	R/W	Committable config templates
<local_config_paths>	Read-only	Read-only	Local secrets/overrides
tasks.yaml	R/W	Limited R/W	Product/Test owns verified; Developer may write implementation status/evidence

Commands

Developer verification:

<unit_test_command>
<build_command>
<local_run_command>

Product/Test verification:

<preflight_command>
<api_smoke_command>
<browser_regression_command>

Task Status Lifecycle

open -> dispatched -> fixed_by_dev -> retesting -> verified

Failure states:

blocked
failed_retest
leftover

Rules:

• worker_done is not completion. Product/Test must retest before verified.
• Each task can be dispatched to Developer at most 3 rounds.
• If still failing after 3 rounds, mark leftover, record evidence, and continue the next task.
• Do not commit or push unless the user explicitly asks.

Orca Closed Loop

Use docs/agent-collaboration-kit/orca-closed-loop.md when the user asks for supervised implementation/retest loops.

Default loop:

Product/Test records failure in tasks.yaml
  -> Orca task-create
  -> dispatch Developer Worker
  -> wait worker_done/escalation/decision_gate
  -> Product/Test retests
  -> verified / failed_retest / leftover

Definition Of Done

A task is done only when:

• Developer reports files modified and verification commands.
• Product/Test verifies in the correct worktree/service.
• Relevant build/test/browser/API checks pass.
• tasks.yaml contains final evidence.