| Skill 名称 | 描述 | 来源 | 用法 |
|-----------|------|------|------|
| skill-creator | 对话式收集需求，生成可在多 AI Assistant 运行的技能包 | 内置 | omni-skill init --skill skill-creator |
| review-gate | 建立架构与工程化 PR Review 规范，提供可执行的 Review Checklist | 内置 | omni-skill init --skill review-gate |

触发示例：
- skill-creator: "我想做一个 skill"、"帮我生成 SKILL.md"、"把我的 prompt 工作流变成 skill"
- review-gate: "我想建立 PR Review 架构规范检查点"、"帮我生成 PR Review Checklist 模板"、"软评审代码"

快速开始

$3

场景 1：在 neo-skill 仓库内开发/维护 skill
`bash


从仓库根目录执行，一次性生成所有 IDE 的入口文件

`bash
omni-skill update
`

行为说明：
- 更新全局 npm 包（等价于执行 npm install -g neo-skills@latest）
- 自动执行一次 omni-skill init（同步/覆盖 skills/、.shared/ 与各 IDE 输出目录，并执行 uipro init --ai all）

可选开关：
- 如需跳过 npm 自更新，可设置环境变量：NEO_SKILLS_SKIP_SELF_UPDATE=1

场景 3：在其他项目中使用 neo-skill 的 skill
将 neo-skill 仓库克隆到你的项目中（例如 vendor/neo-skill/），然后根据你使用的 IDE，复制对应的入口文件到项目根目录：
- Windsurf：复制 .windsurf/workflows/.md 和 .windsurf/workflows/data/
- Cursor：复制 .cursor/commands/.md
- Claude Desktop：复制 .claude/skills//
- GitHub / VS Code Skills：复制 .github/skills//

$3

`bash


生成 + 校验（自动识别 skillspec.json）

当你通过 npm install -g neo-skills 安装后：

- 命令来源：你执行的 omni-skill/skill-creator 命令始终来自全局 npm 包（例如 .../node_modules/neo-skills/bin/...），不会被复制到项目里。
- 同步内容：omni-skill init 会把 npm 包内的技能/资源内容同步到你当前项目目录（覆盖式同步，按条目替换）：
- skills/
- .shared/skill-creator/
- .claude/skills/
- .windsurf/workflows/
- .cursor/commands/
- .github/skills/
- 不会同步：不会把用于执行命令的实现（如 npm 包内的 bin/、src/）拷贝到项目里，以避免出现“项目里也有一套命令实现”导致的混淆。
- uipro 初始化：omni-skill init 会自动执行 uipro init --ai all，用于把第三方库 skill 能力初始化/接入到你的 skill 库中。
- 如需跳过自动执行，可设置环境变量：NEO_SKILLS_SKIP_UIPRO_INIT=1

核心行为：
- 一次生成所有 IDE 的入口文件：.windsurf/、.claude/、.cursor/、.github/ 会同时生成
- 不同 IDE 可以共存，切换 IDE 时无需重新生成
- 生成的文件都是从 canonical skills//skillspec.json 渲染而来

参数说明：
- init / do：功能完全相同的别名（都执行 generate + validate）
- --skill ：指定 skill 名称（会查找 skills//skillspec.json）
- --spec ：直接指定 skillspec.json 的路径
- --repo-root ：指定仓库根目录（默认为当前目录）
- --cursor / --agent：可选的语义化标记（不影响实际执行，仅用于不同 AI 助手调用时的可读性）

自动解析规则：
1. 优先使用 --spec 或 --skill 参数
2. 其次查找当前目录的 skillspec.json
3. 再查找环境变量 OMNI_SKILL_SPEC 或 OMNI_SKILL
4. 默认使用 skills/coding-standards/skillspec.json（如果存在）
5. 如果只有一个 skill，自动使用该 skill
6. 如果有多个 skill，报错并提示可用的 skill 列表

Canonical 与生成文件

$3