task-management

任务管理技能

用途：通过原子化任务拆分、依赖关系解析和进度监控，跟踪、管理并验证功能实现。

---

我能做什么

我提供命令行界面，用于管理 TaskManager 子 Agent 创建的任务拆分。我可以帮助你：

• 跟踪进度 - 查看所有功能及其子任务的状态
• 查找下一步任务 - 显示符合执行条件的任务（依赖已满足）
• 识别受阻任务 - 查看哪些任务受阻以及原因
• 管理完成状态 - 标记已完成的子任务并添加摘要
• 验证完整性 - 检查 JSON 文件和依赖树

---

如何使用

快速开始

# Show all task statuses
bash .opencode/skills/task-management/router.sh status

# Show next eligible tasks
bash .opencode/skills/task-management/router.sh next

# Show blocked tasks
bash .opencode/skills/task-management/router.sh blocked

# Mark a task complete
bash .opencode/skills/task-management/router.sh complete <feature> <seq> "summary"

# Validate all tasks
bash .opencode/skills/task-management/router.sh validate

命令参考

命令	描述
status [feature]	显示所有功能或指定功能的任务状态摘要
next [feature]	显示符合执行条件的下一步任务（依赖已满足）
parallel [feature]	显示可并行执行且已准备就绪的任务
deps <feature> <seq>	显示指定子任务的依赖树
blocked [feature]	显示受阻任务及原因
complete <feature> <seq> "summary"	将子任务标记为已完成并添加摘要
validate [feature]	验证 JSON 文件和依赖关系
help	显示帮助信息

---

示例

查看整体进度

$ bash .opencode/skills/task-management/router.sh status

[my-feature] My Feature Implementation
  Status: active | Progress: 45% (5/11)
  Pending: 3 | In Progress: 2 | Completed: 5 | Blocked: 1

查找下一步任务

$ bash .opencode/skills/task-management/router.sh next

=== Ready Tasks (deps satisfied) ===

[my-feature]
  06 - Implement API endpoint [sequential]
  08 - Write unit tests [parallel]

标记为已完成

$ bash .opencode/skills/task-management/router.sh complete my-feature 05 "Implemented authentication module"

✓ Marked my-feature/05 as completed
  Summary: Implemented authentication module
  Progress: 6/11

检查依赖关系

$ bash .opencode/skills/task-management/router.sh deps my-feature 07

=== Dependency Tree: my-feature/07 ===

07 - Write integration tests [pending]
  ├── ✓ 05 - Implement authentication module [completed]
  └── ○ 06 - Implement API endpoint [in_progress]

验证所有内容

$ bash .opencode/skills/task-management/router.sh validate

=== Validation Results ===

[my-feature]
  ✓ All checks passed

---

架构

.opencode/skills/task-management/
├── SKILL.md                          # This file
├── router.sh                         # CLI router (entry point)
└── scripts/
    └── task-cli.ts                   # Task management CLI implementation

---

任务文件结构

任务存储在项目根目录下的 .tmp/tasks/ 中：

.tmp/tasks/
├── {feature-slug}/
│   ├── task.json                     # Feature-level metadata
│   ├── subtask_01.json               # Subtask definitions
│   ├── subtask_02.json
│   └── ...
└── completed/
    └── {feature-slug}/               # Completed tasks

task.json 架构

{
  "id": "my-feature",
  "name": "My Feature",
  "status": "active",
  "objective": "Implement X",
  "context_files": ["docs/spec.md"],
  "reference_files": ["src/existing.ts"],
  "exit_criteria": ["Tests pass", "Code reviewed"],
  "subtask_count": 5,
  "completed_count": 2,
  "created_at": "2026-01-11T10:00:00Z",
  "completed_at": null
}

subtask_##.json 架构

{
  "id": "my-feature-05",
  "seq": "05",
  "title": "Implement authentication",
  "status": "pending",
  "depends_on": ["03", "04"],
  "parallel": false,
  "suggested_agent": "coder-agent",
  "context_files": ["docs/auth.md"],
  "reference_files": ["src/auth-old.ts"],
  "acceptance_criteria": ["Login works", "JWT tokens valid"],
  "deliverables": ["auth.ts", "auth.test.ts"],
  "started_at": null,
  "completed_at": null,
  "completion_summary": null
}

---

与 TaskManager 集成

TaskManager 子 Agent 会使用此格式创建任务文件。将任务委派给 TaskManager 时：

task(
  subagent_type="TaskManager",
  description="Implement feature X",
  prompt="Break down this feature into atomic subtasks..."
)

TaskManager 会创建：

1. .tmp/tasks/{feature}/task.json - 功能元数据
2. .tmp/tasks/{feature}/subtask_XX.json - 单个子任务

然后，你可以使用此技能跟踪和管理进度。

---

关键概念

1. 依赖关系解析

子任务可以依赖其他子任务。只有在所有依赖项均已完成时，任务才会“就绪”。

