dsh-plugin-t-expert 0.2.6 → 0.2.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. package/README.md +21 -5
  2. package/THIRD-PARTY-NOTICES +17 -6
  3. package/data/experts/engineering/engineering-deepseek-harness-project-expert.md +256 -0
  4. package/data/experts/engineering/engineering-typescript-npm-stack-maintainer.md +277 -0
  5. package/data/source.json +2 -2
  6. package/data/t-team.config.json +16 -1
  7. package/data/team-profiles.py +80 -78
  8. package/data/teams.json +103 -47
  9. package/data/teams.resolved.json +17 -1
  10. package/data/zh/COVERAGE.json +16 -13
  11. package/data/zh/descriptions.json +3 -1
  12. package/data/zh/divisions.json +1 -1
  13. package/data/zh/names.json +3 -1
  14. package/lib/catalog.js +134 -31
  15. package/lib/client.js +1 -1
  16. package/lib/command.js +4 -1
  17. package/lib/i18n.js +75 -11
  18. package/lib/index.js +169 -58
  19. package/lib/plan-check.js +14 -3
  20. package/lib/remote.js +82 -15
  21. package/lib/skill.js +209 -0
  22. package/lib/squads.js +51 -3
  23. package/lib/teams/assignee-contract.js +47 -0
  24. package/lib/teams/quality-gates.js +24 -1
  25. package/lib/teams/state.js +14 -2
  26. package/lib/teams/tools.js +9 -3
  27. package/package.json +11 -24
  28. package/skills/dsh-harness-languages/SKILL.md +175 -0
  29. package/skills/dsh-harness-project/SKILL.md +209 -0
  30. package/skills/t-expert-manager/SKILL.md +110 -0
  31. package/skills/t-expert-manager/references/ops-reference.md +100 -0
  32. package/vendor/third-party-licenses/README.md +1 -1
