关于 task-planner
Task Planner 是一项帮助 Agent 将模糊或大型请求拆解为有顺序、有负责人且可验证计划的技能。它强调小型垂直切片、依赖与风险识别,并可将复杂计划以 Canvas 卡片呈现。
主要功能
- 01整理问题、假设与待确认项
- 02拆分为可独立合并的步骤
- 03标注依赖、优先级与风险
- 04为多 Agent 工作明确交付约定
- 05生成带状态的 Canvas 计划卡
- 06汇报进度与验证结果
适用场景
- 01将大型功能请求拆为实施步骤
- 02规划多 Agent 并行工作
- 03为复杂依赖链展示计划进度
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ s-hiraoku/ synapse-a2a --skill task-planner安装后在 Claude Code 中输入/task-planner确认已加载。
详细介绍
任务规划器
此技能可帮助你将含糊或规模较大的请求转化为清晰、有序且明确责任归属和验证方式的计划。
要产出的内容
- 简短的问题陈述
- 假设和待解答的问题
- 包含可衡量成果的分步计划
- 风险以及回滚/控制措施
- 测试和验证步骤
分解技巧
将工作拆分为精简的纵向切片:
- 每个切片都应能独立合并
- 每个切片都应包含测试或验证
- 优先选择能减少不确定性的最小单元
常见的切片类型:
- 规范测试(锁定需求、CLI 标志和边缘情况)
- 实现变更(小型、隔离)
- 文档更新
- 可观测性和可追溯性改进
依赖关系和优先级规则
- 首先识别阻塞因素(缺少 API、测试失败、权限问题)。
- 按“解除其他任务阻塞”和“减少不确定性”排序。
- 对于多 Agent 协作,保持接口稳定,并为每个切片定义契约(输入/输出)。
多 Agent 任务分配
委派任务时:
- 明确指定交付内容(文件、测试、输出格式)
- 明确指定约束(不提交代码、分支限制、时间限制)
- 明确指定验收测试(必须通过哪些测试)
委派消息示例:
Please write tests for <feature>.
Constraints:
- Do not change implementation yet
- Use pytest
Acceptance:
- Tests fail before implementation
- Tests cover edge cases: <...>
计划输出
计划卡片输出(Canvas)
对于带有 Mermaid DAG 可视化和步骤级状态跟踪的可视化计划, 请向 Canvas 发布计划卡片:
# Post plan card with Mermaid DAG and step list
synapse canvas plan '{"plan_id":"plan-auth","status":"proposed","mermaid":"graph TD; A[Tests]-->B[Impl]-->C[Review]","steps":[{"id":"s1","subject":"Write auth tests","agent":"Tester","status":"pending"},{"id":"s2","subject":"Implement auth","agent":"Impl","status":"pending","blocked_by":["s1"]},{"id":"s3","subject":"Review","agent":"Tester","status":"pending","blocked_by":["s2"]}]}' --title "Auth Plan"
当分解过程需要在 Canvas 仪表板中向团队展示时,计划卡片会很有用。对于包含 3 个以上步骤或依赖链复杂、适合用 DAG 可视化的计划,请使用计划卡片。
个人微步骤 TodoList
在单个任务中,使用 TodoList 跟踪你自己的微步骤。 TodoList 条目应细化到每个编码步骤一项:
- 为 添加失败测试
- 在测试保护下实现
- 运行针对性测试
- 更新文档
- 运行完整测试套件
进度报告
在所有沟通中明确更新状态:
- 已完成:
"编写 auth 测试已完成——4 项测试通过" - 下一步:
"开始实现 auth 模块;已确认测试" - 受阻:
"集成测试正在等待——实现尚未完成"
评论
支持 Markdown