Hooks (before_prompt_build, before_tool_call)
  |
  v
Tools (11 个工具)  <-->  Core (状态机 / 状态存储 / 进度计算 / 变更追踪)
  |
  v
Skill (schema-driven 工作流)  --  LLM 读取的结构化行为指南

pending     -> assigned, cancelled
assigned    -> running, cancelled
running     -> completed, failed, blocked, cancelled, revised, running
blocked     -> pending
revised     -> running, pending
completed   -> (终态)
failed      -> running
cancelled   -> (终态)

config_merge                        # 合并项目上下文
  -> task_recall                    # 检索历史经验
    -> task_create                  # 创建任务 (pending)
      -> 填充两文档 + steps          # brief -> spec -> plan，steps 通过 steps_update 管理
        -> task_transition          # pending -> assigned -> running
          -> 执行 + task_log        # 记录过程事件
            -> task_verify          # 验收检查
              -> task_archive       # 归档 + 提取经验

spec-task/
├── index.ts                        # 插件入口
├── openclaw.plugin.json            # 插件清单
├── package.json                    # 依赖管理
├── tsconfig.json                   # TypeScript 配置
├── vitest.config.ts                # 测试配置
├── src/
│   ├── types.ts                    # 全局类型定义
│   ├── detector.ts                 # 工作区检测器（5 级）
│   ├── file-utils.ts               # 文件操作工具类
│   ├── tool-utils.ts               # 工具响应格式化
│   ├── openclaw-sdk.d.ts           # SDK 类型声明
│   ├── core/
│   │   ├── config.ts               # 配置管理器
│   │   ├── status-store.ts         # 状态持久化（原子写入 + 文件锁）
│   │   ├── state-machine.ts        # 状态机转换校验
│   │   ├── schema-reader.ts        # Schema 驱动的状态推断
│   │   ├── spec-extractor.ts       # 构件提取器
│   │   ├── run-utils.ts            # 运行目录工具（run ID 生成、活跃 run 检测）
│   │   ├── steps-utils.ts          # Steps 操作（进度计算、同步、加载）
│   │   └── revision.ts             # 变更追踪器
│   ├── tools/
│   │   ├── config-merge.ts         # 配置合并
│   │   ├── task-recall.ts          # 历史搜索
│   │   ├── task-create.ts          # 创建任务
│   │   ├── task-transition.ts      # 状态流转
│   │   ├── task-log.ts             # 事件日志
│   │   ├── task-verify.ts          # 验收管理
│   │   ├── task-resume.ts          # 断点恢复
│   │   ├── task-archive.ts         # 归档
│   │   ├── task-instructions.ts    # 构件创建指导
│   │   ├── steps-read.ts           # 步骤读取
│   │   └── steps-update.ts         # 步骤更新
│   └── hooks/
│       └── before-prompt-build.ts  # 上下文注入钩子
├── skills/spec-task/
│   ├── config.yaml                 # 内置默认配置
│   ├── reference/                  # 参考文档
│   └── schemas/agent-task/         # Schema + 模板
├── test/                           # 测试（580+ 用例）
└── memory/                         # 归档历史和经验教训

{task-name}/
├── status.yaml                     # 运行时状态 + 事件日志 + 版本链 + steps
├── brief.md                        # 任务简报（问题定义）
├── spec.md                         # 验收规格（验收场景）
├── plan.md                         # 执行计划（步骤拆解）
├── runs/                           # 运行目录（支持多轮执行）
│   └── 001/
│       └── status.yaml             # 当前 run 的状态快照
├── outputs/                        # 产出物目录
└── subtasks/                       # 子任务目录（递归结构）

context: ""                           # 从身份文件提取的背景信息
tracking:
  level: medium                       # 追踪级别：low / medium / high
runtime:
  task_timeout: 60                     # 任务超时（分钟）
  allow_agent_self_delegation: true    # 允许 agent 自行创建子任务
failure_policy:
  verify_failed:
    strategy: adaptive                 # retry | escalate | adaptive
    max_retries: 2
    on_exhausted: escalate
  soft_block:
    strategy: retry
    max_retries: 3
  hard_block:
    strategy: adapt
    adapt_modifies: [plan, steps, spec]
    on_adapt_failed: fail
archive:
  record_history: true
  generate_lessons: true
  auto_archive: false

{
  "plugins": {
    "spec-task": {
      "path": "./extensions/spec-task"
    }
  }
}

cd extensions/spec-task
npm install

# 全部测试
npx vitest run

# 仅单元测试
npx vitest run --testPathPattern "test/unit"

# 仅 E2E 测试
npx vitest run --testPathPattern "test/e2e"

# 类型检查
npx tsc --noEmit