cvte-skills-cli 1.0.2 → 1.0.3

package/README.md

@@ -6,11 +6,11 @@
 
 | 助手 | 配置文件位置 |
 |------|-------------|
-| Claude Code | `~/.claude/settings.json` (全局) / `CLAUDE.md` (项目) |
+| Claude Code | `~/.claude/commands/` (全局) / `.claude/commands/` (项目) |
 | Cursor | `~/.cursor/rules` (全局) / `.cursorrules` (项目) |
 | Windsurf | `~/.windsurf/rules` (全局) / `.windsurfrules` (项目) |
 | GitHub Copilot | `.github/copilot-instructions.md` |
-| Codex CLI | `~/.codex/instructions.md` (全局) / `codex.md` (项目) |
+| Codex CLI | `~/.codex/AGENTS.md` (全局) / `AGENTS.md` (项目) |
 | Gemini CLI | `~/.gemini/instructions.md` (全局) / `GEMINI.md` (项目) |
 
 ## 包含的 Skills
@@ -149,15 +149,13 @@ description: "Skill 的简短描述"
 ### Claude Code
 
 ```bash
-# 方式1: 使用 claude 命令
-claude config add skills /path/to/skills/skills/gitlab-commit-message
-
-# 方式2: 编辑 ~/.claude/settings.json
-{
-  "skills": [
-    "/path/to/skills/skills/gitlab-commit-message"
-  ]
-}
+# 方式1: 安装为全局斜杠命令
+mkdir -p ~/.claude/commands
+cp /path/to/skills/skills/gitlab-commit-message/SKILL.md ~/.claude/commands/gitlab-commit-message.md
+
+# 方式2: 安装为项目级斜杠命令
+mkdir -p .claude/commands
+cp /path/to/skills/skills/gitlab-commit-message/SKILL.md .claude/commands/gitlab-commit-message.md
 ```
 
 ### Cursor
@@ -168,6 +166,10 @@ claude config add skills /path/to/skills/skills/gitlab-commit-message
 
 将 skill 内容复制到 `.github/copilot-instructions.md` 文件中。
 
+### Codex CLI
+
+将 skill 内容追加到项目根目录的 `AGENTS.md` 文件中。
+
 ## 许可证
 
 MIT

package/lib/index.js

@@ -114,24 +114,22 @@ function getUsageHints(target, isGlobal) {
   const hints = {
     claude: {
       project: [
-        'Skills have been added to .claude/settings.local.json',
+        'Skills have been added to .claude/commands/',
         '',
         'Usage:',
         '  1. Start Claude Code in this directory:',
         '     $ claude',
-        '  2. Run /skills to see installed skills.',
-        '  3. Ask Claude to use the skill, e.g.:',
-        '     > Help me write a commit message',
+        '  2. Use the slash command to invoke a skill, e.g.:',
+        '     > /gitlab-commit-message',
       ],
       global: [
-        'Skills have been added to ~/.claude/settings.json',
+        'Skills have been added to ~/.claude/commands/',
         '',
         'Usage:',
         '  1. Start Claude Code anywhere:',
         '     $ claude',
-        '  2. Run /skills to see installed skills.',
-        '  3. Ask Claude to use the skill, e.g.:',
-        '     > Help me write a commit message',
+        '  2. Use the slash command to invoke a skill, e.g.:',
+        '     > /gitlab-commit-message',
       ],
     },
     cursor: {
@@ -184,20 +182,20 @@ function getUsageHints(target, isGlobal) {
     },
     codex: {
       project: [
-        'Skills have been added to codex.md in your project.',
+        'Skills have been appended to AGENTS.md in your project.',
         '',
         'Usage:',
         '  1. Run Codex CLI in this directory:',
         '     $ codex',
-        '  2. The skills will be automatically loaded.',
+        '  2. Codex will automatically follow the instructions in AGENTS.md.',
       ],
       global: [
-        'Skills have been added to ~/.codex/instructions.md',
+        'Skills have been appended to ~/.codex/AGENTS.md',
         '',
         'Usage:',
         '  1. Run Codex CLI anywhere:',
         '     $ codex',
-        '  2. The skills are globally available.',
+        '  2. Codex will automatically follow the global instructions.',
       ],
     },
     gemini: {

package/lib/installers/claude.js

@@ -1,45 +1,29 @@
 import fs from 'fs-extra';
 import path from 'path';
 import os from 'os';
-import { getSkillsDir } from '../index.js';
 
 /**
  * Claude Code 安装器
  *
- * Claude Code 使用 settings.json 中的 skills 数组来加载 skills
- * - 全局: ~/.claude/settings.json
- * - 项目级: .claude/settings.local.json
+ * 将 skill 安装为 Claude Code 自定义斜杠命令:
+ * - 全局: ~/.claude/commands/<skill-name>.md
+ * - 项目级: .claude/commands/<skill-name>.md
+ *
+ * 安装后用户可通过 /<skill-name> 调用对应 skill。
  */
 export async function installForClaude(skills, options = {}) {
   const { isGlobal = false } = options;
 
-  const settingsPath = isGlobal
-    ? path.join(os.homedir(), '.claude', 'settings.json')
-    : path.join(process.cwd(), '.claude', 'settings.local.json');
-
-  // 确保目录存在
-  await fs.ensureDir(path.dirname(settingsPath));
-
-  let settings = {};
-  if (await fs.pathExists(settingsPath)) {
-    try {
-      settings = await fs.readJson(settingsPath);
-    } catch {
-      settings = {};
-    }
-  }
+  const commandsDir = isGlobal
+    ? path.join(os.homedir(), '.claude', 'commands')
+    : path.join(process.cwd(), '.claude', 'commands');
 
-  // 初始化 skills 数组
-  if (!Array.isArray(settings.skills)) {
-    settings.skills = [];
-  }
+  await fs.ensureDir(commandsDir);
 
-  // 添加 skill 路径
   for (const skill of skills) {
-    if (!settings.skills.includes(skill.path)) {
-      settings.skills.push(skill.path);
-    }
+    const skillContent = await fs.readFile(skill.skillFile, 'utf-8');
+    const cleanContent = skillContent.replace(/^---\s*\n[\s\S]*?\n---\s*\n?/, '').trim();
+    const targetPath = path.join(commandsDir, `${skill.name}.md`);
+    await fs.writeFile(targetPath, cleanContent + '\n');
   }
-
-  await fs.writeJson(settingsPath, settings, { spaces: 2 });
 }

package/lib/installers/codex.js

@@ -5,16 +5,16 @@ import os from 'os';
 /**
  * OpenAI Codex CLI 安装器
  *
- * Codex 使用:
- * - 全局: ~/.codex/instructions.md
- * - 项目级: codex.md 或 AGENTS.md
+ * 将 skill 内容追加到 AGENTS.md:
+ * - 全局: ~/.codex/AGENTS.md
+ * - 项目级: AGENTS.md
  */
 export async function installForCodex(skills, options = {}) {
   const { isGlobal = false } = options;
 
   const targetPath = isGlobal
-    ? path.join(os.homedir(), '.codex', 'instructions.md')
-    : path.join(process.cwd(), 'codex.md');
+    ? path.join(os.homedir(), '.codex', 'AGENTS.md')
+    : path.join(process.cwd(), 'AGENTS.md');
 
   await fs.ensureDir(path.dirname(targetPath));
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cvte-skills-cli",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "CLI tool to install custom skills for AI coding assistants",
   "type": "module",
   "main": "lib/index.js",