chore: sync before memory update

2026-05-01 12:04:12 +08:00
parent 1b3ae007ee
commit 0c46ed0306
22 changed files with 1850 additions and 20 deletions
@@ -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() |