yunxiao-code 1.0.10 → 1.1.1

package/README.md

@@ -9,6 +9,7 @@
 - 📤 **推送代码** - 自动推送当前分支到远程
 - 🔀 **合并请求** - 快速创建 MR，支持指定目标分支
 - 📊 **代码差异** - 查看分支间的代码差异统计
+- 🤖 **Claude Code 集成** - 支持 Claude Code Skills/Commands 自动化工作流
 
 ## 安装
 
@@ -165,7 +166,7 @@ yx-code mr -m "<title>" [flags]
 yx-code mr -m "添加用户登录功能"
 
 # 指定目标分支
-yx-code mr -m "添加用户登录功能" -t main
+yx-code mr -m "添加用户登录功能" -t develop
 
 # 带描述
 yx-code mr -m "添加用户登录功能" -d "实现用户登录、注销功能"
@@ -232,6 +233,38 @@ yx-code mr -m "添加用户登录功能"
 yx-code diff
 ```
 
+## Claude Code 集成
+
+本工具提供 Claude Code Skills/Commands 支持，可在 Claude Code 中通过斜杠命令自动化云效工作流。
+
+### 可用命令
+
+| 命令 | 功能 |
+|------|------|
+| `/yx-commands:commit` | 分析代码变更并提交 |
+| `/yx-commands:push` | 推送代码到远程 |
+| `/yx-commands:mr` | 创建合并请求 |
+| `/yx-commands:review` | 查看分支代码差异 |
+| `/yx-commands:commit-push-mr` | 一键完成提交、推送、创建MR |
+
+### 使用示例
+
+在 Claude Code 中直接输入命令：
+
+```
+/yx-commands:commit-push-mr
+```
+
+Claude 会自动：
+1. 分析代码变更
+2. 生成 commit message
+3. 执行 commit、push
+4. 创建合并请求
+
+### 安装
+
+npm 安装后自动部署到 `~/.claude/commands/yx-commands/` 和 `~/.claude/skills/yx-commands/`。
+
 ## 相关链接
 
 - [阿里云云效官方文档](https://help.aliyun.com/zh/yunxiao/)

package/claude-plugin/commands/commit-push-mr.md

@@ -0,0 +1,38 @@
+---
+name: commit-push-mr
+description: 一键完成提交、推送、创建合并请求（完整工作流）
+---
+
+依次执行 commit、push、mr，完成从代码变更到合并请求的完整工作流。
+
+**步骤：**
+
+1. 查看当前变更状态：
+```bash
+git status && git diff --stat HEAD
+```
+
+2. 查看完整差异内容：
+```bash
+git diff HEAD
+```
+
+3. 分析变更后生成 commit message，执行提交：
+```bash
+yx-code commit -m "<生成的commit-message>"
+```
+
+4. 推送到远程：
+```bash
+yx-code push
+```
+
+5. 创建合并请求：
+```bash
+yx-code mr -m "<mr-title>"
+```
+
+**注意：**
+- 如果用户提供了特定的 commit message，则使用用户提供的
+- MR 标题默认使用 commit message
+- 目标分支默认为 develop，可通过参数指定

package/claude-plugin/commands/commit.md

@@ -0,0 +1,34 @@
+---
+name: commit
+description: 分析代码变更并提交到云效仓库
+---
+
+分析当前的代码变更并提交。
+
+**步骤：**
+
+1. 一次性获取变更状态和差异概览：
+```bash
+git status && git diff --stat HEAD
+```
+
+2. 查看完整差异内容用于分析（包含已暂存和未暂存的所有变更）：
+```bash
+git diff HEAD
+```
+
+3. 分析变更后，根据变更内容生成合适的 commit message，格式遵循 Conventional Commits：
+- `feat:` 新功能
+- `fix:` 修复 bug
+- `refactor:` 重构
+- `docs:` 文档变更
+- `style:` 代码格式
+- `test:` 测试
+- `chore:` 构建/工具
+
+4. 执行提交：
+```bash
+yx-code commit -m "<生成的commit-message>"
+```
+
+如果用户提供了特定的 commit message，则使用用户提供的。

package/claude-plugin/commands/mr.md

@@ -0,0 +1,78 @@
+---
+name: mr
+description: 创建云效合并请求(Merge Request)
+---
+
+创建合并请求到目标分支。
+
+**重要：默认目标分支为 develop，执行前需用户确认。**
+
+## 前置条件
+
+- 当前分支已推送到远程（如未推送，先执行推送）
+- 工作区干净（无未提交变更）
+
+> **注意**：认证信息（organization_id、token）由 CLI 自动获取，无需手动配置。
+
+## 步骤
+
+1. **获取分支状态和提交信息**：
+```bash
+git branch --show-current && git log --oneline -3
+```
+
+如果分支未推送到远程，先推送：
+```bash
+git push -u origin HEAD
+```
+
+2. **确定 MR 信息**：
+   - 标题：优先使用用户提供的标题；如果用户未提供，从最近的 commit message 自动推导
+   - 目标分支：**默认为 develop**，除非用户明确指定其他分支
+
+3. **询问用户确认**：
+使用 AskUserQuestion 询问用户：
+- 问题："即将创建合并请求到分支 `<target_branch>`，是否继续？"
+- 选项：Yes / No
+
+4. **用户选择 Yes 后创建 MR**：
+```bash
+yx-code mr -m "<title>" [-d "<description>"] [-t "<target>"]
+```
+
+## 命令参数
+
+```
+yx-code mr [flags]
+
+Flags:
+  -m, --message string     MR 标题（必填）
+  -d, --description string MR 描述（可选）
+  -t, --target string      目标分支（默认: develop）
+  -h, --help               帮助信息
+```
+
+## 示例
+
+创建 MR 到默认分支（develop）：
+```bash
+yx-code mr -m "feat: 添加用户登录功能"
+```
+
+指定目标分支：
+```bash
+yx-code mr -m "feat: 添加用户登录功能" -t main
+```
+
+带描述创建：
+```bash
+yx-code mr -m "feat: 添加用户登录功能" -d "实现了登录、登出功能，包含单元测试" -t develop
+```
+
+## 创建后
+
+创建成功后会返回：
+- 合并请求 ID
+- 合并请求 URL 链接
+
+用户可在浏览器中访问链接进行代码审查和合并操作。

package/claude-plugin/commands/push.md

@@ -0,0 +1,30 @@
+---
+name: push
+description: 推送代码到云效远程仓库
+---
+
+推送代码到远程仓库。
+
+**重要：执行前需用户确认。**
+
+## 步骤
+
+1. **获取当前分支信息**：
+```bash
+git branch --show-current
+```
+
+2. **询问用户确认**：
+使用 AskUserQuestion 询问用户：
+- 问题："即将推送代码到远程仓库，是否继续？"
+- 选项：Yes / No
+
+3. **用户选择 Yes 后执行推送**：
+```bash
+yx-code push
+```
+
+4. **如果推送失败且提示无上游分支**，自动设置上游并重试：
+```bash
+yx-code push -u origin HEAD
+```

package/claude-plugin/commands/review.md

@@ -0,0 +1,163 @@
+---
+allowed-tools: Bash(yx-code diff:*), Bash(yx-code --help:*), Bash(git branch:*), Bash(git remote:*), Bash(git log:*), Bash(git show:*), Bash(git blame:*), Read, Grep, Glob
+description: 查看分支代码差异并进行代码审查
+disable-model-invocation: false
+---
+
+## Context
+
+- Current branch: !`git branch --show-current`
+- Remote: !`git remote -v`
+- Recent commits: !`git log --oneline -5`
+
+## Your task
+
+对当前分支与目标分支之间的代码差异进行全面的代码审查。
+
+### 步骤 1: 获取代码差异
+
+首先使用 yx-code 命令获取差异：
+
+```bash
+yx-code diff --target <target> --source <source>
+```
+
+### 步骤 2: 收集上下文信息
+
+使用 Haiku agent 收集以下信息：
+
+1. **获取 CLAUDE.md 文件列表**：查找项目根目录及变更文件所在目录的 CLAUDE.md 文件
+2. **获取变更摘要**：分析差异内容，返回变更的简要总结
+3. **检查审查资格**：确认分支是否需要进行代码审查（排除已关闭、草稿、自动生成等）
+
+### 步骤 3: 并行代码审查
+
+启动 5 个并行的 Sonnet agent 独立进行代码审查：
+
+**Agent #1: CLAUDE.md 合规审查**
+- 检查变更是否遵循项目 CLAUDE.md 中的规范
+- 注意 CLAUDE.md 是 Claude 编写代码的指南，审查时不一定所有条款都适用
+- 返回问题列表及原因（CLAUDE.md 合规性）
+
+**Agent #2: Bug 浅层扫描**
+- 专注于变更本身，不额外读取上下文
+- 关注明显的 Bug，避免小问题和吹毛求疵
+- 忽略可能的误报
+- 返回问题列表及原因（潜在 Bug）
+
+**Agent #3: 历史上下文审查**
+- 读取被修改代码的 git blame 和历史
+- 基于历史上下文识别潜在问题
+- 返回问题列表及原因（历史上下文）
+
+**Agent #4: 相关 MR 审查**
+- 查找之前修改过这些文件的 MR
+- 检查之前 MR 的评论是否适用于当前变更
+- 返回问题列表及原因（历史 MR 上下文）
+
+**Agent #5: 代码注释合规审查**
+- 读取被修改文件中的代码注释
+- 确保变更遵循注释中的指导
+- 返回问题列表及原因（代码注释合规性）
+
+### 步骤 4: 问题置信度评分
+
+对步骤 3 发现的每个问题，启动并行 Haiku agent 进行置信度评分：
+
+**评分标准（0-100 分）**：
+
+| 分数 | 含义 |
+|-----|------|
+| 0 | 完全不确信。这是经不起推敲的误报，或是已存在的问题 |
+| 25 | 有些确信。可能是真正的问题，但也可能是误报。如果是风格问题，相关 CLAUDE.md 中未明确指出 |
+| 50 | 中等确信。验证了这是真正的问题，但可能只是小问题或不常发生。相对于整个 MR，不太重要 |
+| 75 | 高度确信。验证了这是很可能在现实中发生的真正问题。当前方案不充分。问题很重要，直接影响功能，或在 CLAUDE.md 中明确提及 |
+| 100 | 绝对确定。验证了这是肯定会在现实中频繁发生的真正问题。证据直接确认 |
+
+### 步骤 5: 过滤并输出结果
+
+1. **过滤问题**：仅保留评分 >= 80 的问题
+2. **重新检查资格**：确认分支仍符合审查条件
+3. **输出审查报告**
+
+### 使用方式
+
+```
+/yx-commands:review [-t target] [-s source]
+```
+
+参数：
+- `-t, --target`: 目标分支（默认: develop）
+- `-s, --source`: 源分支（默认: 当前分支）
+
+### 示例
+
+查看与 develop 的差异：
+```
+/yx-commands:review
+```
+
+查看 feature 分支与 main 的差异：
+```
+/yx-commands:review -t main -s feature-branch
+```
+
+### 输出格式
+
+如果发现问题：
+
+---
+### MR Code Review
+
+发现 N 个问题：
+
+1. **<问题简要描述>** (CLAUDE.md 规定: "<相关条款>")
+
+<文件链接，包含完整 sha1 和行范围>
+
+2. **<问题简要描述>** (<其他原因>)
+
+<文件链接>
+
+---
+
+如果没有发现问题：
+
+---
+### MR Code Review
+
+未发现问题。已检查 Bug 和 CLAUDE.md 合规性。
+
+---
+
+### 链接格式要求
+
+链接到代码时使用以下格式：
+```
+https://<云效域名>/<项目路径>/blob/<完整sha1>/<文件路径>#L<起始行>-L<结束行>
+```
+
+要求：
+- 必须使用完整的 git sha（不能用 HEAD 等引用）
+- 文件名后使用 # 符号
+- 行范围格式: L[起始]-L[结束]
+- 至少包含上下文各 1 行（如评论第 5-6 行，应链接 L4-L7）
+
+### 误报示例（审查时排除）
+
+- 已存在的问题（非本次变更引入）
+- 看起来像 Bug 但实际不是
+- 资深工程师不会提出的吹毛求疵
+- Linter/TypeChecker/Compiler 会捕获的问题（导入、类型错误、格式问题）
+- 一般代码质量问题（测试覆盖、一般安全问题、文档）
+- CLAUDE.md 中提及但代码中明确静默的问题（如 lint ignore 注释）
+- 可能是有意的功能性变更
+- 真正的问题但不在用户修改的行上
+
+### 注意事项
+
+- 需要在 git 仓库目录中运行
+- 目标分支需要存在于远程
+- 不检查构建信号，不尝试构建或类型检查
+- 大量变更时输出可能较长
+- 对于复杂文件，优先使用 yx-code diff 获取准确差异

package/claude-plugin/skills/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: yx-commands
+description: 阿里云云效(codeup)代码仓库工作流自动化。功能包括：智能提交代码、推送、创建MR(合并请求)、代码审查、分支差异对比。触发场景：用户提到云效、codeup、阿里云代码仓库、yx-code工具；git地址以git@codeup.aliyun.com开头；需要提交代码并创建MR；说"提交合并"触发完整工作流。注意：github相关操作或纯git命令不要使用此技能。
+tools: Bash, Read
+---
+
+# 云效代码仓库工作流
+
+帮助用户在阿里云云效代码仓库平台进行开发工作流自动化。
+
+> **认证信息由 CLI 自动获取**，无需手动配置 organization_id 和 token。
+
+## 何时使用
+
+当用户涉及以下场景时，主动使用此 skill：
+
+1. **云效平台相关** - 提到云效、阿里云代码仓库、codeup、阿里云 DevOps、合并请求、MR、代码审查
+2. **Git 操作** - 提交、推送
+3. **yx-code 工具** - 提到云效 CLI
+4. **复合工作流** - 用户说"提交合并"、"提交并合并"、"提交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 |
+
+## 典型工作流
+
+### 一键完成（推荐）
+```
+1. 编写代码...
+2. /yx-commands:commit-push-mr  → 一键完成提交、推送、创建MR
+```
+
+### 分步执行
+```
+1. 编写代码...
+2. /yx-commands:commit   → 智能生成 commit message 并提交
+3. /yx-commands:push     → 推送到远程
+4. /yx-commands:mr       → 创建合并请求
+```
+
+### 代码审查
+```
+/yx-commands:review -t develop -s feature-branch
+```
+
+## 前置条件
+
+- 已安装 `yx-code` CLI 工具
+- `yx-code` 在系统 PATH 中可用

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yunxiao-code",
-  "version": "1.0.10",
+  "version": "1.1.1",
   "description": "阿里云云效 CLI 工具",
   "keywords": [
     "aliyun",
@@ -19,7 +19,8 @@
   },
   "files": [
     "bin",
-    "scripts"
+    "scripts",
+    "claude-plugin"
   ],
   "license": "MIT",
   "engines": {

package/scripts/postinstall.js

@@ -1,5 +1,67 @@
 #!/usr/bin/env node
 
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+function removeExisting(target) {
+  try {
+    const stat = fs.lstatSync(target);
+    if (stat.isSymbolicLink()) {
+      fs.unlinkSync(target);
+    } else if (stat.isDirectory()) {
+      fs.rmSync(target, { recursive: true });
+    } else {
+      fs.unlinkSync(target);
+    }
+    return true;
+  } catch (e) {
+    if (e.code === 'ENOENT') return true;
+    return false;
+  }
+}
+
+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');
+
+  // 确保目标目录存在
+  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 软链接
+  if (fs.existsSync(commandsSource)) {
+    if (removeExisting(commandsTarget)) {
+      fs.symlinkSync(commandsSource, commandsTarget);
+      console.log('✅ 已链接 commands 到 ~/.claude/commands/yx-commands/');
+    }
+  }
+
+  // 创建/更新 skills 软链接
+  if (fs.existsSync(skillsSource)) {
+    if (removeExisting(skillsTarget)) {
+      fs.symlinkSync(skillsSource, skillsTarget);
+      console.log('✅ 已链接 skills 到 ~/.claude/skills/yx-commands/');
+    }
+  }
+
+  console.log('\n可用命令: /yx-commands:commit, /yx-commands:push, /yx-commands:mr, /yx-commands:review\n');
+}
+
 console.log('\n✅ yx-code CLI installed successfully!\n');
 console.log('Usage:');
 console.log('  yx-code init     - 初始化云效配置');
@@ -7,4 +69,10 @@ console.log('  yx-code clone    - 克隆仓库');
 console.log('  yx-code commit   - 提交代码');
 console.log('  yx-code push     - 推送代码');
 console.log('  yx-code mr       - 创建合并请求');
-console.log('  yx-code review   - 代码审查\n');
+console.log('  yx-code diff     - 查看代码差异\n');
+
+try {
+  deployPlugin();
+} catch (err) {
+  console.log('⚠️  部署失败:', err.message, '\n');
+}