cowork-flow 0.0.4 → 0.0.5

package/README.md

@@ -28,6 +28,7 @@ cowork-flow 是一个用于新项目初始化协作流程的模板仓库。它
     └── .cowork-flow/
         ├── config.yaml
         ├── workflow.md
+        ├── agent-team/
         ├── scripts/
         ├── spec/
         ├── changes/
@@ -56,6 +57,9 @@ cowork-flow 是一个用于新项目初始化协作流程的模板仓库。它
 `template/.cowork-flow/plans/`
 保存可执行步骤、验证方式和执行状态。
 
+`template/.cowork-flow/agent-team/`
+保存 agent team 的项目级 registry、适配器和策略。默认适配器是 `codex`，由主 agent 调度 Codex 子 agent；没有子 agent 能力时可退回 `manual` 提示词模式。
+
 ## 快速开始
 
 使用 CLI 把模板内容安装到目标项目根目录：
@@ -172,6 +176,19 @@ cowork-flow sync . --dry-run
 ./.cowork-flow/run task start <task-dir>
 ```
 
+执行 plan 时准备 agent team：
+
+默认 `agent_team.enabled: false`。运行 `agent-team prepare/status/next/record-result/record-review/retry/complete` 前，先在 `.cowork-flow/config.yaml` 中设置 `agent_team.enabled: true`。
+
+```bash
+./.cowork-flow/run agent-team init
+./.cowork-flow/run agent-team prepare <task-dir> --plan <plan-file>
+./.cowork-flow/run agent-team next <task-dir>
+./.cowork-flow/run agent-team complete <task-dir>
+```
+
+`agent-team` 命令会生成任务目录内的 dispatch plan、assignments、状态、审阅和 metrics 工件。默认 `codex` 适配器采用主 agent 调度型：脚本生成 Codex-ready 分派文件，主 agent 负责调用子 agent、协调并回写结果。
+
 记录 session：
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cowork-flow",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "CLI for installing and maintaining cowork-flow collaboration templates.",
   "type": "module",
   "bin": {
@@ -10,12 +10,14 @@
     "bin",
     "src",
     "template",
-    "README.md"
+    "README.md",
+    "!template/**/__pycache__/**",
+    "!template/**/*.pyc"
   ],
   "scripts": {
     "test": "node --test",
-    "test:template": "./template/.cowork-flow/run python -m unittest discover tests -v",
-    "pack:check": "npm_config_cache=/tmp/cowork-flow-npm-cache npm pack --dry-run --json",
+    "test:template": "node scripts/run-template-tests.js",
+    "pack:check": "node scripts/pack-check.js",
     "test:all": "npm test && npm run test:template && npm run pack:check"
   },
   "engines": {

package/src/lib/copy-template.js

@@ -90,9 +90,7 @@ export async function buildSuperpowersPlan(targetDir, options = {}) {
 }
 
 const PROTECTED_SYNC_FILES = new Set([
-  'AGENTS.md',
-  '.cowork-flow/config.yaml',
-  '.cowork-flow/workflow.md'
+  '.cowork-flow/config.yaml'
 ]);
 
 const PROTECTED_SYNC_PREFIXES = [
@@ -105,7 +103,7 @@ const PROTECTED_SYNC_PREFIXES = [
 
 const SAFE_SYNC_PREFIXES = [
   '.agent/skills/',
-  '.cowork-flow/scripts/'
+  '.cowork-flow/'
 ];
 
 const SAFE_SYNC_FILES = new Set([
@@ -119,14 +117,16 @@ const COWORK_FLOW_START = '<!-- COWORK-FLOW:START -->';
 const COWORK_FLOW_END = '<!-- COWORK-FLOW:END -->';
 
 function isProtectedSyncFile(relativePath) {
-  return PROTECTED_SYNC_FILES.has(relativePath)
-    || PROTECTED_SYNC_PREFIXES.some((prefix) => relativePath.startsWith(prefix));
+  const templatePath = toTemplatePath(relativePath);
+  return PROTECTED_SYNC_FILES.has(templatePath)
+    || PROTECTED_SYNC_PREFIXES.some((prefix) => templatePath.startsWith(prefix));
 }
 
 function isSafeSyncFile(relativePath) {
-  return SAFE_SYNC_FILES.has(relativePath)
-    || SAFE_SYNC_PREFIXES.some((prefix) => relativePath.startsWith(prefix))
-    || relativePath.endsWith('/.gitkeep');
+  const templatePath = toTemplatePath(relativePath);
+  return SAFE_SYNC_FILES.has(templatePath)
+    || SAFE_SYNC_PREFIXES.some((prefix) => templatePath.startsWith(prefix))
+    || templatePath.endsWith('/.gitkeep');
 }
 
 function replaceManagedBlock(targetContent, templateContent) {

package/src/lib/package-info.js

@@ -31,9 +31,14 @@ export function compareVersions(left, right) {
   return 0;
 }
 
+export function npmCommandOptions(platform = process.platform) {
+  return platform === 'win32' ? { shell: true } : {};
+}
+
 export async function fetchLatestVersion(packageName = 'cowork-flow') {
   const result = await execFileAsync('npm', ['view', packageName, 'version'], {
-    encoding: 'utf8'
+    encoding: 'utf8',
+    ...npmCommandOptions()
   });
   return result.stdout.trim();
 }
@@ -41,7 +46,8 @@ export async function fetchLatestVersion(packageName = 'cowork-flow') {
 export async function runGlobalInstall(packageSpec = 'cowork-flow@latest') {
   return new Promise((resolvePromise, rejectPromise) => {
     const child = spawn('npm', ['install', '-g', packageSpec], {
-      stdio: 'inherit'
+      stdio: 'inherit',
+      ...npmCommandOptions()
     });
     child.on('error', rejectPromise);
     child.on('close', (code) => resolvePromise(code ?? 1));

package/template/.agent/skills/agent-team-execution/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: agent-team-execution
+description: Use when executing an approved implementation plan with independent tasks, multiple agents, or an explicit request to use agent team execution
+---
+
+# Agent Team Execution
+
+Use this skill after a task is active and an approved `.cowork-flow/plans/*.md` file is in task context.
+
+## Process
+
+1. Run `./.cowork-flow/run agent-team prepare <task-dir> --plan <plan-file>`.
+2. Review `agent-team/dispatch-plan.yaml` for unsafe parallelism, file conflicts, missing context, or weak agent matches.
+3. Run `./.cowork-flow/run agent-team next <task-dir>` to get ready assignments.
+4. In Codex, dispatch the ready assignments to the recommended agent types. Tell each worker it is not alone in the codebase, must respect the write boundary, must not revert others' edits, and must list changed files.
+5. While workers run, coordinate: answer questions, unblock context gaps, and integrate non-conflicting results.
+6. Record outputs with `record-result` and reviews with `record-review`.
+7. Use `retry` only after adding missing context, changing agent choice, or splitting an oversized assignment.
+8. Run `complete` before claiming the agent team work is done.
+
+## Rules
+
+- The script suggests; the main agent decides.
+- Do not parallelize assignments with overlapping write files.
+- Do not skip spec review or quality review.
+- Do not rely on chat history for state; write results through `agent-team` commands.

package/template/.agent/skills/start/SKILL.md

@@ -336,6 +336,7 @@ Implement the task described in `prd.md`.
 - Follow all specs injected into implement context
 - Keep changes scoped to requirements
 - Run the project verification commands from `AGENTS.md` or `.cowork-flow/config.yaml` before finishing
+- If executing an approved plan with independent work, use `agent-team-execution`: run `agent-team prepare`, review the dispatch plan, use `agent-team next` for ready assignments, and finish with `agent-team complete`.
 
 **Step 9: Check Quality** `[AI]`
 

package/template/.cowork-flow/.version

@@ -1 +1 @@
-0.0.4
+0.0.5

package/template/.cowork-flow/agent-team/adapters.yaml

@@ -0,0 +1,15 @@
+# Agent Team Adapters
+
+default: codex
+fallback: manual
+
+adapters:
+  codex:
+    mode: coordinator-dispatched
+    description: 主 agent 使用 Codex 子 agent 工具执行脚本生成的 assignments。
+    output_file: adapters/codex.json
+
+  manual:
+    mode: prompt-only
+    description: 生成可复制的 assignment prompt，由人或其他宿主执行并回写结果。
+    output_file: adapters/manual.json

package/template/.cowork-flow/agent-team/agents.yaml

@@ -0,0 +1,68 @@
+# Agent Team Registry
+# Project teams may customize this file after initialization.
+
+default_adapter: codex
+
+agents:
+  implementer:
+    codex_type: worker
+    capabilities:
+      - implementation
+      - test-writing
+    preferred_task_types:
+      - code
+      - test
+    file_patterns:
+      - "src/**"
+      - "template/**"
+      - "tests/**"
+      - "test/**"
+    risk_limits:
+      max_parallel_write_conflicts: 0
+
+  spec-reviewer:
+    codex_type: default
+    capabilities:
+      - spec-review
+      - acceptance-check
+    preferred_task_types:
+      - review
+      - documentation
+    file_patterns:
+      - ".cowork-flow/changes/**"
+      - ".cowork-flow/plans/**"
+      - "README.md"
+      - "template/**"
+    risk_limits:
+      max_parallel_write_conflicts: 0
+
+  quality-reviewer:
+    codex_type: default
+    capabilities:
+      - code-quality-review
+      - test-review
+    preferred_task_types:
+      - review
+      - verification
+    file_patterns:
+      - "src/**"
+      - "template/**"
+      - "tests/**"
+      - "test/**"
+    risk_limits:
+      max_parallel_write_conflicts: 0
+
+  docs-agent:
+    codex_type: worker
+    capabilities:
+      - documentation
+      - workflow-writing
+    preferred_task_types:
+      - docs
+    file_patterns:
+      - "README.md"
+      - "AGENTS.md"
+      - ".cowork-flow/**/*.md"
+      - ".agent/skills/**"
+    risk_limits:
+      max_parallel_write_conflicts: 0

