yunxiao-code 1.1.1 → 1.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 yx-code contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -9,7 +9,7 @@
 - 📤 **推送代码** - 自动推送当前分支到远程
 - 🔀 **合并请求** - 快速创建 MR，支持指定目标分支
 - 📊 **代码差异** - 查看分支间的代码差异统计
-- 🤖 **Claude Code 集成** - 支持 Claude Code Skills/Commands 自动化工作流
+- 🤖 **AI Agent 集成** - 基于 Agent Skills 标准，兼容 Claude Code、Cursor 等 AI 编程工具
 
 ## 安装
 
@@ -26,7 +26,7 @@ npm install -g yunxiao-code
 ### 从源码编译
 
 ```bash
-git clone <repo-url>
+git clone https://github.com/ZLStream/yunxiao-code.git
 cd yunxiao-code
 make build-local
 sudo make install
@@ -39,6 +39,23 @@ go build -o yx-code ./cmd/yx-code
 sudo mv yx-code /usr/local/bin/
 ```
 
+#### 安装 AI Agent 插件（可选）
+
+如需使用斜杠命令，手动为每个 skill 创建软链接：
+
+```bash
+for dir in claude-plugin/skills/*/; do
+  ln -s "$(pwd)/$dir" ~/.claude/skills/"$(basename $dir)"
+done
+```
+
+安装后可在 Claude Code 或 Cursor Agent 中使用：
+- `/yx-commands-commit` - 分析代码变更并提交
+- `/yx-commands-push` - 推送代码
+- `/yx-commands-mr` - 创建合并请求
+- `/yx-commands-review` - 查看代码差异
+- `/yx-commands-commit-push-mr` - 一键完成完整工作流
+
 ## 系统要求
 
 - Go 1.26.1+（从源码编译时）
@@ -233,29 +250,36 @@ yx-code mr -m "添加用户登录功能"
 yx-code diff
 ```
 
-## Claude Code 集成
+## AI Agent 集成
 
-本工具提供 Claude Code Skills/Commands 支持，可在 Claude Code 中通过斜杠命令自动化云效工作流。
+本工具基于 [Agent Skills](https://agentskills.io/) 开放标准，兼容 Claude Code、Cursor 等支持该标准的 AI 编程工具，可通过斜杠命令自动化云效工作流。
+
+### 兼容性
+
+| 工具 | 支持 | 说明 |
+|------|------|------|
+| [Claude Code](https://claude.ai/code) | ✅ | 原生支持，从 `~/.claude/skills/` 加载 |
+| [Cursor](https://cursor.com) | ✅ | 兼容加载 `~/.claude/skills/` 目录 |
 
 ### 可用命令
 
 | 命令 | 功能 |
 |------|------|
-| `/yx-commands:commit` | 分析代码变更并提交 |
-| `/yx-commands:push` | 推送代码到远程 |
-| `/yx-commands:mr` | 创建合并请求 |
-| `/yx-commands:review` | 查看分支代码差异 |
-| `/yx-commands:commit-push-mr` | 一键完成提交、推送、创建MR |
+| `/yx-commands-commit` | 分析代码变更并提交 |
+| `/yx-commands-push` | 推送代码到远程 |
+| `/yx-commands-mr` | 创建合并请求 |
+| `/yx-commands-review` | 查看分支代码差异 |
+| `/yx-commands-commit-push-mr` | 一键完成提交、推送、创建MR |
 
 ### 使用示例
 
-在 Claude Code 中直接输入命令：
+在 Claude Code 或 Cursor Agent 中直接输入命令：
 
 ```
