yunxiao-code 1.0.0 → 1.0.2

package/README.md

@@ -1,4 +1,4 @@
-# yunxiao-code
+# yx-code
 
 阿里云云效 CLI 工具，支持 Git 提交、推送、克隆及创建合并请求。
 
@@ -7,16 +7,16 @@
 ### npm 安装（推荐）
 
 ```bash
-npm install -g yunxiao-code
+npm install -g yx-code
 ```
 
 ### 从源码编译
 
 ```bash
 git clone <repo-url>
-cd yunxiao-code
-go build -o yunxiao-code .
-sudo mv yunxiao-code /usr/local/bin/
+cd yx-code
+go build -o yx-code .
+sudo mv yx-code /usr/local/bin/
 ```
 
 ## 配置
@@ -26,7 +26,7 @@ sudo mv yunxiao-code /usr/local/bin/
 在你的项目目录下运行：
 
 ```bash
-yunxiao-code init
+yx-code init
 ```
 
 会在当前目录生成 `.yunxiao.yaml`：
@@ -71,7 +71,7 @@ export YUNXIAO_TOKEN="your-token"
 ### 克隆仓库并创建新分支
 
 ```bash
-yunxiao-code clone <git-url> -b <分支名>
+yx-code clone <git-url> -b <分支名>
 ```
 
 自动检测主分支（main/master），从主分支拉出新分支。
@@ -82,7 +82,7 @@ yunxiao-code clone <git-url> -b <分支名>
 ### 提交代码
 
 ```bash
-yunxiao-code commit -m "提交信息"
+yx-code commit -m "提交信息"
 ```
 
 执行 `git add .` 并提交。
@@ -90,7 +90,7 @@ yunxiao-code commit -m "提交信息"
 ### 推送到远程
 
 ```bash
-yunxiao-code push
+yx-code push
 ```
 
 推送当前分支到远程仓库。
@@ -98,7 +98,7 @@ yunxiao-code push
 ### 创建合并请求
 
 ```bash
-yunxiao-code mr -m "MR 标题"
+yx-code mr -m "MR 标题"
 ```
 
 向云效创建合并请求，目标分支为 `develop`。
@@ -111,5 +111,5 @@ yunxiao-code mr -m "MR 标题"
 所有子命令支持以下参数，用于覆盖配置文件：
 
 ```bash
-yunxiao-code <command> --domain <域名> --org <组织ID> --token <令牌>
+yx-code <command> --domain <域名> --org <组织ID> --token <令牌>
 ```

package/bin/{yunxiao-code.js → yx-code.js}

