chore: sync before memory update
This commit is contained in:
SkyJourney
@@ -0,0 +1,91 @@
|
||||
---
|
||||
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：更新任务
|
||||
|
||||
```
|
||||
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 整数
|
||||
status? : "in_progress" | "done" | "todo",
|
||||
due_date? : "YYYY-MM-DD",
|
||||
priority? : "low" | "medium" | "high"
|
||||
})
|
||||
|
||||
Step 4: 告知更新结果
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## +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
|
||||
@@ -0,0 +1,69 @@
|
||||
# 创建任务（+create）
|
||||
|
||||
## 必填信息收集
|
||||
|
||||
在调用 `task_create` 前，引导用户提供：
|
||||
|
||||
| 字段 | 必填 | 说明 |
|
||||
|------|------|------|
|
||||
| `module_id` | ✅ | 所属模块（从缓存解析名字 → ID） |
|
||||
| `title` | ✅ | 任务标题（简洁明了）|
|
||||
| `description` | 可选 | 任务详情、背景、验收标准 |
|
||||
| `due_date` | 可选 | 截止日期（YYYY-MM-DD 格式）|
|
||||
| `priority` | 可选 | `low` / `medium` / `high` / `urgent`，默认 medium |
|
||||
| `assignee_ids` | 可选 | 执行人（从缓存解析人名 → user_id）|
|
||||
|
||||
---
|
||||
|
||||
## 执行步骤
|
||||
|
||||
```
|
||||
Step 1: 解析模块名 → module_id
|
||||
→ Read ~/.claude/huanxi-cache/modules.json
|
||||
→ 模糊匹配模块名（详见 huanxi-org resolve-ids.md）
|
||||
|
||||
Step 2: [若用户提到执行人] 解析人名 → user_id
|
||||
→ Read ~/.claude/huanxi-cache/users.json
|
||||
→ 未命中 → mcp__huanxi__user_list(name=<人名>) → 追加写缓存
|
||||
|
||||
Step 3: 创建任务
|
||||
→ mcp__huanxi__task_create(
|
||||
module_id = "<模块ID>",
|
||||
title = "任务标题",
|
||||
description = "...", ← 可选
|
||||
due_date = "YYYY-MM-DD", ← 可选
|
||||
priority = "medium" ← 可选
|
||||
)
|
||||
→ 返回：task_id
|
||||
|
||||
Step 4: 设置执行人（若 Step 2 有解析到）
|
||||
→ mcp__huanxi__task_set_assignees(
|
||||
task_id = "<刚创建的 task_id>",
|
||||
assignee_ids = ["<user_id>"]
|
||||
)
|
||||
|
||||
Step 5: 告知创建结果
|
||||
→ 展示：任务标题、所属模块、执行人、截止日、task_id
|
||||
→ 询问："是否需要进一步调整？"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 权限说明
|
||||
|
||||
用户必须是所属模块的成员（任意角色）才能创建任务。若返回 403：
|
||||
- 可能未加入该模块
|
||||
- 建议联系模块负责人添加成员，或请管理员使用 Admin MCP 操作
|
||||
|
||||
---
|
||||
|
||||
## 子任务支持
|
||||
|
||||
若需创建子任务：
|
||||
```
|
||||
mcp__huanxi__task_create(
|
||||
module_id = "<模块ID>",
|
||||
title = "子任务标题",
|
||||
parent_task_id = "<父任务ID>" ← 传此字段即为子任务
|
||||
)
|
||||
```
|
||||
@@ -0,0 +1,51 @@
|
||||
# 任务看板（+board）
|
||||
|
||||
## 查看我的任务
|
||||
|
||||
```
|
||||
Step 1: mcp__huanxi__task_list_mine()
|
||||
→ 返回我认领的所有任务（跨模块）
|
||||
|
||||
Step 2: 按状态分组展示：
|
||||
────────────────────────────────────
|
||||
📋 待处理（todo）
|
||||
· [前端开发] 完成登录页面 UI 优化 ← 截止: 04-15
|
||||
· [后端API] 接口文档更新 ← 无截止日
|
||||
|
||||
🔄 进行中（in_progress）
|
||||
· [前端开发] 接口联调 60% ← 截止: 04-20
|
||||
|
||||
✅ 已完成（done）
|
||||
· [前端开发] 初始化项目结构 100%
|
||||
────────────────────────────────────
|
||||
```
|
||||
|
||||
## 查看模块看板
|
||||
|
||||
```
|
||||
Step 1: 确认模块（从 modules.json 缓存解析）
|
||||
Step 2: mcp__huanxi__task_list_by_module(module_id)
|
||||
→ 返回该模块所有任务（含其他成员的任务）
|
||||
Step 3: 按状态分组展示，标注每个任务的执行人
|
||||
```
|
||||
|
||||
## 人员任务看板（管理视角）
|
||||
|
||||
```
|
||||
Step 1: mcp__huanxi__people_get_board()
|
||||
→ 返回团队所有成员的任务分布（数量统计）
|
||||
Step 2: 展示每人的任务负载情况（适合分配任务前参考）
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 快速过滤
|
||||
|
||||
用户常见需求：
|
||||
|
||||
| 场景 | 做法 |
|
||||
|------|------|
|
||||
| "我今天要做什么" | task_list_mine() → 过滤 status=in_progress + 截止日临近 |
|
||||
| "某个模块的任务" | task_list_by_module(module_id) |
|
||||
| "即将到期的任务" | task_list_mine() → 筛选 due_date ≤ 今日+3天 |
|
||||
| "团队任务分布" | people_get_board() |
|
||||
Reference in New Issue
Block a user