SkyJourneyandClaude Sonnet 4.6
8289fa6060
参数/描述修正： - report-submit.md：report_submit → report_submit_item - huanxi-shared 全局约定：同步修正 report_submit 工具名 - weekly-draft.md：多模块循环示例 week → week_number（weekly_report_save 正确参数名） - 工具索引补全参数：task_list_mine/people_get_board/user_list/weekly_report_submit - resolve-ids.md：澄清 feishu_user_id 与 feishu_open_id 是两个不同字段 新增工具调用规范： - huanxi-shared 全局约定第 6 条：以 MCP 工具实际定义为准 - 5 个 skill 文件前置区域统一加 ⚠️ 提示引用第 6 条 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
3.7 KiB
3.7 KiB
name: huanxi-task description: "寰汐任务管理：创建任务（+create）、更新任务状态/进度（+update）、查看任务看板（+board）、设置执行人（+assign）。当用户说"创建任务"、"新建任务"、"更新任务"、"看任务板"、"任务分配"时触发。"
寰汐任务管理
前置条件：先 Read ../huanxi-shared/SKILL.md（缓存规则 + TTL 策略）
⚠️ 工具调用规范：执行任何
mcp__huanxi__*调用前，以工具实际注册的参数名和类型为准，本文档示例仅供工作流引导（见 shared 全局约定第 6 条）。
Shortcuts
| 指令 | 说明 |
|---|---|
+create |
创建新任务（引导式填写） |
+update |
更新任务状态/进度/截止日 |
+board |
查看我的任务看板 |
+assign |
设置/变更任务执行人 |
+get |
查看单个任务详情 |
+create：创建任务
快速概览：
1. 确定所属模块（从 modules.json 缓存解析名字 → ID）
2. 收集任务信息（标题、描述、截止日、优先级）
3. mcp__huanxi__task_create(module_id, title, ...)
4. [可选] 设置执行人 → mcp__huanxi__task_set_assignees(task_id, [user_id])
+update：更新任务
⚠️ 参数细节以 MCP
task_update的 docstring 为准，本节仅做工作流引导。
Step 1: 确认任务 ID
→ 若用户已提供 task_id：直接使用
→ 若用户描述了任务名称：
a. mcp__huanxi__task_list_mine() 获取我的任务列表
b. 按标题关键词模糊匹配，列出候选任务供用户选择
c. 仍未找到（可能属于他人或已归档）→ 告知用户提供精确 task_id
Step 2: 展示当前任务状态，引导用户填写要修改的字段
Step 3: mcp__huanxi__task_update(task_id, {
title? : "新标题",
description? : "新描述",
progress? : 80, ← 0-100 整数
progress_before? : 60, ← 修改 progress 时必传当前值（乐观锁，防并发覆盖）
status? : "not_started" | "in_progress" | "done" | "cancelled" | "on_hold",
end_date? : "YYYY-MM-DD", ← 字段名是 end_date，不是 due_date
priority? : "low" | "medium" | "high" | "critical"
})
Step 4: 告知更新结果
⚠️ 历史踩坑：
- 字段名
due_date错误，后端为end_date - 状态值
todo错误，后端为not_started - priority 缺
critical，没有urgent - 改 progress 不传
progress_before会 409 冲突
+assign：设置执行人
Step 1: 确认任务 ID
Step 2: 解析执行人名字 → user_id（查 users.json 缓存）
→ 详见 huanxi-org references/resolve-ids.md
Step 3: mcp__huanxi__task_set_assignees(task_id, assignee_ids=[user_id, ...])
（此操作幂等：传完整列表，不是追加）
Step 4: 告知设置结果
+get：查看任务详情
Step 1: mcp__huanxi__task_get(task_id)
Step 2: 展示完整任务信息（标题/描述/状态/进度/执行人/截止日/评论数）
关键约束
- 任务创建后不自动认领：
task_create不会自动设置执行人，需要单独调用task_set_assignees - 执行人是完整列表：
task_set_assignees传入的是完整执行人 ID 列表（幂等替换），不是追加 - progress 是整数：0-100 的整数，不是小数或百分比字符串
- 模块创建权限：用户必须是模块成员（任意角色）才能在该模块创建任务，否则返回 403