dsh-plugin-t-expert 0.3.6 → 0.3.25

package/data/zh/specialized/specialized-chief-of-staff.md

@@ -1,40 +0,0 @@
----
-name: "幕僚长"
-description: "为创始人统筹事务与日程，过滤信息噪音，跟进流程与决策落地，保证输出一致。"
-emoji: "🧭"
-color: "#6B7280"
-vibe: "I don't own any function. I own the space between all of them."
----
-
-# 幕僚长
-
-你是**幕僚长**。为创始人统筹事务与日程，过滤信息噪音，跟进流程与决策落地，保证输出一致。
-
-## 核心使命
-
-把用户目标转化为本领域中可执行、可验证、可交付的结果。在给出方案时同时关注正确性、现实约束、风险和后续维护，不用空泛建议代替专业判断。
-
-## 工作原则
-
-- 先明确目标、使用对象、约束条件、已有证据和验收标准，再提出建议。
-- 严格区分已知事实、合理假设、估算结果和待确认事项，不编造数据、来源、系统行为或合规结论。
-- 使用本领域通行的方法、标准和术语；对关键取舍说明依据，不以短期便利掩盖安全、法律、财务、运营或质量风险。
-- 优先交付具体产物，例如方案、清单、决策表、规格、计算过程、审查结论或实施步骤，而不是泛泛讲解。
-- 尊重用户给出的真实边界。只有缺失信息会实质改变结论时才提出问题；否则明确假设后继续推进。
-- 最小化处理敏感信息，不泄露凭证、个人信息和机密业务数据。
-
-## 执行流程
-
-1. **界定任务**：确认期望结果，以及当前需要做出的决策或交付物。
-2. **核对材料**：检查用户提供的信息和术语，识别缺失、冲突及可信度问题。
-3. **专业分析**：运用领域方法推导结论，能量化时给出计算，并检查边界情况和失败模式。
-4. **形成交付**：输出可直接执行的结果；需要时注明负责人、依赖、验收标准和下一步。
-5. **自我校验**：检查内容是否前后一致、现实可行、符合约束，并确认已经正面回答用户问题。
-
-## 输出要求
-
-- 先给结论或建议动作，再提供必要依据。
-- 使用准确的专业术语，对少见概念做简短解释。
-- 展示关键假设、计算、证据和取舍。
-- 明确标注不确定性，以及必须由有资质专业人士复核的事项。
-- 不堆砌通用背景，不声称完成实际未执行的工作。

package/skills/t-expert-manager/SKILL.md

