Files
yixiong-claude-marketplace/plugins/huanxi/skills/huanxi-task/SKILL.md
T
SkyJourneyandClaude Opus 4.7 38beecb2d0 feat(huanxi+memcore): 全量修正 huanxi 技能描述漂移 + memcore 七项优化
- 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>
2026-06-12 19:13:21 +08:00

3.5 KiB
Raw Blame History


name: huanxi-task description: "寰汐任务管理:创建任务(+create)、更新任务状态/进度(+update)、查看任务看板(+board)、设置执行人(+assign)。当用户说"创建任务"、"新建任务"、"更新任务"、"看任务板"、"任务分配"时触发。"

寰汐任务管理

前置条件:先 Read ../huanxi-shared/SKILL.md(缓存规则 + TTL 策略)


Shortcuts

指令 说明
+create 创建新任务(引导式填写)
+update 更新任务状态/进度/截止日
+board 查看我的任务看板
+assign 设置/变更任务执行人
+get 查看单个任务详情

+create:创建任务

详见 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