yixiong-claude-marketplace/plugins/huanxi/skills/huanxi-task/references/task-create.md

创建任务（+create）

⚠️ 参数细节以 MCP task_create 的 docstring 为准，本文档仅做工作流引导。

必填信息收集

在调用 task_create 前，引导用户提供：

字段	必填	说明
module_id	✅	所属模块 UUID（从缓存解析名字 → ID）
title	✅	任务标题（简洁明了）
description	可选	任务详情、背景、验收标准（Markdown）
end_date	可选	截止日期（YYYY-MM-DD 格式，字段名是 end_date，不是 due_date）
priority	可选	low / medium / high / critical，默认 medium（没有 urgent）
status	可选	not_started（默认）/ in_progress
parent_task_id	可选	父任务 UUID，传此字段即为子任务
assignee_ids	可选	执行人 user_id 列表，可在创建时一并传入（无需再单独调 task_set_assignees）

---

执行步骤

Step 1: 解析模块名 → module_id
  → Read ~/.claude/huanxi-cache/modules.json
  → 模糊匹配模块名（详见 huanxi-org resolve-ids.md）

Step 2: [若用户提到执行人] 解析人名 → user_id（user 对象的 id 字段）
  → Read ~/.claude/huanxi-cache/users.json
  → 未命中 → mcp__huanxi__user_list(name=<人名>) → 追加写缓存

Step 3: 创建任务（推荐一次性把执行人也带上）
  → mcp__huanxi__task_create(
      module_id     = "<模块ID>",
      title         = "任务标题",
      description   = "...",         ← 可选
      end_date      = "YYYY-MM-DD",  ← 可选；字段名 end_date
      priority      = "medium",      ← 可选；low/medium/high/critical
      status        = "not_started", ← 可选；默认 not_started
      assignee_ids  = ["<user_id>"]  ← 可选；若 Step 2 有解析到，建议一并传入
    )
  → 返回：task_id

Step 4: [仅当 Step 3 未传 assignee_ids 时] 单独设置执行人
  → 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>"   ← 传此字段即为子任务
)

---

字段名速查（避免漂移）

概念	正确字段名	错误写法
截止日期	end_date	due_date
紧急优先级	critical	urgent
未开始状态	not_started	todo
父任务 ID	parent_task_id	parent_id（后端 body 内是 parent_id，但 MCP 参数是 parent_task_id）