@@ -8,11 +8,11 @@ const arch = os.arch();
 
 let binary;
 if (platform === 'darwin' && arch === 'arm64') {
-  binary = 'yunxiao-code-darwin-arm64';
+  binary = 'yx-code-darwin-arm64';
 } else if (platform === 'darwin' && arch === 'x64') {
-  binary = 'yunxiao-code-darwin-amd64';
+  binary = 'yx-code-darwin-amd64';
 } else if (platform === 'linux' && arch === 'x64') {
-  binary = 'yunxiao-code-linux-amd64';
+  binary = 'yx-code-linux-amd64';
 } else {
   console.error(`Unsupported platform: ${platform}/${arch}`);
   process.exit(1);

package/package.json

@@ -1,12 +1,17 @@
 {
   "name": "yunxiao-code",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "阿里云云效 CLI 工具",
   "bin": {
-    "yunxiao-code": "./bin/yunxiao-code.js"
+    "yunxiao-code": "./bin/yx-code.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
   },
   "files": [
-    "bin"
+    "bin",
+    "scripts",
+    "skills"
   ],
   "license": "MIT",
   "engines": {

package/scripts/postinstall.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const CLAUDE_DIR = path.join(os.homedir(), '.claude');
+const COMMANDS_DIR = path.join(CLAUDE_DIR, 'commands', 'yx-commands');
+const SKILLS_DIR = path.join(CLAUDE_DIR, 'skills', 'yx-workflow');
+
+// 获取 npm 包安装目录
+const packageDir = path.resolve(__dirname, '..');
+const skillsSourceDir = path.join(packageDir, 'skills');
+
+console.log('\n🔧 Installing yunxiao-code Claude Code integration...\n');
+
+// 确保目录存在
+function ensureDir(dir) {
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+    console.log(`  ✓ Created directory: ${dir}`);
+  }
+}
+
+// 复制目录
+function copyDir(src, dest) {
+  ensureDir(path.dirname(dest));
+
+  if (fs.existsSync(dest)) {
+    fs.rmSync(dest, { recursive: true });
+  }
+
+  fs.cpSync(src, dest, { recursive: true });
+  console.log(`  ✓ Installed: ${dest}`);
+}
+
+// 安装命令
+function installCommands() {
+  const commandsSource = path.join(skillsSourceDir, 'yx-commands');
+
+  if (fs.existsSync(commandsSource)) {
+    copyDir(commandsSource, COMMANDS_DIR);
+    console.log(`  📦 Commands installed to ~/.claude/commands/yx-commands/`);
+  }
+}
+
+// 安装 skills
+function installSkills() {
+  const skillSource = path.join(skillsSourceDir, 'skills', 'yx-workflow');
+
+  if (fs.existsSync(skillSource)) {
+    copyDir(skillSource, SKILLS_DIR);
+    console.log(`  📦 Skill installed to ~/.claude/skills/yx-workflow/`);
+  }
+}
+
+// 主流程
+try {
+  ensureDir(CLAUDE_DIR);
+  ensureDir(path.join(CLAUDE_DIR, 'commands'));
+  ensureDir(path.join(CLAUDE_DIR, 'skills'));
+
+  installCommands();
+  installSkills();
+
+  console.log('\n✅ yunxiao-code Claude Code integration installed successfully!\n');
+  console.log('Available commands:');
+  console.log('  /yx-commands:init     - 初始化云效配置');
+  console.log('  /yx-commands:clone    - 克隆仓库');
+  console.log('  /yx-commands:commit   - 提交代码');
+  console.log('  /yx-commands:push     - 推送代码');
+  console.log('  /yx-commands:mr       - 创建合并请求');
+  console.log('\nRun /reload-plugins or restart Claude Code to activate.\n');
+} catch (error) {
+  console.error('❌ Installation failed:', error.message);
+  process.exit(1);
+}

package/skills/.claude-plugin/plugin.json

@@ -0,0 +1,10 @@
+{
+  "name": "yunxiao-code",
+  "description": "云效代码仓库工作流自动化 - 初始化配置、克隆仓库、提交代码、推送、创建合并请求",
+  "author": {
+    "name": "yunxiao-code"
+  },
+  "skills": {
+    "yx-workflow": "skills/yx-workflow/SKILL.md"
+  }
+}

package/skills/README.md

@@ -0,0 +1,100 @@
+# Yunxiao Code - Claude Code Plugin
+
+云效代码仓库工作流自动化插件，为 Claude Code 提供云效相关命令支持。
+
+## 安装
+
+```bash
+npm install -g yunxiao-code
+```
+
+安装完成后，会自动：
+1. 安装 `yunxiao-code` CLI 工具到系统 PATH
+2. 安装 Claude Code 命令到 `~/.claude/commands/yx-commands/`
+3. 安装 Claude Code 技能到 `~/.claude/skills/yx-workflow/`
+
+重启 Claude Code 或执行 `/reload-plugins` 后即可使用。
+
+## 可用命令
+
+| 命令 | 功能 | 示例 |
+|------|------|------|
+| `/yx-commands:init` | 初始化云效配置 | `/yx-commands:init` |
+| `/yx-commands:clone` | 克隆仓库 | `/yx-commands:clone <git-url>` |
+| `/yx-commands:commit` | 提交代码 | `/yx-commands:commit` |
+| `/yx-commands:push` | 推送代码 | `/yx-commands:push` |
+| `/yx-commands:mr` | 创建合并请求 | `/yx-commands:mr <title>` |
+
+## 使用指南
+
+### 1. 初始化配置
+
+首次使用需要配置云效凭证：
+
+```
+/yx-commands:init
+```
+
+按提示填写：
+- `organization_id`: 云效组织 ID
+- `token`: 云效个人访问令牌
+
+### 2. 克隆仓库
+
+克隆云效代码仓库：
+
+```
+/yx-commands:clone https://codeup.aliyun.com/your-org/your-repo.git
+```
+
+### 3. 提交代码
+
+自动分析变更并提交：
+
+```
+/yx-commands:commit
+```
+
+### 4. 推送代码
+
+推送当前分支到远程：
+
+```
+/yx-commands:push
+```
+
+### 5. 创建合并请求
+
+创建 MR 到 develop 分支：
+
+```
+/yx-commands:mr "添加用户登录功能"
+```
+
+## 技能触发
+
+当对话中出现以下关键词时，`yx-workflow` 技能会自动激活：
+
+- 云效
+- 合并请求
+- MR
+- yx-code
+- 阿里云代码仓库
+
+## 手动安装（可选）
+
+如果需要手动安装命令和技能：
+
+```bash
+# 安装命令
+mkdir -p ~/.claude/commands/yx-commands
+cp -r skills/yx-commands/*.md ~/.claude/commands/yx-commands/
+
+# 安装技能
+mkdir -p ~/.claude/skills/yx-workflow
+cp -r skills/skills/yx-workflow ~/.claude/skills/
+```
+
+## 许可证
+
+MIT License

package/skills/skills/yx-workflow/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: yx-workflow
+description: 云效代码仓库工作流自动化助手
+triggers:
+  - 云效
+  - 合并请求
+  - MR
+  - yx-code
+  - 阿里云代码仓库
+  - 阿里云云效
+---
+
+# 云效代码仓库工作流
+
+我是一个帮助你在云效代码仓库进行开发的助手。我可以帮助你：
+
+## 可用命令
+
+| 命令 | 功能 | 用法 |
+|------|------|------|
+| `/yx-init` | 初始化云效配置 | 直接运行，配置 token |
+| `/yx-clone` | 克隆仓库 | `/yx-clone <git-url> [-b branch] [-p path]` |
+| `/yx-commit` | 提交代码 | 自动分析变更生成 commit message |
+| `/yx-push` | 推送代码 | 推送当前分支到远程 |
+| `/yx-mr` | 创建合并请求 | `/yx-mr <title> [-d description]` |
+
+## 典型工作流
+
+1. **初始化配置**
+   ```
+   /yx-init
+   ```
+   首次使用需要配置云效的 organization_id 和 token。
+
+2. **克隆仓库**
+   ```
+   /yx-clone https://codeup.aliyun.com/xxx/xxx.git
+   ```
+
+3. **提交代码**
+   ```
+   /yx-commit
+   ```
+   会自动分析变更并生成合适的 commit message。
+
+4. **推送代码**
+   ```
+   /yx-push
+   ```
+
+5. **创建合并请求**
+   ```
+   /yx-mr "添加新功能"
+   ```
+
+## 注意事项
+
+- 确保已安装 `yx-code` CLI 工具
+- 确保 `yx-code` 在系统 PATH 中可用
+- MR 默认合并到 develop 分支
+
+## 相关链接
+
+- [云效控制台](https://devops.aliyun.com/)
+- [云效文档](https://help.aliyun.com/product/153293.html)

package/skills/yx-commands/clone.md

@@ -0,0 +1,18 @@
+---
+name: clone
+description: 克隆云效代码仓库
+---
+
+根据用户提供的参数执行克隆操作。
+
+**参数说明：**
+- 第一个参数是云效仓库的 Git URL（必填）
+- `-b` 参数指定分支名（可选）
+- `-p` 参数指定本地路径（可选）
+
+如果用户没有提供 git-url，请询问用户提供仓库地址。
+
+执行命令示例：
+```bash
+yx-code clone <git-url> [-b <branch>] [-p <path>]
+```

package/skills/yx-commands/commit.md

@@ -0,0 +1,44 @@
+---
+name: commit
+description: 分析代码变更并提交到云效仓库
+---
+
+分析当前的代码变更并提交。
+
+**步骤：**
+
+1. 首先查看当前变更状态：
+```bash
+git status
+```
+
+2. 查看变更统计：
+```bash
+git diff --stat
+```
+
+3. 如果有暂存的变更，查看具体内容：
+```bash
+git diff --cached
+```
+
+4. 如果没有暂存的变更但有未暂存的变更，查看：
+```bash
+git diff
+```
+
+5. 分析变更后，根据变更内容生成合适的 commit message，格式遵循 Conventional Commits：
+- `feat:` 新功能
+- `fix:` 修复 bug
+- `refactor:` 重构
+- `docs:` 文档变更
+- `style:` 代码格式
+- `test:` 测试
+- `chore:` 构建/工具
+
+6. 执行提交：
+```bash
+yx-code commit -m "<生成的commit-message>"
+```
+
+如果用户提供了特定的 commit message，则使用用户提供的。

package/skills/yx-commands/init.md

@@ -0,0 +1,20 @@
+---
+name: init
+description: 初始化云效配置文件
+---
+
+请执行以下命令初始化云效配置：
+
+```bash
+yx-code init
+```
+
+执行后，配置文件将创建在 `~/.yunxiao-code/config.json`。
+
+你需要填写以下信息：
+- `organization_id`: 云效组织 ID
+- `token`: 云效个人访问令牌
+
+获取方式：
+1. organization_id: 在云效控制台 URL 中可以找到，格式如 `https://devops.aliyun.com/organization/{organization_id}/...`
+2. token: 在云效控制台 -> 个人设置 -> 个人访问令牌 中创建

package/skills/yx-commands/mr.md

@@ -0,0 +1,25 @@
+---
+name: mr
+description: 创建云效合并请求(Merge Request)
+---
+
+创建合并请求到 develop 分支。
+
+**步骤：**
+
+1. 首先显示当前分支和仓库信息：
+```bash
+git branch --show-current
+git remote -v | head -1
+```
+
+2. 获取合并请求标题（必填）和描述（可选）
+   - 如果用户没有提供标题，请询问用户提供合并请求的标题
+   - 描述是可选的，用户可以补充详细说明
+
+3. 执行创建 MR：
+```bash
+yx-code mr -m "<title>" [-d "<description>"]
+```
+
+创建成功后，会返回合并请求的 URL 链接，用户可以在浏览器中查看。

package/skills/yx-commands/push.md

@@ -0,0 +1,20 @@
+---
+name: push
+description: 推送代码到云效远程仓库
+---
+
+推送代码到远程仓库。
+
+**步骤：**
+
+1. 首先显示当前分支信息：
+```bash
+git branch --show-current
+```
+
+2. 执行推送：
+```bash
+yx-code push
+```
+
+如果推送失败，可能需要先设置上游分支。在这种情况下，提示用户是否需要设置上游分支并重试。