寰汐 v2 上线双 MCP(个人端 /mcp/ 与管理端 /admin-mcp/),两条端点是**两条独立的 信任边界**——Token 前缀不同、工具集不同、视角不同(管理端看全量、个人端只看我参与的)。 一个插件塞两套会让普通员工的客户端里出现他根本调不动的管理工具,因此拆成两个插件, 按角色各装各的。 ## huanxi(个人端,全体员工) 7 个技能:shared / report / leader / task / issue / meeting / org - 新增 `issue` `meeting`——v2 的议题域与会议域(M6v2 会议×议题解耦后的产物) - **删除 `weekly`**——v2 没有 weekly_report 表,周报已并入报告体系 - 各技能重写为**流水线定义**而非使用说明:写明工具调用顺序、ID 在步骤间怎么传、 人工确认节点落在哪。「禁止自动提交」这条 v1 已验证的硬约束保留 - 删掉 `references/` 拆分文件——v2 技能自包含 ## huanxi-admin(管理端,仅后台管理员) 4 个技能:admin-shared / admin-report / admin-module / admin-ops MCP server key 取 `huanxi-admin`(与个人端的 `huanxi` 不同名),否则两插件并存时 会键冲突。 ## 缓存目录按信任边界隔离 `~/.claude/huanxi-cache/` 下分 `personal/` `admin/` `dict/`:前两者视角不同, 混用会越权展示或数据错乱;`dict/` 与身份无关可共享。业务数据(任务/日报/会议/议题) **显式声明不缓存**——v1 没写这条,Agent 会自行决定缓存然后拿到陈旧数据。 ## 源码单一真相不在本仓库 技能源码在寰汐仓库 `skills/`,与 MCP docstring 同仓库同 commit——签名一改, 技能与工具在同一次改动里更新,从结构上消除跨仓库漂移(本仓库记忆 `feedback_plugin_dev.md` 记录的 4 类漂移覆盖全部 6 个 v1 技能,正是这个病)。 本仓库退化为**分发壳**,只接收 `python skills/sync_marketplace.py` 的产物,不手工编辑。 寰汐侧有 CI 守卫:技能里出现的每个工具名必须存在于实际注册表、个人端技能不得 指导调用管理端独有工具、不得硬编码状态字面量。 ## 本分支不合 main 插件配置的域名此刻跑的还是 v1,合进 main 会通过自动更新推给已安装用户, 他们的技能会去调 v1 上不存在的工具。合并前置条件写在 CLAUDE.md「已发布插件」节。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019Vyeia9k43dVaUFNLo8Lny
55 lines
1.8 KiB
Markdown
55 lines
1.8 KiB
Markdown
---
|
|
name: huanxi-admin-ops
|
|
description: "寰汐管理端运维与内容:提交运维简报、查公告与自动报告、全量查会议与议题。当用户说「提交运维简报」「本周系统周报」「看看有哪些议题」时使用。"
|
|
---
|
|
|
|
# 寰汐管理端 · 运维与内容
|
|
|
|
**前置:先读 `huanxi-admin-shared`。**
|
|
|
|
---
|
|
|
|
## 运维简报
|
|
|
|
```
|
|
ops_briefing_submit(content, iso_week?)
|
|
```
|
|
|
|
Markdown **原文存档,不经 AI 加工**——这是设计决策,简报的价值在于运维侧的原始记录,
|
|
加工会丢失细节。你可以帮用户组织语言,但要让他确认最终文本,不要自作主张改写后直接提交。
|
|
|
|
**同一 ISO 周重复提交是版本覆盖**:旧版本保留但不再是当前版本,公告表里那条发布记录
|
|
原地更新指向最新版。不传 `iso_week` 则用今天所在周。
|
|
|
|
⏸ 提交前把最终 Markdown 展示给用户确认。
|
|
|
|
---
|
|
|
|
## 公告与自动报告
|
|
|
|
```
|
|
announcement_query(ids?, kind?, series_slug?, period_key?)
|
|
```
|
|
|
|
统一入口,覆盖系统周报、周度复盘、版本发布、运维简报、人工公告。
|
|
|
|
- 按生命周期分类查 → `kind`
|
|
- 某条内置报告的历次期次 → `series_slug`
|
|
- 具体某一期 → 加 `period_key`
|
|
|
|
报告按受众分档(全员/管理层/老板/本人),过滤在服务端完成——查不到某条不代表它不存在。
|
|
|
|
---
|
|
|
|
## 会议与议题(只读)
|
|
|
|
```
|
|
meeting_query(scope="all", status_category?, series_ids?, module_ids?, tag_ids?)
|
|
issue_query(scope?, level?, status_category?, module_ids?, tag_ids?, q?)
|
|
```
|
|
|
|
管理身份可见全部议题,含标记为「仅管理层可见」的那些。
|
|
|
|
议题的写操作(建、记进展、关闭)**不在管理端**——那些应当由议题的当事人在个人端做,
|
|
管理端替他记进展会让决策链的「谁说的」失真。会议的写操作同理。
|