@tea-agent/loop-agent 0.3.0 → 0.5.0

package/skills/init-capability-evolution/SKILL.md

@@ -1,69 +1,69 @@
----
-name: init-capability-evolution
-description: 用于 loop-agent 本仓库的初始化能力演化审查，判断代码、skill、模板、包范围或 DAG 默认能力变化是否需要同步更新目标项目 init surface。
----
-
-# Init Capability Evolution
-
-本 skill 用于 loop-agent 本仓库。当变更可能影响 `loop-agent init` 初始化其他项目的能力时使用。
-
-## Goal
-
-让模型自行判断并维护初始化能力，而不是依赖人工记忆：
-
-- 新能力是否应该进入目标项目。
-- 新增/修改的 skill 是否应随 npm 包和 `init --profile full` 投影。
-- 目标项目的 `AGENTS.md`、README managed block、治理 docs、scripts 或 templates 是否需要更新。
-- `package.json files` 与 `docs/init-surface.manifest.json` 是否仍覆盖真实发布范围。
-- 是否需要目标项目 smoke、init doctor、docs audit 或 package dry-run 证据。
-
-## Trigger Tiers
-
-按 `docs/init-surface.manifest.json` 的 `evolutionReview.tiers` 判断成本：
-
-- `advisory`：只记录提示，不阻塞。
-- `surface-check`：运行 `bash scripts/check-init-surface.sh`；通过即可。
-- `model-review`：写一份简短 init evolution review，必要时修改 init surface、包范围、文档、skill 或测试。
-
-不要把小改动升级成重流程。只有当变化可能改变目标项目初始化体验、默认 DAG 行为、skill resolution、发布包边界或 init 生成物时，才进入 model-review。
-
-## Review Questions
-
-审查时逐条回答：
-
-1. 本次变更会改变目标项目执行 `loop-agent init --profile full --merge` 后得到的文件、规则或能力吗？
-2. 是否新增、删除或重命名了 `skills/**`，并且目标项目需要 repo-local 可审计副本？
-3. 是否改变了默认 DAG role skills、skill resolution、strict skill audit 或 task prompt 注入？
-4. 是否新增通用治理模板、script matrix、production readiness 或 operator recovery 文档，需要目标项目初始化后可见？
-5. `package.json files` 是否包含所有 npm 运行和初始化所需静态资料？
-6. `docs/init-surface.manifest.json` 是否更新了 package / init / exclude / trigger contract？
-7. 旧目标项目是否只需 advisory、需要手工复制新增文件，还是需要未来 `init audit/update` 迁移能力？
-
-## Output
-
-轻量审查可以只在 handoff 中说明。高影响审查应写入：
-
-```text
-docs/reports/YYYY-MM-DD-init-evolution-review.md
-```
-
-报告保持短小，包含：
-
-- changed surface
-- decision: no init impact / surface check only / init update required
-- files updated
-- verification commands and results
-- residual risk
-
-## Required Verification
-
-按影响面选择最小命令：
-
-```bash
-bash scripts/check-init-surface.sh
-bash scripts/check-repo.sh
-npm test -- init-command dag-skills dag-validate-command
-npm pack --dry-run --ignore-scripts
-```
-
-如果没有新鲜验证证据，不要宣称 init evolution 已完成。
+---
+name: init-capability-evolution
+description: 用于 loop-agent 本仓库的初始化能力演化审查，判断代码、skill、模板、包范围或 DAG 默认能力变化是否需要同步更新目标项目 init surface。
+---
+
+# Init Capability Evolution
+
+本 skill 用于 loop-agent 本仓库。当变更可能影响 `loop-agent init` 初始化其他项目的能力时使用。
+
+## Goal
+
+让模型自行判断并维护初始化能力，而不是依赖人工记忆：
+
+- 新能力是否应该进入目标项目。
+- 新增/修改的 skill 是否应随 npm 包和 `init --profile full` 投影。
+- 目标项目的 `AGENTS.md`、README managed block、治理 docs、scripts 或 templates 是否需要更新。
+- `package.json files` 与 `docs/init-surface.manifest.json` 是否仍覆盖真实发布范围。
+- 是否需要目标项目 smoke、init doctor、docs audit 或 package dry-run 证据。
+
+## Trigger Tiers
+
+按 `docs/init-surface.manifest.json` 的 `evolutionReview.tiers` 判断成本：
+
+- `advisory`：只记录提示，不阻塞。
+- `surface-check`：运行 `bash scripts/check-init-surface.sh`；通过即可。
+- `model-review`：写一份简短 init evolution review，必要时修改 init surface、包范围、文档、skill 或测试。
+
+不要把小改动升级成重流程。只有当变化可能改变目标项目初始化体验、默认 DAG 行为、skill resolution、发布包边界或 init 生成物时，才进入 model-review。
+
+## Review Questions
+
+审查时逐条回答：
+
+1. 本次变更会改变目标项目执行 `loop-agent init --profile full --merge` 后得到的文件、规则或能力吗？
+2. 是否新增、删除或重命名了 `skills/**`，并且目标项目需要 repo-local 可审计副本？
+3. 是否改变了默认 DAG role skills、skill resolution、strict skill audit 或 task prompt 注入？
+4. 是否新增通用治理模板、script matrix、production readiness 或 operator recovery 文档，需要目标项目初始化后可见？
+5. `package.json files` 是否包含所有 npm 运行和初始化所需静态资料？
+6. `docs/init-surface.manifest.json` 是否更新了 package / init / exclude / trigger contract？
+7. 旧目标项目是否只需 advisory、需要手工复制新增文件，还是需要未来 `init audit/update` 迁移能力？
+
+## Output
+
+轻量审查可以只在 handoff 中说明。高影响审查应写入：
+
+```text
+docs/reports/YYYY-MM-DD-init-evolution-review.md
+```
+
+报告保持短小，包含：
+
+- changed surface
+- decision: no init impact / surface check only / init update required
+- files updated
+- verification commands and results
+- residual risk
+
+## Required Verification
+
+按影响面选择最小命令：
+
+```bash
+bash scripts/check-init-surface.sh
+bash scripts/check-repo.sh
+npm test -- init-command dag-skills dag-validate-command
+npm pack --dry-run --ignore-scripts
+```
+
+如果没有新鲜验证证据，不要宣称 init evolution 已完成。

