@teamix-evo/mcp 0.4.3 → 0.4.4
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.
|
@@ -9,10 +9,10 @@
|
|
|
9
9
|
|
|
10
10
|
`@teamix-evo/skills` 当前混了两类性质完全不同的 skill,放在同一个 `manifest.skills` 数组里:
|
|
11
11
|
|
|
12
|
-
| 类型
|
|
13
|
-
|
|
|
14
|
-
| **lifecycle skill / orchestrator** | `teamix-evo-manage`
|
|
15
|
-
| **content skill / variant 内容**
|
|
12
|
+
| 类型 | 例子 | 安装语义 |
|
|
13
|
+
| ---------------------------------- | ---------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
|
|
14
|
+
| **lifecycle skill / orchestrator** | `teamix-evo-manage` | 工具型。作为生命周期入口被调用(初始化、升级、卸载、placeholder→real 迁移)。**装一次即可**,不需要跟项目走。 |
|
|
15
|
+
| **content skill / variant 内容** | `teamix-evo-design-<variant>`、`teamix-evo-code-<variant>` | 跟 variant 绑定。装在哪个项目就影响哪个项目的页面 / 文件生成规则。**必须随项目走**。 |
|
|
16
16
|
|
|
17
17
|
实际用户路径:
|
|
18
18
|
|
|
@@ -28,17 +28,17 @@
|
|
|
28
28
|
|
|
29
29
|
## Options Considered
|
|
30
30
|
|
|
31
|
-
| 选项
|
|
32
|
-
|
|
|
33
|
-
| A. SkillEntry 加 `scope` 字段,bulk init 按 scope 过滤(本决策)
|
|
34
|
-
| B. 运行时去重(`skills init` 检测 `~/.claude/skills/<id>` 已存在则跳过)
|
|
35
|
-
| C. 在 `teamix-evo-manage` 自身的 SKILL.md 决策树里手动让 AI 排除 manage | 不动 CLI / manifest
|
|
36
|
-
| D. 把 `teamix-evo-manage` 拆成独立 npm 包
|
|
31
|
+
| 选项 | 优点 | 缺点 |
|
|
32
|
+
| ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
|
|
33
|
+
| A. SkillEntry 加 `scope` 字段,bulk init 按 scope 过滤(本决策) | 声明式;符合 manifest 契约;新增 lifecycle skill 只需打一个标签;现存 manifest 不写该字段也兼容 | 引入一个语义字段,需要 schema bump;CLI 增加分支 |
|
|
34
|
+
| B. 运行时去重(`skills init` 检测 `~/.claude/skills/<id>` 已存在则跳过) | 不动 manifest | 依赖外部状态;同名不同版本时反而锁死;语义不显式 |
|
|
35
|
+
| C. 在 `teamix-evo-manage` 自身的 SKILL.md 决策树里手动让 AI 排除 manage | 不动 CLI / manifest | 每次新增 lifecycle skill 都要改 markdown;契约不机器可读;AI 偏离指令时无法兜底 |
|
|
36
|
+
| D. 把 `teamix-evo-manage` 拆成独立 npm 包 | 物理隔离 | 破坏单包多 group 原则;用户安装路径变复杂;需要 CI 改造 |
|
|
37
37
|
|
|
38
38
|
## Decision
|
|
39
39
|
|
|
40
40
|
1. `SkillEntrySchema`(`packages/registry/src/schema/manifest.ts`)新增可选字段 `scope: SkillScopeSchema.optional()`,复用已有的 `SkillScopeSchema = z.enum(['project', 'global'])`。`undefined` 视为隐式 `"project"`。
|
|
41
|
-
2. `packages/skills/manifest.json`
|
|
41
|
+
2. `packages/skills/manifest.json` 中所有 lifecycle 工具型 skill 标 `"scope": "global"`：当前包含 `teamix-evo-manage`（orchestration 入口）与 `teamix-evo-upgrade`（staging / hints apply 工具，跨 variant 共用，不携带业务内容）；其余 content skill（`teamix-evo-design-<variant>` / `teamix-evo-code-<variant>`）不动。
|
|
42
42
|
3. `runSkillsInit`(`packages/cli/src/core/skills-add.ts`,自举路径)candidate 过滤:若 `(s.scope ?? 'project') !== <current install scope>`,跳过(debug 日志说明)。**verb 命名见 [ADR 0034](0034-skills-cli-verb-alignment.md)**。
|
|
43
43
|
4. `runSkillsAdd`(增量,显式指名)**不**过滤,但若指名的 skill 声明的 scope 与当前 scope 不一致,emit 一条 `logger.warn`,提示推荐 scope。**用户显式指令优先,自负责。**
|
|
44
44
|
5. `create-teamix-evo` 的两个 preset(`opentrek` / `uni-manager`)从 `skills.entries` 移除 `teamix-evo-manage`。`skills.entries` 只剩 `design-${variant}` + `code-${variant}` 两条 variant 内容。orchestrator 末尾 next-steps 输出多一行,提示用户独立全局装 manage。
|
|
@@ -62,3 +62,4 @@
|
|
|
62
62
|
|
|
63
63
|
- 用户反馈:「用户使用时会先全局安装 teamix-evo-manage 这个技能,然后使用该技能初始化工程,但是初始化过程中又会在项目级安装本技能,导致用户侧会有两个该技能」
|
|
64
64
|
- 实施 plan:`/Users/lyca/.claude/plans/refactored-roaming-grove.md`
|
|
65
|
+
- 2026-06-15 复盘补遗：`teamix-evo-upgrade` 上线时 manifest 漏标 scope 字段（隐式 project）。复盘后判定其内容形态属于 lifecycle 工具型（通用工作流、跨 variant 共用、强项目状态绑定占比 <10%），与 manage 同站 global。同步标 `"scope": "global"`，落地动作与 manage 完全一致。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@teamix-evo/mcp",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.4",
|
|
4
4
|
"description": "Model Context Protocol server for teamix-evo. Single bin / single process / multiple tool groups (registry now; design / adr / scenario coming v0.6-v0.8). Renamed from @teamix-evo/registry-mcp per ADR 0011.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"exports": {
|
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
"dependencies": {
|
|
22
22
|
"@modelcontextprotocol/sdk": "^1.29.0",
|
|
23
23
|
"zod": "^3.23.0",
|
|
24
|
-
"@teamix-evo/registry": "0.
|
|
24
|
+
"@teamix-evo/registry": "0.9.0"
|
|
25
25
|
},
|
|
26
26
|
"devDependencies": {
|
|
27
27
|
"@types/node": "^20.0.0",
|