@teamix-evo/skills

Skills (AI IDE 自动技能) for Teamix Evo. 同源支持 Qoder 和 Claude Code。

包结构

packages/skills/
├── manifest.json          # 顶层声明：枚举所有 skill
├── _data.json             # 模板共享数据（可选）
├── _template/             # 新建 skill 时的脚手架模板
│   └── SKILL.md.hbs
├── skills/                # 每个 skill 一个子目录
│   └── teamix-evo-manage/
│       └── SKILL.md       # 入口文件（同源 Qoder + Claude）
└── scripts/
    ├── validate-skills.ts
    └── scaffold-skill.ts

协议要点

• 每个 skill 必须有 SKILL.md，frontmatter 至少包含 name + description。
• description 是 AI 触发依据，请明确写出"何时该激活"。
• 默认 updateStrategy: managed，并使用 managed regions 让升级保留用户自定义部分。
• 安装后 SKILL.md 同时落到所选 IDE 路径：
  • Qoder：.qoder/skills/<name>/SKILL.md 或 ~/.qoder/skills/<name>/SKILL.md
  • Claude：.claude/skills/<name>/SKILL.md 或 ~/.claude/skills/<name>/SKILL.md

研发态命令

# 校验 manifest + 资源完整性
pnpm --filter @teamix-evo/skills validate

# 新建 skill（脚手架）
pnpm --filter @teamix-evo/skills scaffold:skill

消费态命令（CLI）

由 teamix-evo skills 子命令族管理（source-mirror 模型见 ADR 0013）：

teamix-evo skills add                # 全量装入 manifest 内所有 skill
teamix-evo skills add <name...>      # 增量：仅装入指定 skill（可多个）
teamix-evo skills list               # 列出全部 skill（默认：已装✓ / 未装○）
teamix-evo skills update             # 升级到最新版（managed 策略保留你的自定义）
teamix-evo skills sync [name...]     # 源 → IDE 镜像（漂移恢复用）
teamix-evo skills doctor             # 检测源 / 镜像漂移
teamix-evo skills uninstall          # 卸载（源 + 镜像 + lock）

全局装机（--scope global）

# 一行装到 ~/.qoder/skills/ 与 ~/.claude/skills/，元数据落到 ~/.teamix-evo-global/
npx teamix-evo@latest skills add teamix-evo-manage --scope global --ide claude,qoder -y

# 后续维护（update / uninstall 等）需 cd 到全局元数据根
cd ~/.teamix-evo-global && npx teamix-evo skills update