SkyJourneyandClaude Opus 4.7
38beecb2d0
- huanxi: 更新 MCP URL 至 huanxi.office.yixiong-tech.com - huanxi: 修正所有技能与后端 docstring 漂移 · report items 字段表（补 module_id 必填、progress→progress_update、去除虚构 status） · weekly_report_save week→week_number · task end_date（非 due_date）、critical（非 urgent）、not_started（非 todo） · 用户/模块 ID 字段名统一为 id（非 user_id） · 所有 references 顶部声明"参数细节以 MCP docstring 为准" - memcore: 新增 memcore-shared 共享层（路径锁定 + 全局常量 + PROJECT_DIR 跨平台解析） - memcore: lint_report 增量保活（NEED-HUMAN 稳定 ID + resolved 跳过） - memcore: synonyms.md 自动登记入索引 - memcore: SYNTHESIS_THRESHOLD / LINT_STALE_*_DAYS / MULTI_HOST_WARN_DAYS 常量化 - memcore: update Phase 1 增加 Base commit 兜底，防锚点丢失雪崩 - memcore: Phase 3C 引用快扫脚本改用 grep -F + -- 兼容中文/空格 title Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
101 lines
3.5 KiB
Markdown
101 lines
3.5 KiB
Markdown
---
|
||
name: huanxi-task
|
||
description: "寰汐任务管理：创建任务（+create）、更新任务状态/进度（+update）、查看任务看板（+board）、设置执行人（+assign）。当用户说"创建任务"、"新建任务"、"更新任务"、"看任务板"、"任务分配"时触发。"
|
||
---
|
||
|
||
# 寰汐任务管理
|
||
|
||
**前置条件：先 Read `../huanxi-shared/SKILL.md`（缓存规则 + TTL 策略）**
|
||
|
||
---
|
||
|
||
## Shortcuts
|
||
|
||
| 指令 | 说明 |
|
||
|------|------|
|
||
| [`+create`](references/task-create.md) | 创建新任务（引导式填写） |
|
||
| `+update` | 更新任务状态/进度/截止日 |
|
||
| [`+board`](references/task-kanban.md) | 查看我的任务看板 |
|
||
| `+assign` | 设置/变更任务执行人 |
|
||
| `+get` | 查看单个任务详情 |
|
||
|
||
---
|
||
|
||
## +create：创建任务
|
||
|
||
详见 [references/task-create.md](references/task-create.md)
|
||
|
||
**快速概览：**
|
||
```
|
||
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
|