package/template/.cowork-flow/agent-team/policy.yaml

@@ -0,0 +1,23 @@
+# Agent Team Policy
+
+parallel:
+  allow_parallel_batches: true
+  disallow_file_write_conflicts: true
+  require_coordinator_review: true
+
+reviews:
+  require_spec_review: true
+  require_quality_review: true
+  chain:
+    - implementer
+    - spec-reviewer
+    - quality-reviewer
+
+retry:
+  max_attempts: 3
+  retry_on:
+    - needs_context
+    - failed_verification
+    - review_rejected
+    - adapter_failed
+  escalation: needs-coordinator-decision

package/template/.cowork-flow/config.yaml

@@ -14,6 +14,15 @@ session_commit_message: "chore: record journal"
 # Maximum lines per journal file before rotating to a new one
 max_journal_lines: 2000
 
+#-------------------------------------------------------------------------------
+# Agent Team Runtime
+#-------------------------------------------------------------------------------
+
+# Disabled by default. Set to true before using agent-team runtime commands such
+# as prepare/status/next/record-result/record-review/retry/complete.
+agent_team:
+  enabled: false
+
 #-------------------------------------------------------------------------------
 # Task Lifecycle Hooks
 #-------------------------------------------------------------------------------

package/template/.cowork-flow/run