-/yx-commands:commit-push-mr
+/yx-commands-commit-push-mr
 ```
 
-Claude 会自动：
+AI 会自动：
 1. 分析代码变更
 2. 生成 commit message
 3. 执行 commit、push
@@ -263,7 +287,19 @@ Claude 会自动：
 
 ### 安装
 
-npm 安装后自动部署到 `~/.claude/commands/yx-commands/` 和 `~/.claude/skills/yx-commands/`。
+npm 安装后自动将每个 skill 部署为独立符号链接到 `~/.claude/skills/`：
+
+```
+~/.claude/skills/
+├── yx-commands/              ← 主 skill（工作流路由）
+├── yx-commands-commit/       ← 提交命令
+├── yx-commands-push/         ← 推送命令
+├── yx-commands-mr/           ← 创建 MR
+├── yx-commands-review/       ← 代码审查
+└── yx-commands-commit-push-mr/ ← 一键完整工作流
+```
+
+Cursor 会自动从 `~/.claude/skills/` 加载，无需额外配置。
 
 ## 相关链接
 

package/claude-plugin/skills/{SKILL.md → yx-commands/SKILL.md}

@@ -18,39 +18,39 @@ tools: Bash, Read
 2. **Git 操作** - 提交、推送
 3. **yx-code 工具** - 提到云效 CLI
 4. **复合工作流** - 用户说"提交合并"、"提交并合并"、"提交MR"时，按顺序执行：
-   - 先执行 `/yx-commands:commit` 提交代码
-   - 再执行 `/yx-commands:push` 推送到远程
-   - 然后执行 `/yx-commands:mr` 创建合并请求
+   - 先执行 `/yx-commands-commit` 提交代码
+   - 再执行 `/yx-commands-push` 推送到远程
+   - 然后执行 `/yx-commands-mr` 创建合并请求
 
 ## 可用命令
 
 | 命令 | 功能 | 典型用法 |
 |------|------|----------|
-| `/yx-commands:commit` | 智能提交 | 分析变更生成 commit |
-| `/yx-commands:push` | 推送代码 | 推送到远程 |
-| `/yx-commands:mr` | 创建 MR | 提交合并请求（默认 develop） |
-| `/yx-commands:review` | 代码审查 | 查看分支差异 |
-| `/yx-commands:commit-push-mr` | 完整工作流 | 一键完成提交、推送、创建MR |
+| `/yx-commands-commit` | 智能提交 | 分析变更生成 commit |
+| `/yx-commands-push` | 推送代码 | 推送到远程 |
+| `/yx-commands-mr` | 创建 MR | 提交合并请求（默认 develop） |
+| `/yx-commands-review` | 代码审查 | 查看分支差异 |
+| `/yx-commands-commit-push-mr` | 完整工作流 | 一键完成提交、推送、创建MR |
 
 ## 典型工作流
 
 ### 一键完成（推荐）
 ```
 1. 编写代码...
-2. /yx-commands:commit-push-mr  → 一键完成提交、推送、创建MR
+2. /yx-commands-commit-push-mr  → 一键完成提交、推送、创建MR
 ```
 
 ### 分步执行
 ```
 1. 编写代码...
-2. /yx-commands:commit   → 智能生成 commit message 并提交
-3. /yx-commands:push     → 推送到远程
-4. /yx-commands:mr       → 创建合并请求
+2. /yx-commands-commit   → 智能生成 commit message 并提交
+3. /yx-commands-push     → 推送到远程
+4. /yx-commands-mr       → 创建合并请求
 ```
 
 ### 代码审查
 ```
-/yx-commands:review -t develop -s feature-branch
+/yx-commands-review -t develop -s feature-branch
 ```
 
 ## 前置条件

package/claude-plugin/{commands/commit.md → skills/yx-commands-commit/SKILL.md}

@@ -1,5 +1,5 @@
 ---
-name: commit
+name: yx-commands-commit
 description: 分析代码变更并提交到云效仓库
 ---
 
@@ -31,4 +31,4 @@ git diff HEAD
 yx-code commit -m "<生成的commit-message>"
 ```
 
-如果用户提供了特定的 commit message，则使用用户提供的。
+如果用户提供了特定的 commit message，则使用用户提供的。

package/claude-plugin/{commands/commit-push-mr.md → skills/yx-commands-commit-push-mr/SKILL.md}

@@ -1,5 +1,5 @@
 ---
-name: commit-push-mr
+name: yx-commands-commit-push-mr
 description: 一键完成提交、推送、创建合并请求（完整工作流）
 ---
 
@@ -35,4 +35,4 @@ yx-code mr -m "<mr-title>"
 **注意：**
 - 如果用户提供了特定的 commit message，则使用用户提供的
 - MR 标题默认使用 commit message
-- 目标分支默认为 develop，可通过参数指定
+- 目标分支默认为 develop，可通过参数指定

package/claude-plugin/{commands/mr.md → skills/yx-commands-mr/SKILL.md}

@@ -1,5 +1,5 @@
 ---