@@ -1,125 +0,0 @@
----
-name: t-expert-manager
-description: T专家 运维台 —— 316 位专家 / 22 分区的名册增删、名册一致性校验、统计与中文覆盖、小队（/t）成员编辑、装机到 DSH Desktop、发布到 npm。Use when the user asks to add/remove/validate/count T专家 experts, 新增专家 / 删除专家 / 校验名册 / 名册统计 / 改小队 / 重装插件 / 发布插件.
----
-
-# T专家 运维（expert-manager）
-
-运维入口只有一个：`bash "{{TZ}}"`。本机运维台根目录：`{{OPS_ROOT}}`。
-
-这套流程解决的是「你是原作者，要维护自己的名册和插件」的场景；只想**用**专家或拉小队，不要走这里
-（用 `list_t_experts` / `summon_t_expert`，小队用 `/t`）。
-
-## 铁律
-
-1. **只用 tz.sh**。不要手改 `data/experts/`、`plugin/`、`~/.t-team/`，也不要手改 `package.json` 的版本号 ——
-   这些动作脚本都代劳了，绕开脚本换来的就是"源码加了、运行时没加"这类半成品状态。
-2. **`data/experts/` 是真源**。增删由 `add-expert.py`（tz.sh 代跑）执行，它**同时写**源码与运行时
-   `~/.t-team/experts/`，两边永远一致。
-3. **统计必须递归**。有专家落在嵌套子目录（如 `game-development/unreal-engine/…`），
-   只看分类目录的第一层会漏掉它们。位数一律以 `tz.sh status` 的递归结果为准 ——
-   正文里不写死位数，因为每加一位专家它就会过期。
-4. **数据更新不用重装、不用重启**（宿主按 mtime 指纹自动重载名册）；**改插件代码**才需要
-   `tz.sh build` → `tz.sh install` → 重启 DSH Desktop。
-5. **小队改完分两条路，只有设置页那条会热重载**：
-   - **设置页「队伍」保存**（推荐）：`squads.save()` 编译成功后**就地热重载引擎配置 → 立即生效、不用重启**。
-   - **`tz.sh squads`（= 菜单 11）**：只是 CLI 直跑编译器（`python3 data/team-profiles.py`）把 `teams.json`
-     编译成引擎配置，**不经过插件、不会热重载**——运行中的引擎仍用旧 profiles，**必须重启 DSH**
-     （或再到设置页保存一次）才生效。所以别对用户说「跑完 tz.sh squads 就已经生效」。
-   两条路的失败语义一致：编译失败会**回滚**，盘上仍是旧配置（按旧小队建队）。
-   只有**改插件代码**才需要重启（见第 4 条）。
-6. **`data/zh/` 已冻结**：不要新增或"补译"中文。新专家没有中文名/简介会回退英文，这是预期行为。
-7. **破坏性动作先确认**：删除专家、卸载插件、发布 npm 之前，把影响讲给用户听，得到明确同意再执行。
-
-## 先看状态
-
-```bash
-bash "{{TZ}}" status
-```
-
-一眼给出：名册位数 / 分类数 / 中文覆盖 / 插件版本 vs DSH 里装的版本 / 仓库是否干净。
-
-## 工作流
-
-### A. 新增专家
-
-1. 先确认 slug 不冲突（`bash "{{TZ}}" roster` 看现有分类与位数）。
-2. **先 dry-run**：
-   ```bash
-   bash "{{TZ}}" experts add --category <分区> --slug <slug> --file </绝对路径/xxx.md> --dry-run
-   ```
-3. 确认路径无误后去掉 `--dry-run` 正式写入。源文件缺 frontmatter 时补 `--name` / `--description`；
-   目标已存在要覆盖时加 `--force`。
-4. 收尾校验：`bash "{{TZ}}" experts check`，必须报"三处一致"。
-
-### B. 删除专家
-
-先 `--dry-run` 看清要删的两条路径，再执行：
-
-```bash
-bash "{{TZ}}" experts remove --category <分区> --slug <slug> --yes
-```
-
-源码与运行时会被一并删除（`--yes` 跳过交互确认，所以**先跟用户确认过**再用）。
-
-### C. 校验名册
-
-```bash
-bash "{{TZ}}" experts check     # 源码 ↔ 运行时 ↔ 清单，逐文件 sha256；退出码 1 = 有漂移
-bash "{{TZ}}" verify            # check + 插件自检（verify.mjs），改过代码后必跑
-```
-
-### D. 统计与中文覆盖
-
-```bash
-bash "{{TZ}}" experts stats
-```
-
-汇报时给"分类数 / 专家数 / 中文覆盖"，不要把整张分类表贴给用户。
-
-### E. 修改小队（`/t`）
-
-1. 小队定义在 `data/teams.json`（人工维护）：成员写专家 slug 字符串，或 `{slug, role}` 对象。
-2. 用编辑器改完后编译成引擎配置：
-   ```bash
-   bash "{{TZ}}" squads
-   ```
-3. 明确告诉用户：**`tz.sh squads` 只是 CLI 直跑编译器**——它把 `teams.json` 编译成引擎配置，
-   **不会让运行中的插件重载**。所以：**要让新小队真正生效，需重启 DSH Desktop**（或再到设置页「队伍」保存一次，
-   那条路才会就地热重载、立即生效）。若 `/t` 里仍看不到新小队，先确认编译没报错（编译失败会回滚，盘上仍是旧配置）。
-4. 想免重启就直接走设置页：设置 → T专家 → 队伍 → 改完保存（`squads.save()` 编译成功后触发引擎热重载，立即生效）。
-
-### F. 装机（只在改过插件代码时需要）
-
-```bash
-bash "{{TZ}}" verify            # 先自检
-bash "{{TZ}}" build             # 构建 client bundle
-bash "{{TZ}}" install           # 装到 profile（默认 desktop）；可先 --dry-run
-```
-
-装机后仍需**重启 DSH Desktop**。装错/装坏时 `bash "{{TZ}}" install-restore` 可还原被接管的依赖。
-
-### G. 发布到 npm
-
-```bash
-bash "{{TZ}}" publish-dry       # 预演：只跑预检与打包预览
-bash "{{TZ}}" publish --current # 直接发布 package.json 里的当前版本（不升版）—— 版本号在开发期就写好了
-bash "{{TZ}}" publish           # 交互选版本（菜单里选项 1 就是"发布当前版本"）；也可 --patch / --minor / --major / --version X.Y.Z
-```
-
-> 版本号的单一来源是 `package.json`：菜单 15 会把**当前版本号自动读出来**并作为首选，
-> 客户端构建版本（`CLIENT_BUILD_VERSION`）与它必须一致（verify 有断言盯着），所以通常不需要在发布时再 bump。
-> 回车＝取消（发布不可逆，没有"回车即发"的默认）。
-> 选「发布当前版本」不跑 `npm version`，但会**给该版本补一个 tag** —— 发出去的版本要能对应到具体提交，失败后也才能用 `--retry` 重试。
-
-**发布前必须**：(a) 得到用户明确同意；(b) `experts check` 与 `verify` 全绿；(c) 工作区没有未提交的意外改动。
-
-## 汇报约定
-
-- 给"执行的命令 + 结尾结论"，不要贴整篇日志。
-- 失败就贴出错那一段（含退出码）并说明下一步；不要静默重试或换个命令重来。
-- 名册位数永远按递归结果报（见铁律 3）。
-
-## 参考
-
-- `references/ops-reference.md` —— 完整子命令 / 菜单号 / 参数表，以及"哪份文件是真源"的地图。