2. 并行执行

设置 parallel: true，表示子任务可以与其他依赖已满足的并行任务同时执行。

3. 状态跟踪

• pending - 尚未开始，正在等待依赖项
• in_progress - 正在处理中
• completed - 已完成并附有摘要
• blocked - 明确受阻（并非正在等待依赖项）

4. 退出标准

每项功能都有 exit_criteria，必须满足这些条件后才能将功能标记为已完成。

5. 验证规则

validate 命令会对任务文件执行全面检查：

任务级验证：

• ✅ 功能对应的 task.json 文件存在
• ✅ 任务 ID 与功能 slug 一致
• ✅ task.json 中的子任务数量与实际子任务文件数量一致
• ✅ 所有必填字段均已填写

子任务级验证：

• ✅ 所有子任务 ID 均以功能名称开头（例如，“my-feature-01”）
• ✅ 序号唯一且格式正确（01、02 等）
• ✅ 所有依赖项均引用现有子任务
• ✅ 不存在循环依赖
• ✅ 每个子任务均定义了验收标准
• ✅ 每个子任务均指定了交付内容
• ✅ 状态值有效（pending、in_progress、completed、blocked）

依赖关系验证：

• ✅ 所有 depends_on 引用均指向现有子任务
• ✅ 任务不会依赖自身
• ✅ 不存在循环依赖链
• ✅ 依赖关系图无环

定期运行 validate，及早发现问题：

bash .opencode/skills/task-management/router.sh validate my-feature

6. 上下文和参考文件

• context_files - 需要遵循的标准、惯例和指南
• reference_files - 可查看或作为构建基础的现有项目文件

---

工作流集成

与 TaskManager 子 Agent 配合

1. TaskManager 创建任务 → 生成 .tmp/tasks/{feature}/ 结构
2. 你使用此技能进行跟踪 → 使用 status、next、blocked 监控进度
3. 你标记任务已完成 → 使用 complete 命令并提供摘要
4. 技能验证完整性 → 使用 validate 检查一致性

与其他子 Agent 配合

执行 Agent（CoderAgent、TestEngineer 等）会执行子任务并报告完成情况。使用此技能来：

• 使用 next 查找下一个可执行任务
• 使用 blocked 检查哪些事项阻碍了进度
• 使用 validate 验证任务定义

---

常见工作流

开始一项新功能

# 1. TaskManager creates the task structure
task(subagent_type="TaskManager", description="Implement feature X", ...)

# 2. Check what's ready
bash .opencode/skills/task-management/router.sh next

# 3. Delegate first task to working agent
task(subagent_type="CoderAgent", description="Implement subtask 01", ...)

跟踪进度

# Check overall status
bash .opencode/skills/task-management/router.sh status my-feature

# See what's next
bash .opencode/skills/task-management/router.sh next my-feature

# Check what's blocked
bash .opencode/skills/task-management/router.sh blocked my-feature

完成任务

# After working agent finishes
bash .opencode/skills/task-management/router.sh complete my-feature 05 "Implemented auth module with JWT support"

# Check progress
bash .opencode/skills/task-management/router.sh status my-feature

# Find next task
bash .opencode/skills/task-management/router.sh next my-feature

验证所有内容

# Validate all tasks
bash .opencode/skills/task-management/router.sh validate

# Validate specific feature
bash .opencode/skills/task-management/router.sh validate my-feature

---

提示与最佳实践

1. 使用有意义的摘要

标记任务已完成时，请提供清晰的摘要：

# Good
complete my-feature 05 "Implemented JWT authentication with refresh tokens and error handling"

# Avoid
complete my-feature 05 "Done"

2. 开始前检查依赖项

# See what a task depends on
bash .opencode/skills/task-management/router.sh deps my-feature 07

3. 找出可并行处理的工作

# Find tasks that can run in parallel
bash .opencode/skills/task-management/router.sh parallel my-feature

4. 定期验证

# Validate regularly to catch issues early
bash .opencode/skills/task-management/router.sh validate

---

故障排除

“未找到 task-cli.ts”

确保你是在项目根目录下运行，或者 router.sh 能找到它。

“未找到任务”

运行 status，查看是否已创建任务。请先使用 TaskManager 创建任务。

“依赖项未满足”

使用 deps 检查依赖关系树，查看是什么阻碍了该任务。

“验证失败”

运行 validate 查看具体问题，然后检查 .tmp/tasks/ 中的 JSON 文件。

---

文件位置

• 技能：.opencode/skills/task-management/
• 路由器：.opencode/skills/task-management/router.sh
• CLI：.opencode/skills/task-management/scripts/task-cli.ts
• 任务：.tmp/tasks/（由 TaskManager 创建）
• 文档：.opencode/skills/task-management/SKILL.md（此文件）

---

任务管理技能 - 跟踪、管理并验证你的功能实现！