-name: mr
+name: yx-commands-mr
 description: 创建云效合并请求(Merge Request)
 ---
 
@@ -75,4 +75,4 @@ yx-code mr -m "feat: 添加用户登录功能" -d "实现了登录、登出功
 - 合并请求 ID
 - 合并请求 URL 链接
 
-用户可在浏览器中访问链接进行代码审查和合并操作。
+用户可在浏览器中访问链接进行代码审查和合并操作。

package/claude-plugin/{commands/push.md → skills/yx-commands-push/SKILL.md}

@@ -1,5 +1,5 @@
 ---
-name: push
+name: yx-commands-push
 description: 推送代码到云效远程仓库
 ---
 
@@ -27,4 +27,4 @@ yx-code push
 4. **如果推送失败且提示无上游分支**，自动设置上游并重试：
 ```bash
 yx-code push -u origin HEAD
-```
+```

package/claude-plugin/{commands/review.md → skills/yx-commands-review/SKILL.md}

@@ -22,17 +22,25 @@ disable-model-invocation: false
 yx-code diff --target <target> --source <source>
 ```
 
-### 步骤 2: 收集上下文信息
+### 步骤 2: 展示代码差异
 
-使用 Haiku agent 收集以下信息：
+将 yx-code diff 的完整输出直接展示给用户，包括：
+- 变更统计摘要（文件数、新增行数、删除行数）
+- 每个变更文件的完整 diff 内容
+
+保留原始的 diff 代码块格式，让用户能直接阅读代码差异。
+
+### 步骤 3: 收集上下文信息
+
+使用轻量级 agent 收集以下信息：
 
 1. **获取 CLAUDE.md 文件列表**：查找项目根目录及变更文件所在目录的 CLAUDE.md 文件
 2. **获取变更摘要**：分析差异内容，返回变更的简要总结
 3. **检查审查资格**：确认分支是否需要进行代码审查（排除已关闭、草稿、自动生成等）
 
-### 步骤 3: 并行代码审查
+### 步骤 4: 并行代码审查
 
-启动 5 个并行的 Sonnet agent 独立进行代码审查：
+启动 5 个并行 agent 独立进行代码审查：
 
 **Agent #1: CLAUDE.md 合规审查**
 - 检查变更是否遵循项目 CLAUDE.md 中的规范
@@ -60,9 +68,9 @@ yx-code diff --target <target> --source <source>
 - 确保变更遵循注释中的指导
 - 返回问题列表及原因（代码注释合规性）
 
-### 步骤 4: 问题置信度评分
+### 步骤 5: 问题置信度评分
 
-对步骤 3 发现的每个问题，启动并行 Haiku agent 进行置信度评分：
+对步骤 4 发现的每个问题，启动并行轻量级 agent 进行置信度评分：
 
 **评分标准（0-100 分）**：
 
@@ -74,7 +82,7 @@ yx-code diff --target <target> --source <source>
 | 75 | 高度确信。验证了这是很可能在现实中发生的真正问题。当前方案不充分。问题很重要，直接影响功能，或在 CLAUDE.md 中明确提及 |
 | 100 | 绝对确定。验证了这是肯定会在现实中频繁发生的真正问题。证据直接确认 |
 
-### 步骤 5: 过滤并输出结果
+### 步骤 6: 过滤并输出结果
 
 1. **过滤问题**：仅保留评分 >= 80 的问题
 2. **重新检查资格**：确认分支仍符合审查条件
@@ -83,7 +91,7 @@ yx-code diff --target <target> --source <source>
 ### 使用方式
 
 ```
-/yx-commands:review [-t target] [-s source]
+/yx-commands-review [-t target] [-s source]
 ```
 
 参数：
@@ -94,12 +102,12 @@ yx-code diff --target <target> --source <source>
 
 查看与 develop 的差异：
 ```
-/yx-commands:review
+/yx-commands-review
 ```
 
 查看 feature 分支与 main 的差异：
 ```
-/yx-commands:review -t main -s feature-branch
+/yx-commands-review -t main -s feature-branch
 ```
 
 ### 输出格式
@@ -160,4 +168,4 @@ https://<云效域名>/<项目路径>/blob/<完整sha1>/<文件路径>#L<起始
 - 目标分支需要存在于远程
 - 不检查构建信号，不尝试构建或类型检查
 - 大量变更时输出可能较长