package/skills/t-expert-manager/references/ops-reference.md

@@ -1,100 +0,0 @@
-# T专家 运维参考
-
-本文件是 `SKILL.md` 的展开版：完整命令、菜单号、参数与"哪份文件是真源"的地图。
-命令里的 `<ops>` = 运维台根目录（`tz.sh` 所在目录）。
-
-## 一、子命令（脚本化用，agent 优先用这一组）
-
-| 子命令 | 作用 | 备注 |
-| --- | --- | --- |
-| `tz.sh status` | 状态头：名册/中文/版本/仓库是否干净 | 只读 |
-| `tz.sh experts add` | 新增专家 | 参数见下；无参数 = 交互 |
-| `tz.sh experts remove` | 删除专家（源码 + 运行时） | 先 `--dry-run` |
-| `tz.sh experts stats` | 名册统计（分类 / 专家数 / 中文覆盖） | 递归统计 |
-| `tz.sh experts check` | 名册一致性（源码 ↔ 运行时 ↔ 清单） | 退出码 1 = 漂移 |
-| `tz.sh roster` | 同 `experts stats` | |
-| `tz.sh verify` | `experts check` + `verify.mjs` 插件自检 | 改代码后必跑 |
-| `tz.sh squads` | 刷新小队配置（`teams.json` → 引擎 profiles，= 菜单 11） | **CLI 直跑编译器，不触发热重载**：运行中的引擎仍用旧 profiles → 需重启 DSH Desktop（或改走设置页保存） |
-| `tz.sh build` | 构建 client bundle | `npm run build` |
-| `tz.sh install` | 安装/重装到 profile | 见参数；`--dry-run` 预演 |
-| `tz.sh uninstall` | 卸载（保留 `experts/` 与 `zh/`） | |
-| `tz.sh install-restore` | 还原被接管的 `@nanmicoder/dsh-agent-teams` | 有接管记录时可用 |
-| `tz.sh sync-data` | 把运行时数据快照同步回包内 `data/` | 发布前用 |
-| `tz.sh publish-dry` / `publish` | 发布预演 / 发布到 npm | 见参数 |
-| `tz.sh open` | 打开运行时数据目录 | |
-
-## 二、交互菜单号（`tz.sh <编号>` 等价）
-
-| # | 动作 | # | 动作 |
-| --- | --- | --- | --- |
-| 1 | 新增专家 | 9 | 卸载插件（保留数据） |
-| 2 | 删除专家 | 10 | 校验：名册一致性 + 插件自检 |
-| 3 | 名册统计 | 11 | 刷新小队配置 |
-| 4 | 打开源码专家目录 `data/experts` | 12 | 构建插件产物 |
-| 5 | 名册一致性校验 | 13 | （已移除）内置引擎同步 |
-| 6 | 中文覆盖报告（已冻结） | 14 | 发布预演（dry-run） |
-| 7 | 打开运行时数据目录 | 15 | 一键发布到 npm |
-| 8 | 安装/重装到 profile | 16 | 同步包内数据快照 |
-
-## 三、`experts add` / `experts remove` 参数
-
-`add`（`--repo` / `--runtime` 由 tz.sh 自动注入，不要手写）：
-
-| 参数 | 说明 |
-| --- | --- |
-| `--category <分区>` | 目标分类（已存在或新建） |
-| `--slug <slug>` | 文件名即 slug：`a-z 0-9 -`；中文名必须显式给 `--slug` |
-| `--file <路径>` | 源 Markdown（绝对路径最稳） |
-| `--label <显示名>` | 新建分类时的中文显示名 |
-| `--name` / `--description` / `--emoji` | 源文件缺 frontmatter 时补齐 |
-| `--force` | 目标已存在时覆盖 |
-| `--yes` | 跳过交互确认 |
-| `--dry-run` | 只打印将写入的路径，不落盘 |
-
-`remove`：`--category` + `--slug`（+ `--yes` / `--dry-run`）。
-`slug` 就是文件名；工具会在分类树下**递归**定位它，嵌套子目录也能删对。
-
-## 四、`install` / `publish` 参数
-
-```
-tz.sh install [--profile <名或路径>] [--dry-run] [--keep-agent-teams]
-tz.sh install-restore
-tz.sh uninstall
-tz.sh publish-dry | publish [--patch|--minor|--major|--version X.Y.Z] [--retry] [--push|--no-push]
-```
-
-- 默认 profile：`~/.dsh/profiles/desktop`。
-- `install` 会：把仓库复制成运行副本 `plugin/`（STAGE）→ 复制到 profile 的 `node_modules/` →
-  改 profile 的 `package.json` 依赖/bundles。**必须重启 DSH Desktop 才生效**。
-- `publish` 默认 patch 升版；`--retry` 用于发布中断后重试；`--no-push` 不推 git tag。
-
-## 五、真源地图（改哪份才是改对了）
-
-| 内容 | 真源 | 说明 |
-| --- | --- | --- |
-| 专家名册 | `<ops>/dsh-plugin-t-expert/data/experts/` | 22 分类 / 316 位；运行时是它的同步副本 |
-| 中文侧车 | `<ops>/dsh-plugin-t-expert/data/zh/` | **已冻结**，只读不写 |
-| 小队定义 | 数据目录 `teams.json` | 人工维护；`data/` 与 `~/.t-team/` 同一份（软链） |
-| 小队编译产物 | 数据目录 `t-team.config.json` | 由 `team-profiles.py` 生成，**不要手改** |
-| 面板自建专家 | `<数据目录>/custom/custom/<slug>.md` | 不属于快照，同步脚本永不碰它 |
-| 团队引擎源码 | `<ops>/dsh-plugin-t-expert/lib/teams/` | 手工维护的源码 |
-| 运行副本 | `<ops>/plugin/` | 安装产物，删了重跑 `tz.sh install` 即可重建 |
-
-## 六、环境变量（覆盖路径）
-
-| 变量 | 默认 | 作用 |
-| --- | --- | --- |
-| `T_TEAM_REPO` | `<ops>/dsh-plugin-t-expert` | 插件仓库位置 |
-| `T_TEAM_DATA` | `<ops>/data` | 数据目录 |
-| `T_TEAM_STAGE` | `<ops>/plugin` | 运行副本目录 |
-
-## 七、常见故障
-
-| 现象 | 原因 / 处理 |
-| --- | --- |
-| 名册少了几位 | 只数了分类目录的第一层（嵌套子目录里的专家被漏掉）—— 必须递归，以 `tz.sh status` 为准 |
-| `experts check` 报"运行时缺/多出" | 绕开脚本手工拷贝过文件；用 `experts add` 重做那一条 |
-| 新增专家后面板看不到 | 面板按 mtime 指纹自动重载；仍看不到就查该专家是否被**启用**（设置页 T专家 标签，默认全禁用） |
-| 改了小队但 `/t` 里没生效 | 先看编译报错（失败会回滚，盘上仍是旧配置）；若编译成功却是走 `tz.sh squads` 的，**运行中的引擎不会热重载 → 需重启 DSH Desktop**，或改走设置页「队伍」保存（那条立即生效） |
-| 装了新版本但没变化 | 只跑了 `build` 没跑 `install`，或没重启 |
-| `找不到插件仓库` | 设 `T_TEAM_REPO`，或用 `--repo` 指定 |