teamix-evo 0.19.2 → 0.20.1

package/README.md

@@ -20,7 +20,7 @@ packages/cli/
 │   ├── commands/
 │   │   ├── tokens/                 # tokens init <variant> / list / list-variants
 │   │   │   │                       # / update(stub) / uninstall
-│   │   ├── skills/                 # source-mirror 模型见 ADR 0013
+│   │   ├── skills/                 # npm-source direct-mirror 模型见 ADR 0048
 │   │   │   │                       # add / list / update / sync / doctor / uninstall
 │   │   └── ui/                     # init / add / list
 │   ├── core/                       # 业务编排层(programmatic API,subpath 导出)
@@ -35,6 +35,7 @@ packages/cli/
 │   │   ├── IdeAdapter.ts           # IDE 适配接口
 │   │   ├── QoderAdapter.ts         # Qoder 适配
 │   │   ├── ClaudeAdapter.ts        # Claude Code 适配
+│   │   ├── CodexAdapter.ts         # Codex / ChatGPT 适配（.agents/skills）
 │   │   └── index.ts                # detectIde / ALL_IDE_KINDS
 │   ├── utils/
 │   │   ├── fs.ts                   # 原子写入、备份
@@ -112,7 +113,7 @@ export const myCommand = new Command('my-cmd')
 
 ### 5. IDE 适配
 
-当前支持 Qoder 与 Claude Code(`QoderAdapter` / `ClaudeAdapter`),`detectIde()` 自动判断。扩展新 IDE:
+当前支持 Qoder、Claude Code 与 Codex / ChatGPT(`QoderAdapter` / `ClaudeAdapter` / `CodexAdapter`),`detectIde()` 自动判断。扩展新 IDE:
 
 1. 在 `src/ide/` 下新建 `XxxAdapter.ts`,实现 `IdeAdapter` 接口
 2. 在 `src/ide/index.ts` 的 `detectIde()` 中添加检测逻辑
@@ -134,8 +135,8 @@ pnpm --filter teamix-evo test:watch
 - `tokens-init-skills-link.test.ts` — tokens init ↔ skills auto-install 联动
 - `installer.test.ts` — UI 资源安装(frozen / regenerable)
 - `ui-installer.test.ts` — UI 装机引擎(依赖图 / alias 转换)
-- `skills-installer.test.ts` — skills 装机(source-mirror)
-- `skills-sync-doctor.test.ts` — source ↔ mirror 漂移检测
+- `skills-installer.test.ts` — skills 从 npm 包渲染到 IDE mirror
+- `skills-sync-doctor.test.ts` — IDE mirror 缺失 / 漂移检测
 - `updater.test.ts` — 三策略更新逻辑(ADR 0003)
 - `state.test.ts` — `.teamix-evo/` 状态读写
 - `template.test.ts` — Handlebars 渲染
@@ -190,9 +191,9 @@ TEAMIX_DEBUG=1 teamix-evo tokens init opentrek
 | `teamix-evo skills add <name...>`                         | 增量装指定 skill(`<name...>` 必填)                                                                                      |
 | `teamix-evo skills list`                                  | 列出所有 skill 的安装状态                                                                                               |
 | `teamix-evo skills update [name...] [--dry-run]`          | 升级 skills(双闸 + version 短路 — ADR 0035)                                                                             |
-| `teamix-evo skills sync [name...]`                        | 源 → IDE 镜像(漂移恢复用)                                                                                               |
-| `teamix-evo skills doctor`                                | 检测源/镜像漂移(ADR 0013)                                                                                               |
-| `teamix-evo skills uninstall`                             | 卸载 skills(源 + 镜像 + lock)                                                                                           |
+| `teamix-evo skills sync [name...]`                        | npm 包 → IDE 镜像(漂移恢复；`--ide` 持久重配全部 skill)                                                                 |
+| `teamix-evo skills doctor`                                | 检测 IDE 镜像缺失 / 漂移(ADR 0048)                                                                                      |
+| `teamix-evo skills uninstall`                             | 卸载已知 IDE 镜像 + lock 记录                                                                                           |
 | `teamix-evo ui init`                                      | 初始化 ui 配置(aliases / iconLibrary / tsx / rsc)                                                                       |
 | `teamix-evo ui add <id...>`                               | 安装指定 ui 组件源码                                                                                                    |
 | `teamix-evo ui list [--installed]`                        | 列出可用/已安装 ui 组件                                                                                                 |
@@ -210,16 +211,22 @@ TEAMIX_DEBUG=1 teamix-evo tokens init opentrek
 
 ### 全局装 skill(`--scope global`)
 
-`skills init` 与 `skills add` 都支持 `--scope global` 装到 IDE 全局(`~/.qoder/skills/` + `~/.claude/skills/`)。当 cwd 不是 Teamix Evo 项目时,工具会自动把元数据写到 `~/.teamix-evo-global/`,不污染当前目录。
+`skills init` 与 `skills add` 都支持 `--scope global` 装到 IDE 全局(`~/.qoder/skills/` + `~/.claude/skills/` + `~/.agents/skills/`)。当 cwd 不是 Teamix Evo 项目时,工具会自动把元数据写到 `~/.teamix-evo-global/`,不污染当前目录。
 
 ```bash
 # Onboarding 推荐:全局装 manage skill
-npx teamix-evo@latest skills add teamix-evo-manage --scope global --ide claude,qoder -y
+npx teamix-evo@latest skills add teamix-evo-manage --scope global --ide qoder,claude,codex -y
 
 # 后续维护(update / uninstall 等)需 cd 到全局元数据根
 cd ~/.teamix-evo-global && npx teamix-evo skills update
 ```
 
+已有项目新增 Codex mirror（同时持久更新 config + lock）：
+
+```bash
+npx teamix-evo@latest skills sync --ide qoder,claude,codex
+```
+
 ## 关键约定
 
 - 使用 `process.exitCode = 1` 而非 `process.exit(1)`，确保异步操作完成

package/dist/core/index.d.ts

@@ -6,7 +6,7 @@ interface RunTokensInitOptions {
     projectRoot: string;
     /** Tokens variant id (e.g. `"opentrek"`, `"uni-manager"`). */
     variant: string;
-    /** IDE identifier written into config.json (e.g. `"qoder"`, `"claude"`). */
+    /** IDE identifier written into config.json (e.g. `"qoder"`, `"claude"`, `"codex"`). */
     ide: string;
     /** Override the tokens package name (defaults to `"@teamix-evo/tokens"`). */
     packageName?: string;
@@ -842,7 +842,7 @@ declare function installResources(options: InstallOptions): Promise<InstallResul
 /**
  * Skills installer — renders upstream skill sources from the npm package
  * and writes directly to IDE mirror paths (`.qoder/skills/<id>/`,
- * `.claude/skills/<id>/`).
+ * `.claude/skills/<id>/`, `.agents/skills/<id>/`).
  */
 interface SkillInstallOptions {
     /** Project root directory */