package/skills/loop-agent/SKILL.md

@@ -91,6 +91,7 @@ bounded writer 完成后，主会话必须独立复核；命令清单见 `refere
 | Long-Running Loop（`loop` init/status/run/record-round/add-signal/closeout、auto mode、signals） | `references/long-running-loop.md` |
 | Three-Pass Convergence、repair artifact、spine audit、knowledge curate、SePO-lite prompt evolution | `references/harness-policy.md` |
 | Operator commands（status/doctor/report/closeout/promote/inspect/spine/knowledge/docs/handoff） | `references/command-reference.md` |
+| 伴生 CLI `agent-worker`（TaskSpec / Task Pool / batch / morning report） | `references/command-reference.md` |
 | Post-Cursor 独立验证、verify knobs、failure handling、closeout | `references/verification-and-failure-handling.md` |
 
 ## Source Layout
@@ -104,6 +105,7 @@ bounded writer 完成后，主会话必须独立复核；命令清单见 `refere
 | Long-running loop workflow | `src/workflows/loop/` |
 | Task runtime | `src/task/` |
 | Executors | `src/executors/` |
+| Worker TaskSpec pipeline（伴生 CLI `agent-worker`） | `src/worker/` |
 | Run records / promotion / closeout | `src/records/` |
 | Governance | `src/governance/` |
 | Shared helpers | `src/shared/` |

package/skills/loop-agent/references/command-reference.md

@@ -14,12 +14,12 @@ loop-agent <command> ...
 
 面向自举迭代和日常使用时，全局 CLI 应来自 npm 上已发布的安装包。首次安装或有意升级使用 `@latest`：
 
-```bash
-npm install -g @tea-agent/loop-agent@latest
-npm list -g @tea-agent/loop-agent --depth=0
-loop-agent --version
-loop-agent doctor
-```
+```bash
+npm install -g @tea-agent/loop-agent@latest
+npm list -g @tea-agent/loop-agent --depth=0
+loop-agent --version
+loop-agent doctor
+```
 
 一次自举任务启动后不要中途升级控制器；记录 `npm list -g` 显示的实际版本。不要在 DAG 节点中反复用 `npx @latest` 拉取，也不要使用当前工作区的 `npm link` 或 `npm run dev` 作为控制器去修改 loop-agent 本仓库的 CLI、DAG runtime、executor、package metadata 或 build output。`npm run dev -- <command> ...` 只用于源码调试和聚焦 CLI 开发。
 
@@ -66,11 +66,11 @@ loop-agent doctor
    ```
 
 ### Setup（首次）
-```bash
-npm install -g @tea-agent/loop-agent@latest
-loop-agent --version
-loop-agent --help
-```
+```bash
+npm install -g @tea-agent/loop-agent@latest
+loop-agent --version
+loop-agent --help
+```
 
 ### 检查 repo harness
 ```bash
