yunxiao-code 1.2.1 → 1.3.1

package/README.md

@@ -1,311 +1,219 @@
-# yx-code
+# yx-commands
 
-阿里云云效 CLI 工具，支持 Git 提交、推送、克隆及创建合并请求，让开发者可以在终端中完成日常开发工作流，无需打开浏览器。
+阿里云云效代码仓库 yx-commands Skills，基于 [Agent Skills](https://agentskills.io/) 开放标准，让 Claude Code、Cursor 等 AI 编程工具可以自动完成代码提交、推送、创建合并请求、工作项查询和工作总结等开发工作流。
 
 ## 功能特性
 
-- 🚀 **克隆仓库** - 支持从主分支自动创建新分支
-- 📝 **提交代码** - 一键 add + commit
-- 📤 **推送代码** - 自动推送当前分支到远程
-- 🔀 **合并请求** - 快速创建 MR，支持指定目标分支
-- 📊 **代码差异** - 查看分支间的代码差异统计
-- 🤖 **AI Agent 集成** - 基于 Agent Skills 标准，兼容 Claude Code、Cursor 等 AI 编程工具
+- 🤖 **智能提交** - AI 分析代码变更，自动生成 commit message
+- 📤 **自动推送** - 推送当前分支到远程仓库
+- 🔀 **创建 MR** - 自动创建合并请求，默认目标分支 develop
+- 📊 **代码审查** - 查看分支间的代码差异统计
+- ⚡ **一键工作流** - 提交 → 推送 → 创建 MR 一条龙完成
+- 📋 **工作项查询** - 列出我负责或参与的工作项，支持状态/角色/项目过滤
+- 📈 **工作总结** - 生成周报/月报/季报/年报，支持 JSON 输出供 AI 分析
 
 ## 安装
 
-### npm 安装（推荐）
-
 ```bash
 npm install -g yunxiao-code
 ```
 
-支持平台：
-- macOS (Intel/Apple Silicon)
-- Linux (x64)
-
-### 从源码编译
-
-```bash
-git clone https://github.com/ZLStream/yunxiao-code.git
-cd yunxiao-code
-make build-local
-sudo make install
-```
+安装后自动部署 skill 到 `~/.claude/skills/`，Claude Code 和 Cursor 会自动加载。
 
-或手动编译：
-
-```bash
-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+（从源码编译时）
-- Git CLI（运行时依赖）
-- Node.js 14+（npm 安装时）
+支持平台：macOS (Intel/Apple Silicon)、Linux (x64)
 
 ## 快速开始
 
-### 1. 初始化配置
+### 初始化配置
 
 ```bash
 yx-code init
 ```
 
-在当前目录生成 `.yunxiao.yaml` 配置文件：
+在 `~/.yunxiao/config.yaml` 生成全局配置文件，填写 `organization_id` 和 `token`：
 
 ```yaml
-# 云效合并请求 CLI 配置
 domain: openapi-rdc.aliyuncs.com
-organization_id: ""
-token: ""
+organization_id: "你的组织ID"
+token: "你的个人访问令牌"
 ```
 
-填写 `organization_id` 和 `token`（个人访问令牌）。
-
 > **获取 Token**: 云效控制台 → 个人设置 → 个人访问令牌 → 创建令牌
 
-### 2. 配置项说明
-
-| 字段 | 说明 | 默认值 |
-|------|------|--------|
-| `domain` | 云效 API 域名 | `openapi-rdc.aliyuncs.com` |
-| `organization_id` | 组织 ID（必填） | 无 |
-| `token` | 个人访问令牌（必填） | 无 |
+> **user_id 无需手动配置**，首次使用工作项功能时会通过 token 自动获取并缓存。
 
-### 3. 环境变量配置
+### 一键提交（推荐）
 
-也可以通过环境变量配置：
+开发完成后，直接输入：
 
-```bash
-export YUNXIAO_DOMAIN="openapi-rdc.aliyuncs.com"
-export YUNXIAO_ORGANIZATION_ID="your-org-id"
-export YUNXIAO_TOKEN="your-token"
 ```
-
-### 4. 配置优先级（从低到高）
-
-1. 默认值
-2. `.yunxiao.yaml` 配置文件（从当前目录向上逐级查找）
-3. 环境变量：`YUNXIAO_DOMAIN`、`YUNXIAO_ORGANIZATION_ID`、`YUNXIAO_TOKEN`
-4. CLI 参数：`--domain`、`--org`、`--token`
-
-## 命令参考
-
-### yx-code init
-
-初始化云效配置文件。
-
-```bash
-yx-code init
+/yx-commands-commit-push-mr
 ```
 
-### yx-code clone
+AI 自动完成：分析变更 → 提交 → 推送 → 创建 MR
 
-克隆云效代码仓库。
+### 生成周报
 
-```bash
-yx-code clone <git-url> [flags]
+```
+/yx-commands-summary
 ```
 
-| 参数 | 简写 | 必填 | 说明 |
-|------|------|------|------|
-| `<git-url>` | | 是 | Git 仓库地址 |
-| `--branch` | `-b` | 否 | 新分支名称，指定后会从主分支创建新分支 |
-| `--path` | `-p` | 否 | 克隆目标路径，默认从 URL 提取仓库名 |
+AI 获取工作项数据，自动生成工作总结。
 
-```bash
-# 基本克隆
-yx-code clone https://codeup.aliyun.com/your-org/your-repo.git
+## Skill 命令
 
-# 克隆并创建新分支
-yx-code clone https://codeup.aliyun.com/your-org/your-repo.git -b feature/new-feature
-```
+| 命令 | 功能 | 使用场景 |
+|------|------|----------|
+| `/yx-commands-commit` | 智能提交 | AI 分析变更生成 commit message |
+| `/yx-commands-push` | 推送代码 | 推送当前分支到远程 |
+| `/yx-commands-mr` | 创建 MR | 创建合并请求（默认目标 develop） |
+| `/yx-commands-review` | 代码审查 | 查看分支差异统计 |
+| `/yx-commands-commit-push-mr` | 完整工作流 | 一键完成提交、推送、创建 MR |
+| `/yx-commands-workitems` | 查询工作项 | 列出我负责/参与的工作项 |
+| `/yx-commands-summary` | 工作总结 | 生成周报/月报/季报/年报 |
 
-### yx-code commit
+## 典型工作流
 
-提交代码变更。
+### 一键完成
 
-```bash
-yx-code commit -m "<message>"
 ```
-
-| 参数 | 简写 | 必填 | 说明 |
-|------|------|------|------|
-| `--message` | `-m` | 是 | 提交信息 |
-
-```bash
-yx-code commit -m "feat: 添加用户登录功能"
+/yx-commands-commit-push-mr
 ```
 
-### yx-code push
+AI 会自动：
+1. 分析代码变更，生成 commit message
+2. 执行 `git add .` 和 `git commit`
+3. 推送到远程仓库
+4. 创建合并请求
 
-推送当前分支到远程仓库。
+### 分步执行
 
-```bash
-yx-code push
+```
+/yx-commands-commit     → AI 分析变更并提交
+/yx-commands-push       → 推送到远程
+/yx-commands-mr         → 创建合并请求
 ```
 
-### yx-code mr
+### 代码审查
 
-创建合并请求。
+查看当前分支与目标分支的差异：
 
-```bash
-yx-code mr -m "<title>" [flags]
+```
+/yx-commands-review
 ```
 
-| 参数 | 简写 | 必填 | 说明 |
-|------|------|------|------|
-| `--message` | `-m` | 是 | MR 标题 |
-| `--description` | `-d` | 否 | MR 描述 |
-| `--target` | `-t` | 否 | 目标分支，默认: develop |
+### 工作总结
 
 ```bash
-# 基本用法（目标分支默认 develop）
-yx-code mr -m "添加用户登录功能"
+# 交互式选择时间范围
+/yx-commands-summary
 
-# 指定目标分支
-yx-code mr -m "添加用户登录功能" -t develop
+# 指定时间周期
+yx-code summary --period week      # 本周
+yx-code summary --period month     # 本月
+yx-code summary --period quarter   # 本季度
+yx-code summary --period year      # 本年
 
-# 带描述
-yx-code mr -m "添加用户登录功能" -d "实现用户登录、注销功能"
-```
+# 自定义时间范围
+yx-code summary --start 2024-01-01 --end 2024-03-31
 
-### yx-code diff
+# JSON 格式输出（AI 友好）
+yx-code summary --period month --json
+```
 
-查看分支间的代码差异统计。
+### 工作项查询
 
 ```bash
-yx-code diff [flags]
-```
+# 列出我负责的进行中工作项（默认）
+yx-code workitems
 
-| 参数 | 简写 | 必填 | 说明 |
-|------|------|------|------|
-| `--target` | `-t` | 否 | 目标分支，默认: develop |
-| `--source` | `-s` | 否 | 源分支，默认: 当前分支 |
+# 按角色和状态过滤
+yx-code workitems --role participated --status all
+yx-code workitems --role assigned --status done
 
-```bash
-# 查看当前分支与 develop 的差异
-yx-code diff
+# 指定项目
+yx-code workitems --project <项目标识符>
 
-# 指定分支
-yx-code diff -t main -s feature/new-feature
+# JSON 格式输出
+yx-code workitems --json
 ```
 
-### 全局参数
+## 配置
 
-所有子命令支持以下全局参数，用于覆盖配置文件：
+### 配置文件
 
-```bash
-yx-code <command> --domain <域名> --org <组织ID> --token <令牌>
+配置统一存放在 `~/.yunxiao/config.yaml`：
+
+```yaml
+domain: openapi-rdc.aliyuncs.com
+organization_id: "你的组织ID"
+token: "你的个人访问令牌"
+user_id: ""  # 自动获取，无需手动填写
 ```
 
-| 参数 | 说明 |
-|------|------|
-| `--domain` | 云效 API 域名 |
-| `--org` | 组织 ID |
-| `--token` | 个人访问令牌 |
+| 字段 | 说明 | 默认值 |
+|------|------|--------|
+| `domain` | 云效 API 域名 | `openapi-rdc.aliyuncs.com` |
+| `organization_id` | 组织 ID（必填） | 无 |
+| `token` | 个人访问令牌（必填） | 无 |
+| `user_id` | 用户 ID | 自动获取 |
 
-## 工作流示例
+### 环境变量
 
 ```bash
-# 1. 初始化配置
-yx-code init
-# 编辑 .yunxiao.yaml 填写凭证
-
-# 2. 克隆仓库并创建特性分支
-yx-code clone https://codeup.aliyun.com/org/repo.git -b feature/login
+export YUNXIAO_ORGANIZATION_ID="your-org-id"
+export YUNXIAO_TOKEN="your-token"
+```
 
-# 3. 进入仓库目录
-cd repo
+### 配置优先级（从低到高）
 
-# 4. 开发完成后提交
-yx-code commit -m "feat: 实现登录功能"
+1. 默认值
+2. `~/.yunxiao/config.yaml` 全局配置文件
+3. 环境变量：`YUNXIAO_DOMAIN`、`YUNXIAO_ORGANIZATION_ID`、`YUNXIAO_TOKEN`、`YUNXIAO_USER_ID`
+4. CLI 参数：`--domain`、`--org`、`--token`
 
-# 5. 推送到远程
-yx-code push
+## CLI 命令
 
-# 6. 创建合并请求
-yx-code mr -m "添加用户登录功能"
+Skill 底层通过 `yx-code` CLI 与云效 API 交互：
 
-# 7. 查看代码差异
-yx-code diff
+```bash
+yx-code init                       # 初始化配置 (~/.yunxiao/config.yaml)
+yx-code clone <url> -b <branch>    # 克隆仓库并创建分支
+yx-code commit -m "msg"            # 提交代码
+yx-code push                       # 推送代码
+yx-code mr -m "title"              # 创建合并请求
+yx-code diff                       # 查看代码差异
+yx-code workitems                  # 列出工作项
+yx-code summary --period week      # 生成工作总结
 ```
 
-## AI Agent 集成
-
-本工具基于 [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 |
-
-### 使用示例
-
-在 Claude Code 或 Cursor Agent 中直接输入命令：
-
-```
-/yx-commands-commit-push-mr
-```
-
-AI 会自动：
-1. 分析代码变更
-2. 生成 commit message
-3. 执行 commit、push
-4. 创建合并请求
+| [Claude Code](https://claude.ai/code) | ✅ | 原生支持 Agent Skills |
+| [Cursor](https://cursor.com) | ✅ | 兼容 `~/.claude/skills/` 目录 |
 
-### 安装
+## 从源码安装
 
-npm 安装后自动将每个 skill 部署为独立符号链接到 `~/.claude/skills/`：
+```bash
+git clone https://github.com/ZLStream/yunxiao-commands.git
+cd yunxiao-commands
+make build-local
+sudo make install
 
+# 手动链接 skills
+for dir in claude-plugin/skills/*/; do
+  ln -s "$(pwd)/$dir" ~/.claude/skills/"$(basename $dir)"
+done
 ```
-~/.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/` 加载，无需额外配置。
 
 ## 相关链接
 
+- [Agent Skills 标准](https://agentskills.io/)
 - [阿里云云效官方文档](https://help.aliyun.com/zh/yunxiao/)
 - [云效 OpenAPI 文档](https://help.aliyun.com/zh/yunxiao/developer-reference/)
 
 ## License
 
-MIT
+MIT

package/claude-plugin/skills/yx-commands/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: yx-commands
-description: 阿里云云效(codeup)代码仓库工作流自动化。功能包括：智能提交代码、推送、创建MR(合并请求)、代码审查、分支差异对比。触发场景：用户提到云效、codeup、阿里云代码仓库、yx-code工具；git地址以git@codeup.aliyun.com开头；需要提交代码并创建MR；说"提交合并"触发完整工作流。注意：github相关操作或纯git命令不要使用此技能。
+description: 阿里云云效(codeup)代码仓库工作流自动化。功能包括：智能提交代码、推送、创建MR(合并请求)、代码审查、分支差异对比、工作项查询、工作总结生成。触发场景：用户提到云效、codeup、阿里云代码仓库、yx-code工具；git地址以git@codeup.aliyun.com开头；需要提交代码并创建MR；说"提交合并"触发完整工作流；说"工作总结""周报""月报"触发总结功能。注意：github相关操作或纯git命令不要使用此技能。
 tools: Bash, Read
 ---
 
@@ -31,6 +31,8 @@ tools: Bash, Read
 | `/yx-commands-mr` | 创建 MR | 提交合并请求（默认 develop） |
 | `/yx-commands-review` | 代码审查 | 查看分支差异 |
 | `/yx-commands-commit-push-mr` | 完整工作流 | 一键完成提交、推送、创建MR |
+| `/yx-commands-workitems` | 查询工作项 | 列出我负责/参与的工作项 |
+| `/yx-commands-summary` | 工作总结 | 生成周报/月报/季报/年报 |
 
 ## 典型工作流
 
@@ -53,7 +55,15 @@ tools: Bash, Read
 /yx-commands-review -t develop -s feature-branch
 ```
 
+### 工作总结
+```
+/yx-commands-summary          → 交互式选择时间范围
+/yx-commands-summary --period month  → 本月总结
+/yx-commands-workitems        → 查看当前进行中工作项
+```
+
 ## 前置条件
 
 - 已安装 `yx-code` CLI 工具
-- `yx-code` 在系统 PATH 中可用
+- `yx-code` 在系统 PATH 中可用
+- 已运行 `yx-code init` 完成配置（`~/.yunxiao/config.yaml`）

package/claude-plugin/skills/yx-commands-summary/SKILL.md

@@ -0,0 +1,303 @@
+---
+name: yx-commands-summary
+description: 生成云效工作项总结，支持按周/月/季度/年或自定义时间范围，同时汇总本地云效仓库的 git 提交记录
+---
+
+生成指定时间范围内的工作总结（含需求、任务、缺陷 + git 提交记录），适合写周报、月报或绩效总结。
+
+**AI 生成工作总结的完整流程：**
+
+## 第一步：确定时间范围
+
+根据用户请求确定 `START_DATE` 和 `END_DATE`（格式 `YYYY-MM-DD`），例如本月：
+- START_DATE = 本月第一天
+- END_DATE = 今天
+
+---
+
+## 第二步：获取云效工作项
+
+```bash
+yx-code summary --start <START_DATE> --end <END_DATE> --json
+```
+
+也可使用预设周期：
+```bash
+yx-code summary --period week --json    # 本周
+yx-code summary --period month --json   # 本月
+yx-code summary --period quarter --json # 本季度
+yx-code summary --period year --json    # 本年
+```
+
+**参数说明：**
+
+| 参数 | 说明 | 可选值 | 默认值 |
+|------|------|--------|--------|
+| `--period` / `-p` | 时间周期 | week/month/quarter/year | 交互提示 |
+| `--start` | 开始日期 | YYYY-MM-DD 格式 | - |
+| `--end` | 结束日期 | YYYY-MM-DD 格式 | 今天 |
+| `--status` / `-s` | 状态过滤 | all（默认）/ undone（排除已完成）/ 中文状态名 | all |
+| `--json` | JSON 格式输出 | - | false |
+
+---
+
+## 第三步：扫描本地云效 git 仓库并收集提交记录
+
+**3.1 获取 git 用户名**
+
+```bash
+git config --global user.name
+```
+
+**3.2 扫描所有 remote 指向 codeup.aliyun.com 的本地仓库**
+
+在常见代码目录中查找，深度限制 5 层，并通过项目根目录 mtime 预过滤，跳过时间范围内未活动的仓库：
+
+```bash
+for gitdir in $(find ~/IdeaProjects ~/Projects ~/code ~/workspace ~/repos ~/src ~/dev ~/work ~/Documents/code 2>/dev/null -maxdepth 5 -name ".git" -type d); do
+  repo=$(dirname "$gitdir")
+  # 1. mtime 预过滤：项目根目录在时间范围内未被修改则跳过（纯文件系统操作，无需启动 git）
+  if ! find "$repo" -maxdepth 0 -newermt "<START_DATE>" 2>/dev/null | grep -q .; then
+    continue
+  fi
+  # 2. 检查 remote 是否为云效仓库
+  if git -C "$repo" remote -v 2>/dev/null | grep -q "codeup.aliyun.com"; then
+    echo "$repo"
+  fi
+done
+```
+
+> - 项目根目录 mtime 在任何文件编辑、IDE 打开等操作时均会更新，比 `.git/` 内部文件更灵敏
+> - mtime 检查为纯文件系统操作，优先于需要启动 git 进程的 remote URL 检查
+> - 某个目录不存在时 `2>/dev/null` 静默跳过，不影响其他目录扫描
+
+**3.3 对每个仓库查询时间范围内的 commit**
+
+```bash
+git -C <repo_path> log \
+  --after="<START_DATE> 00:00:00" \
+  --before="<END_DATE> 23:59:59" \
+  --author="<用户名>" \
+  --format="%h|%s|%ai" \
+  --no-merges
+```
+
+从 remote URL 提取仓库名作为展示标识：
+```bash
+git -C <repo_path> remote get-url origin
+# git@codeup.aliyun.com:org/repo-name.git → 取最后一段去掉 .git → repo-name
+```
+
+---
+
+## 第四步：整合展示
+
+将云效工作项和 git 提交记录合并为以下结构：
+
+```
+## 工作总结（2024-03-01 ~ 2024-03-31）
+
+### 云效工作项（N 项）
+
+**总计：N 项**（需求 X 项 / 任务 Y 项 / 缺陷 Z 项）
+
+#### 需求（X 项）
+| 编号 | 标题 | 状态 | 优先级 | 所在项目 | 创建日期 |
+|------|------|------|--------|----------|----------|
+| XJHS-1898 | 太保：兼容团险网点人员 | 已上线 | 中 | 芯计划书 | 2024-03-10 |
+
+#### 任务（Y 项）
+...
+
+#### 缺陷（Z 项）
+...
+
+#### 按项目汇总
+| 项目 | 工作项数 |
+|------|----------|
+| 展业赋能 | 7 |
+
+---
+
+### Git 提交记录（共 N 次提交，涉及 R 个仓库）
+
+#### 仓库：repo-a（M 次提交）
+| 提交哈希 | 提交信息 | 日期 |
+|----------|----------|------|
+| a1b2c3d | feat: 新增XX功能 | 2024-03-15 |
+
+#### 仓库：repo-b（K 次提交）
+| 提交哈希 | 提交信息 | 日期 |
+|----------|----------|------|
+| e4f5g6h | fix: 修复登录问题 | 2024-03-20 |
+
+---
+
+### 综合统计
+| 维度 | 数量 |
+|------|------|
+| 云效工作项 | X 项 |
+| Git 提交 | Y 次 |
+| 涉及云效项目 | Z 个 |
+| 涉及代码仓库 | R 个 |
+```
+
+**展示规则：**
+- 云效工作项按 `category` 字段分组：`Req`=需求、`Task`=任务、`Bug`=缺陷，无数据的类别跳过
+- 标题超过 30 字时截断并加"..."
+- 若 `parent_id` 非空，在标题后附注"（子项）"
+- 优先级为空时显示"-"
+- Git 提交按仓库分组，同一仓库内按日期倒序
+- 未找到任何 codeup 仓库时，跳过 Git 部分
+- yx-code 未安装时，跳过云效工作项部分
+- 如需进一步分析，可请求："根据以上数据，帮我写一份适合汇报给领导的月度总结"
+
+---
+
+## 第五步：选择总结模板
+
+根据汇报场景选择合适的模板，将第四步的数据重新组织：
+
+### 模板一：周报（简洁高效型）
+
+**适用场景**：每周团队例会、直属领导汇报
+
+```markdown
+## 周报（YYYY-MM-DD ~ YYYY-MM-DD）
+
+### 本周完成
+1. **[项目/需求名称]** - 简要描述完成内容及成果
+   - 具体工作点1
+   - 具体工作点2
+
+2. **[问题修复]** - 描述修复的问题和影响范围
+
+### 进行中
+- **[任务名称]** - 当前进度（XX%），预计完成时间
+
+### 下周计划
+1. [计划事项1]
+2. [计划事项2]
+
+### 风险与阻塞
+- [如有风险或需要协调的事项]
+```
+
+**生成要点**：
+- 从已完成的云效工作项中提取"本周完成"
+- 从待处理/进行中的工作项提取"进行中"
+- Git 提交作为具体工作点的佐证
+- 保持简洁，每项 1-2 行
+
+---
+
+### 模板二：季度总结（成果导向型）
+
+**适用场景**：季度绩效评估、部门汇报
+
+```markdown
+## 202X年QX季度工作总结
+
+### 一、核心成果
+
+**1. [项目/业务线A]**
+- 完成需求 X 项，修复缺陷 Y 个
+- 关键成果1：描述业务价值
+- 关键成果2：描述技术贡献
+
+**2. [项目/业务线B]**
+- ...
+
+### 二、工作量统计
+| 维度 | 数量 |
+|------|------|
+| 完成需求 | X 项 |
+| 完成任务 | Y 项 |
+| 修复缺陷 | Z 项 |
+| 代码提交 | N 次 |
+| 涉及项目 | M 个 |
+
+### 三、技术亮点
+- 亮点1：技术创新/性能优化/架构改进
+- 亮点2：工具建设/效率提升
+
+### 四、问题与改进
+- 遇到的问题及解决方案
+- 下季度改进方向
+
+### 五、下季度规划
+1. [重点事项1]
+2. [重点事项2]
+```
+
+**生成要点**：
+- 按项目/业务线分组，突出业务价值
+- 统计数据要准确，用表格展示
+- 技术亮点从 Git 提交中提取（feat/refactor/optimize）
+- 问题与改进从缺陷工作项中提炼
+
+---
+
+### 模板三：年终总结（全面回顾型）
+
+**适用场景**：年度绩效考核、晋升答辩、年终汇报
+
+```markdown
+## 202X年度工作总结
+
+### 一、年度概览
+
+> 一句话总结全年核心贡献
+
+**年度数据看板**
+| 维度 | 数量 |
+|------|------|
+| 完成需求 | X 项 |
+| 完成任务 | Y 项 |
+| 修复缺陷 | Z 项 |
+| 代码提交 | N 次 |
+| 参与项目 | M 个 |
+
+### 二、重点项目回顾
+
+**1. [项目名称]（Q1-Q2）**
+- 项目背景：简述业务背景和目标
+- 我的贡献：具体负责的内容
+- 成果与价值：上线效果、性能提升、用户反馈
+
+**2. [项目名称]（Q3-Q4）**
+- ...
+
+### 三、技术成长
+- **技术栈扩展**：今年学习/应用的新技术
+- **架构能力**：参与的系统设计、架构优化
+- **工程效率**：工具建设、流程改进、文档沉淀
+
+### 四、团队协作
+- 跨团队协作项目
+- 知识分享/技术分享
+- 新人指导/Code Review
+
+### 五、不足与反思
+- 今年做得不够好的地方
+- 改进措施和行动计划
+
+### 六、明年规划
+- **业务目标**：期望参与的重点项目
+- **技术目标**：希望深入的技术方向
+- **个人成长**：能力提升计划
+```
+
+**生成要点**：
+- 按季度梳理重点项目，突出业务价值和个人贡献
+- 技术成长需要结合 Git 提交中的技术关键词
+- 不足与反思要真诚且有改进方案
+- 明年规划要具体可执行
+
+---
+
+**使用方式**：
+- 用户说"帮我写周报"→ 使用模板一
+- 用户说"帮我写季度总结"→ 使用模板二
+- 用户说"帮我写年终总结"→ 使用模板三
+- 用户说"帮我写月报"→ 参考模板二，简化为月度维度

package/claude-plugin/skills/yx-commands-workitems/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: yx-commands-workitems
+description: 列出云效工作项（我负责的，含需求、任务、缺陷）
+---
+
+列出当前用户在云效中负责的工作项（需求、任务、缺陷）。用户 ID 会在首次运行时通过 token 自动获取并缓存。
+
+**步骤：**
+
+1. 列出我负责的未完成工作项（默认，按类别分组展示）：
+```bash
+yx-code workitems
+```
+
+2. 按状态过滤：
+```bash
+# 列出所有状态的工作项
+yx-code workitems --status all
+
+# 列出指定中文状态的工作项
+yx-code workitems --status 开发中
+
+# 列出指定项目的工作项
+yx-code workitems --project <项目标识符>
+```
+
+3. 获取完整 JSON 数据（供 AI 整理展示）：
+```bash
+yx-code workitems --json
+```
+
+**参数说明：**
+
+| 参数 | 说明 | 可选值 | 默认值 |
+|------|------|--------|--------|
+| `--status` / `-s` | 状态过滤 | undone（排除已完成）/ all / 中文状态名 | undone |
+| `--project` / `-p` | 指定项目 | 项目标识符或名称 | 全部项目 |
+| `--json` | JSON 格式输出 | - | false |
+
+**AI 整理展示格式：**
+
+当用户请求查看工作项时，执行 `yx-code workitems --json`，然后将 JSON 数据整理成以下格式展示：
+
+```
+## 我负责的工作项（未完成）
+
+### 需求（N 项）
+| 编号 | 标题 | 状态 | 优先级 | 创建人 | 所在项目 | 创建日期 |
+|------|------|------|--------|--------|----------|----------|
+| XJHS-1898 | 太保：兼容团险网点人员 | 处理中 | 中 | 谢思超 | 芯计划书 | 2024-11-26 |
+
+### 任务（N 项）
+| 编号 | 标题 | 状态 | 优先级 | 创建人 | 所在项目 | 创建日期 |
+|------|------|------|--------|--------|----------|----------|
+...
+
+### 缺陷（N 项）
+| 编号 | 标题 | 状态 | 优先级 | 创建人 | 所在项目 | 创建日期 |
+|------|------|------|--------|--------|----------|----------|
+...
+```
+
+规则：
+- 按 category 字段分组：`Req`=需求、`Task`=任务、`Bug`=缺陷
+- 若某类别无数据则跳过
+- 标题过长时截断显示（保留前 30 个字符）
+- 若 `parent_id` 非空，在标题后附注"（子项）"
+- 优先级为空时显示"-"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "yunxiao-code",
-  "version": "1.2.1",
-  "description": "阿里云云效 CLI 工具",
+  "version": "1.3.1",
+  "description": "阿里云云效 Agent Skills，支持智能提交、工作项查询、工作总结等开发工作流",
   "keywords": [
     "aliyun",
     "阿里云",
@@ -9,15 +9,22 @@
     "云效",
     "CLI",
     "git",
-    "代码"
+    "代码",
+    "agent-skills",
+    "claude",
+    "cursor",
+    "AI",
+    "workitems",
+    "summary",
+    "merge-request"
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/ZLStream/yunxiao-code.git"
+    "url": "git+https://github.com/ZLStream/yunxiao-commands.git"
   },
-  "homepage": "https://github.com/ZLStream/yunxiao-code#readme",
+  "homepage": "https://github.com/ZLStream/yunxiao-commands#readme",
   "bugs": {
-    "url": "https://github.com/ZLStream/yunxiao-code/issues"
+    "url": "https://github.com/ZLStream/yunxiao-commands/issues"
   },
   "bin": {
     "yx-code": "bin/yx-code.js"

package/scripts/postinstall.js

@@ -71,7 +71,7 @@ function deployPlugin() {
     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-commands-commit, /yx-commands-push, /yx-commands-mr, /yx-commands-review, /yx-commands-commit-push-mr, /yx-commands-workitems, /yx-commands-summary\n');
 }
 
 console.log('\n✅ yx-code CLI installed successfully!\n');
@@ -81,7 +81,9 @@ console.log('  yx-code clone    - 克隆仓库');
 console.log('  yx-code commit   - 提交代码');
 console.log('  yx-code push     - 推送代码');
 console.log('  yx-code mr       - 创建合并请求');
-console.log('  yx-code diff     - 查看代码差异\n');
+console.log('  yx-code diff     - 查看代码差异');
+console.log('  yx-code workitems - 列出工作项');
+console.log('  yx-code summary  - 生成工作总结\n');
 
 try {
   deployPlugin();