docs(huanxi-skills): 修正工具调用描述与参数出入,补充工具定义优先规范
参数/描述修正: - report-submit.md:report_submit → report_submit_item - huanxi-shared 全局约定:同步修正 report_submit 工具名 - weekly-draft.md:多模块循环示例 week → week_number(weekly_report_save 正确参数名) - 工具索引补全参数:task_list_mine/people_get_board/user_list/weekly_report_submit - resolve-ids.md:澄清 feishu_user_id 与 feishu_open_id 是两个不同字段 新增工具调用规范: - huanxi-shared 全局约定第 6 条:以 MCP 工具实际定义为准 - 5 个 skill 文件前置区域统一加 ⚠️ 提示引用第 6 条 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Sonnet 4.6
parent
bd960dbddd
commit
8289fa6060
@@ -82,14 +82,14 @@ workdays.json → Infinity(按 date key,已查过的不再查)
|
||||
|------|------|------|
|
||||
| `module_list(my_role?)` | 列出我参与的模块 | → `modules.json`(24h)|
|
||||
| `module_get(module_id)` | 获取模块详情(含成员) | 不缓存 |
|
||||
| `user_list(name?)` | 搜索组织用户 | → `users.json`(24h)|
|
||||
| `user_list(name?, department_id?, is_active?, limit?)` | 搜索组织用户 | → `users.json`(24h)|
|
||||
| `org_get_tree()` | 获取组织架构树 | 不缓存 |
|
||||
| `people_get_board()` | 人员任务看板 | 不缓存 |
|
||||
| `people_get_board(user_id?, module_id?, date?)` | 人员任务看板(不传则全员;传 user_id 只看该人) | 不缓存 |
|
||||
|
||||
### 任务管理
|
||||
| 工具 | 用途 | 缓存 |
|
||||
|------|------|------|
|
||||
| `task_list_mine()` | 我认领的任务 | 不缓存 |
|
||||
| `task_list_mine(status?, module_id?, priority?, snapshot_active?)` | 我认领的任务 | 不缓存 |
|
||||
| `task_list_by_module(module_id)` | 模块下所有任务 | 不缓存 |
|
||||
| `task_get(task_id)` | 任务详情 | 不缓存 |
|
||||
| `task_create(...)` | 创建任务 | — |
|
||||
@@ -120,7 +120,7 @@ workdays.json → Infinity(按 date key,已查过的不再查)
|
||||
| `weekly_report_get(year, week)` | 获取指定 ISO 周的周报 |
|
||||
| `weekly_report_get_batch(year, week, module_ids)` | 批量获取多模块周报 |
|
||||
| `weekly_report_save(module_id, year, week_number, content?, next_week_plan?)` | 保存周报草稿 |
|
||||
| `weekly_report_submit(module_id)` | 提交周报 |
|
||||
| `weekly_report_submit(module_id, year?, week_number?)` | 提交周报(不传 year/week_number 默认提交当周) |
|
||||
| `weekly_report_withdraw(module_id, year?, week_number?)` | 撤回周报 |
|
||||
|
||||
### 系统与 LLM
|
||||
@@ -134,8 +134,9 @@ workdays.json → Infinity(按 date key,已查过的不再查)
|
||||
|
||||
## 全局约定
|
||||
|
||||
1. **提交前必须确认**:`report_submit`、`leader_report_submit`、`weekly_report_submit` 执行前必须向用户展示内容并等待明确确认,禁止自动提交。
|
||||
1. **提交前必须确认**:`report_submit_item`、`leader_report_submit`、`weekly_report_submit` 执行前必须向用户展示内容并等待明确确认,禁止自动提交。
|
||||
2. **非工作日不强制**:检测到非工作日时,告知用户并询问是否仍要填写,不得直接中断流程。
|
||||
3. **缓存优先**:执行任何需要 module_id / user_id 的操作前,先读缓存;缓存未命中或过期才调 MCP。
|
||||
4. **ISO 周数**:周报的 `year` 字段存 ISO year(`date.isocalendar()[0]`),不是日历年。12 月底 / 1 月初注意跨年。
|
||||
5. **task_set_assignees 幂等**:设置执行人使用此工具(幂等),不要用 task_update 的 assignee 字段追加。
|
||||
6. **工具调用以 MCP 定义为准**:调用任何 `mcp__huanxi__*` 工具前,**必须以该工具在 MCP Server 中实际注册的参数名和类型为准**,本文档及各 skill 中的调用示例仅供工作流引导,不得作为参数的唯一依据。如果示例与工具实际定义有出入,以工具定义优先。
|
||||
|
||||
Reference in New Issue
Block a user