@@ -78,10 +78,10 @@ loop-agent inspect                                           # 当前 repo（自
 loop-agent --repo-root /path/to/target-repo inspect           # 指定 repo
 ```
 
-### 健康检查
-```bash
-loop-agent doctor
-```
+### 健康检查
+```bash
+loop-agent doctor
+```
 
 `doctor` 报告当前生效的 Pi backend 及 SDK/CLI 可用性。Pi step 默认 SDK-first 执行：
 
@@ -90,26 +90,26 @@ export CODE_AGENT_PI_BACKEND=sdk-first   # 默认：先试 Pi SDK，允许时 fa
 export CODE_AGENT_PI_BACKEND=cli-only    # 紧急回滚：纯 CLI 路径
 ```
 
-SDK 回归或 SDK 可选依赖不可用时用 `cli-only` 诊断。CLI fallback 路径须与现有 workflow 行为兼容。
-
-### 初始化与旧项目更新
-```bash
-loop-agent init instructions --repo-root <target-repo>
-loop-agent init --repo-root <target-repo> --profile full --merge
-loop-agent init doctor --repo-root <target-repo>
-loop-agent init check-update --repo-root <target-repo> --json
-loop-agent init check-update --repo-root <target-repo> --markdown
-loop-agent init update --repo-root <target-repo> --bootstrap-surface
-loop-agent init update --repo-root <target-repo> --apply-safe
-```
-
-`init check-update` 是只读升级报告，用于发现目标项目是否落后于当前包内初始化 surface。输出会区分 deterministic actions、model merge tasks、human decisions 和 recommended next。`--markdown` 会渲染可直接交给模型执行的合并指引，包含 `allowedPaths`、`forbiddenPaths`、`mergeRules` 和 `verification`。
-
-`init update --bootstrap-surface` 为旧项目写入 `.harness/init-surface.json` 的 `inferred-baseline`，不伪装成历史 recorded baseline。`init update --apply-safe` 只执行确定性安全动作：补缺失文件、创建目录、刷新 managed block；已有但无法确认与当前包一致的文件会进入 model merge tasks，不会被覆盖。
-
-### 创建新 task
-```bash
-loop-agent new-task <task-id> "Task Title"
+SDK 回归或 SDK 可选依赖不可用时用 `cli-only` 诊断。CLI fallback 路径须与现有 workflow 行为兼容。
+
+### 初始化与旧项目更新
+```bash
+loop-agent init instructions --repo-root <target-repo>
+loop-agent init --repo-root <target-repo> --profile full --merge
+loop-agent init doctor --repo-root <target-repo>
+loop-agent init check-update --repo-root <target-repo> --json
+loop-agent init check-update --repo-root <target-repo> --markdown
+loop-agent init update --repo-root <target-repo> --bootstrap-surface
+loop-agent init update --repo-root <target-repo> --apply-safe
+```
+
+`init check-update` 是只读升级报告，用于发现目标项目是否落后于当前包内初始化 surface。输出会区分 deterministic actions、model merge tasks、human decisions 和 recommended next。`--markdown` 会渲染可直接交给模型执行的合并指引，包含 `allowedPaths`、`forbiddenPaths`、`mergeRules` 和 `verification`。
+
+`init update --bootstrap-surface` 为旧项目写入 `.harness/init-surface.json` 的 `inferred-baseline`，不伪装成历史 recorded baseline。`init update --apply-safe` 只执行确定性安全动作：补缺失文件、创建目录、刷新 managed block；已有但无法确认与当前包一致的文件会进入 model merge tasks，不会被覆盖。
+
+### 创建新 task
+```bash
+loop-agent new-task <task-id> "Task Title"
 ```
 
 创建 `.harness/tasks/<task-id>/`，含 `source/`、`artifacts/`、`logs/` 及初始 state。
@@ -348,6 +348,34 @@ loop-agent knowledge curate --markdown --output docs/reports/<task-id>-learned-p
 
 读取 `.harness/knowledge/patterns.jsonl` 中 completed convergence repair pattern，按 `failureClass + fixScope shape + invariant` 去重，生成 human-gated learned guidance proposal。命令只生成 proposal，不直接修改 `./skill/references/learned/*.md`；输出会先通过 skill safety audit。
 
+### Worker TaskSpec pipeline（伴生 CLI `agent-worker`）
+
+`agent-worker` 是与 `loop-agent` 一起发布的独立 CLI（`bin/agent-worker.js -> dist/worker/cli.js`），面向“产品线 Worker”场景：把一批 TaskSpec 规约成可校验、可串行调度、可晨报的流水线。它不进入 `loop-agent` 命令树，也不自带 executor——执行权全部通过子进程委托给已发布的 `loop-agent` CLI（最终是 DAG runtime + shell verification）。
+
+```bash
+agent-worker task validate <task.yaml>            # 三层校验 TaskSpec，输出 JSON
+agent-worker task explain-profile <task.yaml>     # 解释业务 type/risk -> DAG governance profile 映射
+agent-worker batch run-ready \
+  --feature-dir <feature-dir> \                   # 含 tasks/task-graph.yaml
+  --repo <repo-root> \                            # 目标 repo
+  [--limit <count>] [--batch-run-id <id>] \
+  [--loop-agent-bin loop-agent] \
+  [--check-repo] [--check-repo-command <command...>] \
+  [--quiet] \
+  [--pi-model <model>]                           # smoke 覆盖：所有 pi 节点强制用该模型
+agent-worker report morning --repo <repo-root> [--batch-run-id <id>] [--output <path>]
+```
+
+语义要点：
+
+- TaskSpec 声明单个任务的业务上下文、`risk_level`、验收与 verify 边界；`risk_level` 被确定性映射到 task complexity。AcceptanceSpec / TaskGraphSpec 声明跨任务验收引用与依赖图，ready queue 决定可运行任务并检测未知依赖/环/文件一致性。
+- 业务 type（`backend-feature`/`frontend-feature`/`qa-testcode` 等）是产品线 profile，不能直接传给 `loop-agent dag run-task --profile`；Worker 会映射到 `auto`/`minimal`/`standard`/`reviewed`/`supervised`。
+- materializer 把 TaskSpec 物化为 `.harness/tasks/<task-id>` 后，Worker 调用 `dag run-task` / `dag validate` / `run-dag` / `dag report`。成功路径走 `promote-run` + `closeout task`；失败路径收集 `dag doctor` / `dag closeout-draft` evidence，写入目标 repo 的 `.task-pool/failure-handoffs/`（不写 `.harness/`，因为 `dag closeout-draft` 会拒绝在 completed facts 之外写入）。
+- Worker runtime state 落在目标 repo 的 `.task-pool/`（artifacts、JSONL/state、晨报、failure handoffs），与 `.harness/` 分离；`.task-pool/` 默认被 `.gitignore` 忽略。
+- preflight 在 `new-task` 前跑 `loop-agent --version`、`inspect`、`docs-audit`、`git status --short --branch`，可选 `--check-repo`。一次夜间批处理期间不升级控制器，记录实际 `loop-agent` 版本。
+- `batch run-ready` 默认在 stderr 输出人类可读进度（批次起止、每个 task 的阶段与耗时、report 决策），stdout 只保留最终 JSON，便于管道取用；加 `--quiet` 可关闭进度。
+- 当前 Worker 仍是 v0（库 + CLI + dogfood），未接入定时/CI 驱动；`report morning` 只能从已有 Task Pool runs 汇总。
+
 ### 查看 duration statistics
 ```bash
 loop-agent stats

package/skills/loop-agent/references/harness-policy.md

@@ -225,10 +225,11 @@ Sidecar output 为 advisory。若须成为 task evidence，通过 loop-agent run
 - `.harness/tasks/<task-id>/loop/` 是 loop runtime projection；不替代 task source 或 repo specs。
 - `.harness/dag-runs/{active,paused,completed}/<run-id>/` 是 DAG run fact storage。Completed facts 为 read-only。
 - `.harness/runs/{active,completed,failed}/<run-id>/` 是 one-shot Pi/Cursor evidence。Completed/failed facts 为 read-only。
+- `.task-pool/` 是伴生 CLI `agent-worker`（Worker TaskSpec pipeline）的 runtime state：batch artifacts、Task Pool JSONL/state、晨报和 failure handoffs。默认被忽略，不提交。
 - Root `artifacts/` 是 legacy/current-work summary space，不是 DAG read-only scratchpad，也不是新 DAG work 的 default handoff。
 - Long-term conclusions 属于 repo governance docs、progress、reports、decisions、tests 或 scripts。
 
-除非 task 显式 promote trimmed report 到 repo governance docs，不要提交 `.harness/dag-runs/`、`.harness/runs/` 或 `.harness/cache/` 的 runtime histories。
+除非 task 显式 promote trimmed report 到 repo governance docs，不要提交 `.harness/dag-runs/`、`.harness/runs/`、`.harness/cache/` 或 `.task-pool/` 的 runtime histories。
 
 ## Baseline, dirty workspace, and verification