package/skills/t-expert-manager/references/ops-reference.md ADDED
@@ -0,0 +1,100 @@
1
+ # T专家 运维参考
2
+
3
+ 本文件是 `SKILL.md` 的展开版：完整命令、菜单号、参数与"哪份文件是真源"的地图。
4
+ 命令里的 `<ops>` = 运维台根目录（`tz.sh` 所在目录）。
5
+
6
+ ## 一、子命令（脚本化用，agent 优先用这一组）
7
+
8
+ | 子命令 | 作用 | 备注 |
9
+ | --- | --- | --- |
10
+ | `tz.sh status` | 状态头：名册/中文/版本/仓库是否干净 | 只读 |
11
+ | `tz.sh experts add` | 新增专家 | 参数见下；无参数 = 交互 |
12
+ | `tz.sh experts remove` | 删除专家（源码 + 运行时） | 先 `--dry-run` |
13
+ | `tz.sh experts stats` | 名册统计（分类 / 专家数 / 中文覆盖） | 递归统计 |
14
+ | `tz.sh experts check` | 名册一致性（源码 ↔ 运行时 ↔ 清单） | 退出码 1 = 漂移 |
15
+ | `tz.sh roster` | 同 `experts stats` | |
16
+ | `tz.sh verify` | `experts check` + `verify.mjs` 插件自检 | 改代码后必跑 |
17
+ | `tz.sh squads` | 刷新小队配置（`teams.json` → 引擎 profiles） | 需重启 DSH Desktop |
18
+ | `tz.sh build` | 构建 client bundle | `npm run build` |
19
+ | `tz.sh install` | 安装/重装到 profile | 见参数；`--dry-run` 预演 |
20
+ | `tz.sh uninstall` | 卸载（保留 `experts/` 与 `zh/`） | |
21
+ | `tz.sh install-restore` | 还原被接管的 `@nanmicoder/dsh-agent-teams` | 有接管记录时可用 |
22
+ | `tz.sh sync-data` | 把运行时数据快照同步回包内 `data/` | 发布前用 |
23
+ | `tz.sh publish-dry` / `publish` | 发布预演 / 发布到 npm | 见参数 |
24
+ | `tz.sh open` | 打开运行时数据目录 | |
25
+
26
+ ## 二、交互菜单号（`tz.sh <编号>` 等价）
27
+
28
+ | # | 动作 | # | 动作 |
29
+ | --- | --- | --- | --- |
30
+ | 1 | 新增专家 | 9 | 卸载插件（保留数据） |
31
+ | 2 | 删除专家 | 10 | 校验：名册一致性 + 插件自检 |
32
+ | 3 | 名册统计 | 11 | 刷新小队配置 |
33
+ | 4 | 打开源码专家目录 `data/experts` | 12 | 构建插件产物 |
34
+ | 5 | 名册一致性校验 | 13 | （已移除）内置引擎同步 |
35
+ | 6 | 中文覆盖报告（已冻结） | 14 | 发布预演（dry-run） |
36
+ | 7 | 打开运行时数据目录 | 15 | 一键发布到 npm |
37
+ | 8 | 安装/重装到 profile | 16 | 同步包内数据快照 |
38
+
39
+ ## 三、`experts add` / `experts remove` 参数
40
+
41
+ `add`（`--repo` / `--runtime` 由 tz.sh 自动注入，不要手写）：
42
+
43
+ | 参数 | 说明 |
44
+ | --- | --- |
45
+ | `--category <分区>` | 目标分类（已存在或新建） |
46
+ | `--slug <slug>` | 文件名即 slug：`a-z 0-9 -`；中文名必须显式给 `--slug` |
47
+ | `--file <路径>` | 源 Markdown（绝对路径最稳） |
48
+ | `--label <显示名>` | 新建分类时的中文显示名 |
49
+ | `--name` / `--description` / `--emoji` | 源文件缺 frontmatter 时补齐 |
50
+ | `--force` | 目标已存在时覆盖 |
51
+ | `--yes` | 跳过交互确认 |
52
+ | `--dry-run` | 只打印将写入的路径，不落盘 |
53
+
54
+ `remove`：`--category` + `--slug`（+ `--yes` / `--dry-run`）。
55
+ `slug` 就是文件名；工具会在分类树下**递归**定位它，嵌套子目录也能删对。
56
+
57
+ ## 四、`install` / `publish` 参数
58
+
59
+ ```
60
+ tz.sh install [--profile <名或路径>] [--dry-run] [--keep-agent-teams]
61
+ tz.sh install-restore
62
+ tz.sh uninstall
63
+ tz.sh publish-dry | publish [--patch|--minor|--major|--version X.Y.Z] [--retry] [--push|--no-push]
64
+ ```
65
+
66
+ - 默认 profile：`~/.dsh/profiles/desktop`。
67
+ - `install` 会：把仓库复制成运行副本 `plugin/`（STAGE）→ 复制到 profile 的 `node_modules/` →
68
+ 改 profile 的 `package.json` 依赖/bundles。**必须重启 DSH Desktop 才生效**。
69
+ - `publish` 默认 patch 升版；`--retry` 用于发布中断后重试；`--no-push` 不推 git tag。
70
+
71
+ ## 五、真源地图（改哪份才是改对了）
72
+
73
+ | 内容 | 真源 | 说明 |
74
+ | --- | --- | --- |
75
+ | 专家名册 | `<ops>/dsh-plugin-t-expert/data/experts/` | 22 分类 / 316 位；运行时是它的同步副本 |
76
+ | 中文侧车 | `<ops>/dsh-plugin-t-expert/data/zh/` | **已冻结**，只读不写 |
77
+ | 小队定义 | 数据目录 `teams.json` | 人工维护；`data/` 与 `~/.t-team/` 同一份（软链） |
78
+ | 小队编译产物 | 数据目录 `t-team.config.json` | 由 `team-profiles.py` 生成，**不要手改** |
79
+ | 面板自建专家 | `<数据目录>/custom/custom/<slug>.md` | 不属于快照，同步脚本永不碰它 |
80
+ | 团队引擎源码 | `<ops>/dsh-plugin-t-expert/lib/teams/` | 手工维护的源码 |
81
+ | 运行副本 | `<ops>/plugin/` | 安装产物，删了重跑 `tz.sh install` 即可重建 |
82
+
83
+ ## 六、环境变量（覆盖路径）
84
+
85
+ | 变量 | 默认 | 作用 |
86
+ | --- | --- | --- |
87
+ | `T_TEAM_REPO` | `<ops>/dsh-plugin-t-expert` | 插件仓库位置 |
88
+ | `T_TEAM_DATA` | `<ops>/data` | 数据目录 |
89
+ | `T_TEAM_STAGE` | `<ops>/plugin` | 运行副本目录 |
90
+
91
+ ## 七、常见故障
92
+
93
+ | 现象 | 原因 / 处理 |
94
+ | --- | --- |
95
+ | 名册少了几位 | 只数了分类目录的第一层（嵌套子目录里的专家被漏掉）—— 必须递归，以 `tz.sh status` 为准 |
96
+ | `experts check` 报"运行时缺/多出" | 绕开脚本手工拷贝过文件；用 `experts add` 重做那一条 |
97
+ | 新增专家后面板看不到 | 面板按 mtime 指纹自动重载；仍看不到就查该专家是否被**启用**（设置页 T专家 标签，默认全禁用） |
98
+ | 改了小队但 `/t` 里没有 | 没跑 `tz.sh squads`，或没重启 DSH Desktop |
99
+ | 装了新版本但没变化 | 只跑了 `build` 没跑 `install`，或没重启 |
100
+ | `找不到插件仓库` | 设 `T_TEAM_REPO`，或用 `--repo` 指定 |
package/vendor/third-party-licenses/README.md CHANGED
@@ -5,7 +5,7 @@
5
5
 
6
6
  | 文件 | 覆盖的随包内容 | 来源 |
7
7
  | --- | --- | --- |
8
- | `agency-agents.LICENSE` | `data/experts/`（22 分区 / 314 位；其中 279 位为上游仓库逐字节镜像，35 位来自名册来源包快照） | The Agency / AgentLand 名册快照，MIT |
8
+ | `agency-agents.LICENSE` | `data/experts/`（22 分区 / 316 位；其中 315 位来自第三方 —— 279 位为上游仓库逐字节镜像、35 位来自名册来源包快照；余 2 位为本仓自建，不由本许可覆盖） | The Agency / AgentLand 名册快照，MIT |
9
9
  | `agency-agents-zh.LICENSE` | `data/zh/` 中的中文名字、简介与人格正文 | `agency-agents-zh` 中文翻译与本地化资产，MIT |
10
10
 
11
11
  两份文本都是从实际用于生成快照的来源包内**逐字节复制**的，未经改写：