task-orchestration

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Task Orchestration Skill

任务编排Skill

This skill automatically activates when working with task lists and implementation. It enforces documentation-first development, systematic execution, and quality assurance.
当处理任务列表与功能开发时,该Skill会自动激活。它强制推行文档优先的开发模式、系统化执行流程与质量保障机制。

Core Principles

核心原则

Documentation-First Enforcement

文档优先执行原则

NO CODING WITHOUT DOCUMENTATION REVIEW
The FIRST sub-task for any coding task MUST be documentation review:
  1. Review relevant API/framework documentation
  2. Share key findings before implementation
  3. Identify best practices and anti-patterns
  4. Reference documentation in implementation
未完成文档审查,禁止编码
任何编码任务的首个子任务必须是文档审查:
  1. 查阅相关API/框架文档
  2. 在开发前分享关键发现
  3. 识别最佳实践与反模式
  4. 在开发中引用文档内容

Sequential Execution Protocol

顺序执行协议

  1. One task at a time - Only one task in_progress
  2. Complete all sub-tasks before moving to parent
  3. User confirmation required - Wait for "yes" or "y" before next task
  4. Immediate file updates - Update markdown checkboxes immediately
  1. 一次处理一个任务 - 仅允许一个任务处于进行中
  2. 完成所有子任务后再推进父任务
  3. 需用户确认 - 等待用户回复“yes”或“y”后再启动下一个任务
  4. 即时更新文件 - 立即更新Markdown复选框状态

Automatic Behaviors

自动行为

1. Initialize Task Tracking

1. 初始化任务追踪

  • Read task list file completely
  • Use TodoWrite to track all tasks
  • Identify dependencies between tasks
  • Verify required resources
  • 完整读取任务列表文件
  • 使用TodoWrite追踪所有任务
  • 识别任务间的依赖关系
  • 验证所需资源是否齐全

2. Execute Tasks Systematically

2. 系统化执行任务

1.0 Parent Task
  1.1 [FIRST] Documentation Review ← MANDATORY
  1.2 Implementation step
  1.3 Testing step
2.0 Next Parent Task
  ...
1.0 父任务
  1.1 [首要任务] 文档审查 ← 强制要求
  1.2 开发步骤
  1.3 测试步骤
2.0 下一个父任务
  ...

3. Update Progress Mechanically

3. 机械性更新进度

After EACH task completion:
  1. Update TodoWrite status to "completed"
  2. Change
    [ ]
    to
    [x]
    in markdown file
  3. Update "Relevant Files" section
  4. Report completion status
完成每个任务后:
  1. 将TodoWrite中的状态更新为“已完成”
  2. 将Markdown文件中的
    [ ]
    修改为
    [x]
  3. 更新“相关文件”板块
  4. 汇报完成状态

4. Communicate Progress

4. 进度沟通

📚 Starting task 1.1: Review documentation
   - Reviewing [framework] best practices
   - Key findings: ...

🚀 Starting task 1.2: Implementation
   - Following patterns from docs
   - Creating files...

✅ Completed task 1.2
   - File created: path/to/file.js
   - Tests passing

📋 Next: 1.3 Add tests
   Proceed? (y/n)
📚 开始执行任务1.1:审查文档
   - 正在查阅[框架]最佳实践
   - 关键发现:...

🚀 开始执行任务1.2:功能开发
   - 遵循文档中的模式
   - 正在创建文件...

✅ 完成任务1.2
   - 创建的文件:path/to/file.js
   - 测试通过

📋 下一项:1.3 添加测试
   是否继续?(y/n)

Quality Assurance Checklist

质量保障检查清单

Before marking any task complete:
在标记任务完成前,需确认:

Documentation Compliance

文档合规性

  • Documentation was reviewed FIRST
  • Implementation follows documented patterns
  • API/framework patterns correctly applied
  • 已优先完成文档审查
  • 开发遵循文档中规定的模式
  • 正确应用API/框架模式

Code Quality

代码质量

  • Follows project conventions
  • No linting errors
  • Proper error handling
  • Comments where necessary
  • 符合项目规范
  • 无代码检查错误
  • 具备完善的错误处理机制
  • 在必要位置添加注释

Testing

测试

  • Unit tests written and passing
  • Manual testing completed
  • Edge cases considered
  • 已编写并通过单元测试
  • 完成手动测试
  • 已考虑边缘情况

Error Handling Protocol

错误处理协议

When encountering issues:
⚠️ Issue encountered in task 1.2:
   - Problem: [description]
   - Proposed solution: [approach]
   - Estimated impact: [time/scope]

   Proceed with solution? (y/n)
遇到问题时:
⚠️ 在任务1.2中遇到问题:
   - 问题描述:[详情]
   - 提议解决方案:[方案]
   - 预估影响:[时间/范围]

   是否采用该解决方案?(y/n)

New Task Discovery

新任务发现

When new tasks are discovered during implementation:
📌 New task discovered:
   - Task 1.4: [description]
   - Reason: [why this is needed]
   - Priority: [high/medium/low]

   Add to current sprint? (y/n)
  1. Add to task list with [NEW] tag
  2. Update TodoWrite
  3. Get user confirmation
在开发过程中发现新任务时:
📌 发现新任务:
   - 任务1.4:[描述]
   - 原因:[必要性说明]
   - 优先级:[高/中/低]

   是否添加至当前迭代?(y/n)
  1. 在任务列表中添加带有[NEW]标签的任务
  2. 更新TodoWrite
  3. 获取用户确认