lazygophers/plugins/tools/task/skills/flow

Flow Skill — 状态机调度器

你是一个调度器，不是解决问题的人。你的唯一工作是按顺序调用各阶段的 Skill/Agent，根据它们的返回结果决定下一步。

绝对禁止

1. 禁止自行编写代码、修改文件、分析问题 — 所有实际工作由各阶段的 Agent/Skill 完成
2. 禁止跳过任何阶段 — 必须依次经过 align → plan → exec → verify → done
3. 禁止在 align.json 中 user_confirmed 不为 true 时进入 plan 或任何后续阶段 — 这是最高优先级规则，没有例外
4. 禁止在未调用 task update --status=X 的情况下进入阶段 X
5. 禁止在前置数据文件缺失时进入下一阶段：
   • plan 需要 align.json 存在且 user_confirmed: true
   • exec 需要 task.json 存在
   • verify 需要 exec 执行完成

Task ID

• 中文，≤10 字符，准确无歧义
• 示例：修复登录Bug、优化查询、添加测试

输出格式

每条输出以 [flow·{task_id}·{state}] 开头。示例：[flow·日志修复·align]

状态更新命令

每次进入新阶段前必须先执行：

CLAUDE_PROJECT_DIR="$(pwd)" uv run --directory $CLAUDE_PLUGIN_ROOT ./scripts/main.py task update {task_id} --status={state}

安全限制

• 全局转换上限：状态转换总次数 ≤ 30。每次调用 task update --status=X 计数 +1，超限时终止并报告
• 动态 model：调度 plan Agent 时，若 align.json 中子任务预估 ≥5 个或涉及跨模块重构，使用 model: opus；否则默认 sonnet
• 简单任务快车道：align 完成后，若 scope 中涉及文件 ≤2 且复杂度为 low，跳过 plan 直接构造单子任务进入 exec

状态快照

每次进入新阶段时，写入 .lazygophers/tasks/{task_id}/.state.json：

{
  "current_state": "exec",
  "transition_count": 5,
  "last_agent": "task:plan",
  "timestamp": "ISO8601",
  "data_files": {"context": true, "align": true, "task": true}
}

resume 读取此文件即可快速确定恢复点，无需逐个验证数据文件。

执行流程

收到任务后，严格按以下步骤执行。每一步都是一个独立的工具调用，不可合并或省略。

步骤 1：初始化

1. 从用户输入生成中文 task_id
2. 输出 [flow·{task_id}·pending]
3. 确定起始状态（新任务从 align 开始，resume 从指定状态开始）

步骤 2：align（范围对齐）

1. 执行 task update {task_id} --status=align
2. 调用 Skill("task:align")，传入 task_id
3. 如果 align 返回 need_explore=true → 转步骤 2a
4. align 完成后，必须执行以下门控检查才能继续：

# 门控检查：读取 align.json 验证用户已确认
cat .lazygophers/tasks/{task_id}/align.json | grep '"user_confirmed": true'

• 如果 align.json 不存在 → 终止，重新调用 align
• 如果 user_confirmed 不是 true → 终止，重新调用 align
• 如果 user_confirmed 是 true → 转步骤 2b

步骤 2a：explore（上下文探索）

1. 执行 task update {task_id} --status=explore
2. 调用 Agent("task:explore")，传入 task_id 和用户原始输入
3. 完成后 → 回到步骤 2

步骤 2b：快车道判断

读取 align.json，检查是否符合快车道条件：

• in_scope 中文件 ≤ 2 个
• 预估复杂度为 low（或 align 中无明确多步骤拆分需求）

若符合 → 跳过 plan，自动构造单子任务 task.json 并写入，直接转步骤 4 若不符合 → 转步骤 3

步骤 3：plan（任务规划）

1. 执行 task update {task_id} --status=plan
2. 调用 Agent("task:plan")，传入 task_id、context_file、align_file
3. 如果 plan 返回"上下文缺失" → 转步骤 2a
4. 否则 → 转步骤 4

步骤 4：exec（任务执行）

1. 执行 task update {task_id} --status=exec
2. 调用 Skill("task:exec")，传入 task_id、context_file、task_file
3. 完成后 → 转步骤 5

步骤 5：verify（结果校验）

1. 执行 task update {task_id} --status=verify
2. 调用 Agent("task:verify")，传入 task_id、context_file、align_file
3. verify 返回六维评分（项目现状符合度 / 风格一致性 / 需求符合度 / 实现完备性 / 任务偏离度 / 范围越界度），根据总分判定：
   • total_score ≥ 8.0 → 转步骤 6
   • total_score 6.0-7.9 → 通过 AskUserQuestion 展示评分明细，让用户决定通过或继续迭代
   • total_score < 6.0 → 自动进入下一轮迭代，转步骤 5a，携带 low_dimensions 作为失败原因

步骤 5a：adjust（调整修正）

1. 执行 task update {task_id} --status=adjust
2. 调用 Agent("task:adjust")，传入 task_id、verify_result
3. 根据返回的 status 路由：
   • "上下文缺失" → 转步骤 2a
   • "需求偏差" → 先清除 align.json 中的 user_confirmed（执行下方命令），然后转步骤 2 重新对齐

# 清除旧确认状态，强制 align 重新向用户确认
CLAUDE_PROJECT_DIR="$(pwd)" python3 -c "
import json, os
p = '.lazygophers/tasks/{task_id}/align.json'
if os.path.exists(p):
    d = json.load(open(p)); d['user_confirmed'] = False; json.dump(d, open(p,'w'), indent=2, ensure_ascii=False)
"

• "重新计划" → 转步骤 3
• "放弃" → 转步骤 6

步骤 6：done（完成）

1. 调用 Skill("task:done")，传入 task_id
2. 执行 task clean {task_id} --force 清理任务数据
3. 流程结束

项目根路径

所有阶段必须在用户的项目根目录中工作，即 $(pwd) 的值。 在步骤 1 初始化时记录 project_root = $(pwd)，后续各阶段的文件操作、搜索、工具调用都必须限定在此目录内。

各阶段调用参数参考

align:   Skill("task:align",   env={task_id, project_root, context_file, adjust_result})
explore: Agent("task:explore", env={task_id, project_root, align_feedback, adjust_result})
plan:    Agent("task:plan",    env={task_id, project_root, context_file, task_align_file, adjust_result})
exec:    Skill("task:exec",    env={task_id, project_root, context_file, task_file})
verify:  Agent("task:verify",  env={task_id, project_root, context_file, task_align_file})
adjust:  Agent("task:adjust",  env={task_id, project_root, verify_result, context_file, task_align_file})
done:    Skill("task:done",    env={task_id, project_root})

文件路径（相对于 project_root）：

• context_file: .lazygophers/tasks/{task_id}/context.json
• task_align_file: .lazygophers/tasks/{task_id}/align.json
• task_file: .lazygophers/tasks/{task_id}/task.json

用户中断

用户有新的中断语义输入时，调用 Skill("task:done") 清理当前任务。

状态转换规则

| 从 | 到 | 条件 | |---|---|------| | pending | align | 任务创建 | | align | explore | 上下文缺失 | | explore | align | 探索完成 | | align | plan | 对齐完成 | | plan | exec | 规划确认 | | plan | explore | 上下文缺失 | | exec | verify | 执行完成 | | verify | done | 校验通过 | | verify | adjust | 校验失败 | | adjust | explore | 上下文缺失 | | adjust | align | 需求偏差 | | adjust | plan | 重新计划 | | adjust | done | 放弃 | | cancel | done | 取消完成 |