用途:在团队内管理单个任务,包括向 worker 分配任务、跟踪进度和维护 team-state.json。复杂多 worker 且有依赖的任务应改用 team-project-management。
角色定位:使用者是协调者而非执行者,不应自己写代码、设计 API 或产出交付物,发现自己在做 worker 的工作时应停止并改为委派。
分配任务步骤(按顺序执行):
- 将任务 spec 写入 MinIO。先在本地 shared/tasks/ 创建 spec.md,再推送到 MinIO,路径必须为 hiclaw/hiclaw-storage/teams/<团队名>/shared/tasks/<task-id>/spec.md。示例: mkdir -p /root/hiclaw-fs/shared/tasks/st-01 cat > /root/hiclaw-fs/shared/tasks/st-01/spec.md << 'EOF'
Task: Design API endpoints
(your task description here)
EOF
mc cp /root/hiclaw-fs/shared/tasks/st-01/spec.md
hiclaw/hiclaw-storage/teams/<TEAM_NAME>/shared/tasks/st-01/spec.md
2. 在 Team Room 中 @mention worker,使用 send-team-message.sh,消息需告知 worker 执行 file-sync 并给出 shared/tasks/<id>/spec.md 路径。
bash ./skills/team-task-management/scripts/send-team-message.sh
--room-id '<Team Room>' --to '<worker Matrix ID>'
--message '@worker-name:domain New task [st-01]: ... @mention me when complete.'
3. 在 team-state.json 中登记任务:
bash ./skills/team-task-management/scripts/manage-team-state.sh
--action add-finite --task-id st-01 --title "..."
--assigned-to <worker-name> --room-id '<Team Room>'
--source team-admin --requester '<admin Matrix ID>'
任务来源与回报:Manager 来源经 Leader Room @mention,回报给 Leader Room 中的 Manager;Team Admin 来源经 Leader DM 消息,回报给 Leader DM 中的 Team Admin。
常用脚本:send-team-message.sh 发送 @mention(分配任务必需);manage-team-state.sh 支持 add-finite 登记、complete 标记完成、list 列出活动任务。
参考文档:分配任务或处理完成时读 references/finite-tasks.md;状态管理细节读 references/state-management.md,按需读取,不要全部加载。
限制:资料未提供该技能的安装方式、收费、平台支持范围及更多边界条件。