Files

T

SkyJourneyandClaude Sonnet 5 600c0dd323 feat: 寰汐插件随 v1.0.0 生产切换升级到 v2 技能组，新增独立管理端插件

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

2026-08-22 02:14:34 +08:00

2.7 KiB

Raw Blame History

name, description

name	description
huanxi-lookup	寰汐人员与检索：查人、全局搜索、按标签反查、团队任务看板。当用户说「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

用户说「刷新一下」「组织变了」时，删掉对应文件重新拉取即可。

2.7 KiB Raw Blame History