-- 对于复杂文件，优先使用 yx-code diff 获取准确差异
+- 对于复杂文件，优先使用 yx-code diff 获取准确差异

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yunxiao-code",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "阿里云云效 CLI 工具",
   "keywords": [
     "aliyun",
@@ -11,6 +11,14 @@
     "git",
     "代码"
   ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ZLStream/yunxiao-code.git"
+  },
+  "homepage": "https://github.com/ZLStream/yunxiao-code#readme",
+  "bugs": {
+    "url": "https://github.com/ZLStream/yunxiao-code/issues"
+  },
   "bin": {
     "yx-code": "bin/yx-code.js"
   },

package/scripts/postinstall.js

@@ -23,43 +23,55 @@ function removeExisting(target) {
 
 function deployPlugin() {
   const claudeDir = path.join(os.homedir(), '.claude');
-  const commandsDir = path.join(claudeDir, 'commands');
   const skillsDir = path.join(claudeDir, 'skills');
 
   // 获取 npm 包路径
   const packageDir = path.dirname(require.main.filename);
   const pluginDir = path.join(packageDir, '..', 'claude-plugin');
+  const skillsSource = path.join(pluginDir, 'skills');
 
   // 确保目标目录存在
-  if (!fs.existsSync(commandsDir)) {
-    fs.mkdirSync(commandsDir, { recursive: true });
-  }
   if (!fs.existsSync(skillsDir)) {
     fs.mkdirSync(skillsDir, { recursive: true });
   }
 
-  const commandsTarget = path.join(commandsDir, 'yx-commands');
-  const skillsTarget = path.join(skillsDir, 'yx-commands');
-  const commandsSource = path.join(pluginDir, 'commands');
-  const skillsSource = path.join(pluginDir, 'skills');
+  // 清理旧的 commands 软链接（如果存在）
+  const oldCommandsTarget = path.join(claudeDir, 'commands', 'yx-commands');
+  removeExisting(oldCommandsTarget);
 
-  // 创建/更新 commands 软链接
-  if (fs.existsSync(commandsSource)) {
-    if (removeExisting(commandsTarget)) {
-      fs.symlinkSync(commandsSource, commandsTarget);
-      console.log('✅ 已链接 commands 到 ~/.claude/commands/yx-commands/');
+  // 清理旧版本的单一 skills 软链接（指向整个 skills 目录的）
+  const oldSkillsTarget = path.join(skillsDir, 'yx-commands');
+  try {
+    const linkTarget = fs.readlinkSync(oldSkillsTarget);
+    if (linkTarget === skillsSource || linkTarget.endsWith('/claude-plugin/skills')) {
+      removeExisting(oldSkillsTarget);
     }
+  } catch (e) { /* not a symlink or doesn't exist */ }
+
+  if (!fs.existsSync(skillsSource)) {
+    console.log('⚠️  skills 目录不存在:', skillsSource);
+    return;
   }
 
-  // 创建/更新 skills 软链接
-  if (fs.existsSync(skillsSource)) {
-    if (removeExisting(skillsTarget)) {
-      fs.symlinkSync(skillsSource, skillsTarget);
-      console.log('✅ 已链接 skills 到 ~/.claude/skills/yx-commands/');
+  // 为每个 skill 子目录单独创建符号链接
+  const entries = fs.readdirSync(skillsSource, { withFileTypes: true });
+  const linked = [];
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const source = path.join(skillsSource, entry.name);
+    const target = path.join(skillsDir, entry.name);
+    if (removeExisting(target)) {
+      fs.symlinkSync(source, target);
+      linked.push(entry.name);
     }
   }
 
-  console.log('\n可用命令: /yx-commands:commit, /yx-commands:push, /yx-commands:mr, /yx-commands:review\n');
+  if (linked.length > 0) {
+    console.log('✅ 已链接 ' + linked.length + ' 个 skills 到 ~/.claude/skills/');
+    linked.forEach(name => console.log('   - ' + name));
+  }
+
+  console.log('\n可用命令: /yx-commands-commit, /yx-commands-push, /yx-commands-mr, /yx-commands-review, /yx-commands-commit-push-mr\n');
 }
 
 console.log('\n✅ yx-code CLI installed successfully!\n');