SkyJourneyandClaude Sonnet 5
600c0dd323
huanxi 插件的技能内容从 v1 全面替换为 v2（huanxi-org/huanxi-weekly 等 v1 专属技能下线，新增 huanxi-issue/huanxi-lookup/huanxi-meeting），MCP 连接与 Token 获取方式同步更新为个人中心自助生成。 新增独立的 huanxi-admin 插件（管理端 4 个技能，hxa_ Token，普通员工无需 安装），此前一直卡在"v2 未部署到生产域名前不推送"这条约束，今晚寰汐 v1.0.0 生产切换完成后条件满足。 产物由 huanxi-menagement 仓库 skills/sync_marketplace.py 生成，技能源码 单一真相在该仓库的 skills/，本仓库只接收产物、不手工编辑。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018xxRKMuiGR4wYT3QbwCpDc
87 lines
2.7 KiB
Markdown
87 lines
2.7 KiB
Markdown
---
|
|
name: huanxi-lookup
|
|
description: "寰汐人员与检索：查人、全局搜索、按标签反查、团队任务看板。当用户说「XX是谁」「搜一下」「有哪些人」「团队在忙什么」时使用。"
|
|
---
|
|
|
|
# 寰汐人员与检索
|
|
|
|
**前置：先读 `huanxi-shared`。**
|
|
|
|
本技能主要有两个职责：**把名字解析成 ID** 供其他技能使用，以及**维护缓存**。
|
|
|
|
---
|
|
|
|
## 解析 ID
|
|
|
|
几乎所有写操作都要 ID。顺序是：先读缓存，未命中再调工具，拿到后写回缓存。
|
|
|
|
```
|
|
user_search(q="冯普") 姓名模糊搜 → 拿 id
|
|
user_search(ids=[...]) 已知 id 批量取详情
|
|
module_query(role?) 我参与的模块（带 my_role）
|
|
```
|
|
|
|
> 组织架构树（`org_tree`）已随 M16 身份体系替换下线——公司改用蚁熊通行证，
|
|
> 它不提供部门信息。要按「一组人」找人，用 `user_search` 按姓名搜，
|
|
> 或到网页后台看用户标签。
|
|
|
|
`user_search` 结果里标注了 `offboarding`（离职观察期，不宜再派新活）与 `inactive`
|
|
（已停用）——把人派给这两类之前先提醒用户。
|
|
|
|
---
|
|
|
|
## 全局检索
|
|
|
|
```
|
|
search(q="关键词") 一次返回六组：任务/模块/用户/标签/会议/议题，各组带总数
|
|
```
|
|
|
|
不确定某个东西叫什么、在哪个模块时先用它定位，拿到 id 再调对应的 `*_get`。
|
|
比逐个域去 query 快得多。
|
|
|
|
```
|
|
tag_related(tag_id) 按标签反查五个域的关联内容
|
|
```
|
|
|
|
标签是**平级横切索引**，同一个标签可以贴在用户/模块/任务/会议/议题任何一种上。
|
|
这个工具回答「打了这个标签的所有东西都有哪些」。
|
|
|
|
---
|
|
|
|
## 公告与报告
|
|
|
|
```
|
|
announcement_query(kind?, series_slug?, period_key?, ids?)
|
|
```
|
|
|
|
统一入口，覆盖系统周报、周度复盘、版本发布、运维简报、人工公告。
|
|
**只返回你有权看的**——报告按受众分档（全员/管理层/老板/本人），过滤在服务端完成，
|
|
查不到某条不代表它不存在。
|
|
|
|
想看某条内置报告的历次期次，传 `series_slug`；想要具体某期，加 `period_key`。
|
|
|
|
---
|
|
|
|
## 团队看板
|
|
|
|
```
|
|
people_board() 按人聚合的跨模块任务负载，**含 0 任务的人**
|
|
```
|
|
|
|
「我团队现在都在忙什么」「谁比较闲」用它，比逐个 `task_query` 高效得多。
|
|
含 0 任务的人是有意的——那正是「谁完全没有负载」这个问题的答案。
|
|
|
|
---
|
|
|
|
## 缓存维护
|
|
|
|
本技能负责的三份缓存（详见 `huanxi-shared`）：
|
|
|
|
| 文件 | 来源 | TTL |
|
|
|---|---|---|
|
|
| `personal/me.json` | `whoami` | 永久 |
|
|
| `personal/users.json` | `user_search` | 24h |
|
|
| `personal/my-modules.json` | `module_query` | 24h |
|
|
|
|
用户说「刷新一下」「组织变了」时，删掉对应文件重新拉取即可。
|