@@ -21,6 +21,7 @@ print_usage() {
   get-developer
   init-developer
   add-session
+  agent-team
 
 解释器选择顺序：
   COWORK_FLOW_PYTHON -> PYTHON -> python3 -> python -> py -3
@@ -150,6 +151,9 @@ case "$command_name" in
   add-session|add_session)
     run_script "$SCRIPTS_DIR/add_session.py" "$@"
     ;;
+  agent-team|agent_team)
+    run_script "$SCRIPTS_DIR/agent_team.py" "$@"
+    ;;
   *)
     if [ -f "$SCRIPTS_DIR/$command_name.py" ]; then
       run_script "$SCRIPTS_DIR/$command_name.py" "$@"

package/template/.cowork-flow/run.cmd

@@ -31,6 +31,8 @@ if /I "%COMMAND_NAME%"=="init-developer" goto run_init_developer
 if /I "%COMMAND_NAME%"=="init_developer" goto run_init_developer
 if /I "%COMMAND_NAME%"=="add-session" goto run_add_session
 if /I "%COMMAND_NAME%"=="add_session" goto run_add_session
+if /I "%COMMAND_NAME%"=="agent-team" goto run_agent_team
+if /I "%COMMAND_NAME%"=="agent_team" goto run_agent_team
 
 if exist "%SCRIPTS_DIR%\%COMMAND_NAME%.py" (
   call :run_script "%SCRIPTS_DIR%\%COMMAND_NAME%.py"
@@ -81,6 +83,10 @@ exit /b %ERRORLEVEL%
 call :run_script "%SCRIPTS_DIR%\add_session.py"
 exit /b %ERRORLEVEL%
 
+:run_agent_team
+call :run_script "%SCRIPTS_DIR%\agent_team.py"
+exit /b %ERRORLEVEL%
+
 :print_usage
 echo 用法：
 echo   .\.cowork-flow\run.cmd ^<command^> [args...]
@@ -94,6 +100,7 @@ echo   get-context
 echo   get-developer
 echo   init-developer
 echo   add-session
+echo   agent-team
 echo.
 echo 解释器选择顺序：
 echo   COWORK_FLOW_PYTHON -^> PYTHON -^> python3 -^> python -^> py -3