feat: 新增技能编排引擎和工作流构建器组件
Some checks failed
CI / Lint & TypeCheck (push) Has been cancelled
CI / Unit Tests (push) Has been cancelled
CI / Build Frontend (push) Has been cancelled
CI / Rust Check (push) Has been cancelled
CI / Security Scan (push) Has been cancelled
CI / E2E Tests (push) Has been cancelled

refactor: 统一Hands系统常量到单个源文件
refactor: 更新Hands中文名称和描述

fix: 修复技能市场在连接状态变化时重新加载
fix: 修复身份变更提案的错误处理逻辑

docs: 更新多个功能文档的验证状态和实现位置
docs: 更新Hands系统文档

test: 添加测试文件验证工作区路径
This commit is contained in:
iven
2026-03-25 08:27:25 +08:00
parent 9c781f5f2a
commit aa6a9cbd84
110 changed files with 12384 additions and 1337 deletions

243
skills/README.md Normal file
View File

@@ -0,0 +1,243 @@
# ZCLAW 技能总览
> **设计目标**: 帮助 LLM 理解系统所有可用技能,根据用户意图智能选择合适的技能。
---
## 技能使用指南
### 何时调用技能
当用户请求涉及以下领域时,应主动调用 `execute_skill` 工具:
1. **专业领域任务** - 需要特定专业知识的任务
2. **复杂工作流** - 需要多步骤编排的任务
3. **结构化输出** - 需要特定格式输出的任务
4. **专业工具使用** - 需要使用特定工具或 API 的任务
### 如何选择技能
1. 分析用户意图和所需能力
2. 匹配技能描述中的"核心能力"
3. 考虑对话上下文
4. 如果多个技能都可能适用,选择最专业的那个
---
## 开发工程类
| 技能 ID | 名称 | 用途 | 典型场景 |
|---------|------|------|----------|
| `senior-developer` | 资深开发专家 | 高质量全栈实现、Laravel/Livewire、Three.js | "帮我实现用户认证系统"、"添加深色模式" |
| `frontend-developer` | 前端开发专家 | React/Vue/Angular、UI 实现、性能优化 | "优化 React 组件性能"、"实现响应式布局" |
| `backend-architect` | 后端架构专家 | 系统设计、数据库架构、微服务、API 设计 | "设计微服务架构"、"数据库选型建议" |
| `ai-engineer` | AI/ML 工程专家 | 机器学习模型、LLM 集成、RAG 系统 | "集成 GPT API"、"训练分类模型" |
| `devops-automator` | DevOps 自动化专家 | CI/CD 管道、基础设施即代码、云运维 | "配置 GitHub Actions"、"Docker 部署" |
| `rapid-prototyper` | 快速原型专家 | PoC 开发、MVP 创建、想法验证 | "快速验证这个想法"、"做个原型" |
---
## 测试质量类
| 技能 ID | 名称 | 用途 | 典型场景 |
|---------|------|------|----------|
| `api-tester` | API 测试专家 | API 验证、安全测试、性能测试 | "测试这个 API 端点"、"验证接口安全性" |
| `evidence-collector` | 证据收集专家 | 基于截图的 QA 验证 | "验证这个功能是否正常" |
| `reality-checker` | 现实检验专家 | 生产就绪验证、拒绝幻想审批 | "这个可以上线了吗?" |
| `performance-benchmarker` | 性能基准专家 | 性能测量、分析、优化 | "测试系统性能"、"基准对比" |
| `test-results-analyzer` | 测试结果分析专家 | 测试结果评估、质量指标分析 | "分析测试报告"、"评估发布风险" |
| `accessibility-auditor` | 无障碍审计专家 | WCAG 合规、辅助技术测试 | "审计无障碍问题"、"WCAG 合规检查" |
---
## 安全合规类
| 技能 ID | 名称 | 用途 | 典型场景 |
|---------|------|------|----------|
| `security-engineer` | 安全工程专家 | 威胁建模、漏洞评估、安全架构 | "安全审计"、"评估漏洞风险" |
| `legal-compliance-checker` | 法律合规专家 | 多司法管辖区合规、数据保护 | "检查 GDPR 合规"、"隐私政策审查" |
| `agentic-identity-trust` | Agentic 身份架构师 | AI Agent 身份认证、信任链、权限管理 | "设计 Agent 认证系统"、"实现零信任架构" |
---
## 数据分析类
| 技能 ID | 名称 | 用途 | 典型场景 |
|---------|------|------|----------|
| `analytics-reporter` | 数据分析报告专家 | 统计分析、数据可视化、业务洞察 | "分析销售数据"、"生成业务报告" |
| `finance-tracker` | 财务追踪专家 | 财务规划、预算管理、投资分析 | "分析财报"、"预算规划"、"现金流分析" |
| `data-analysis` | 数据分析和可视化 | 数据分析、统计、图表 | "分析这份数据"、"创建图表" |
| `sales-data-extraction-agent` | 销售数据提取 Agent | CRM/ERP 数据提取、标准化 | "提取销售数据"、"整合 CRM 数据" |
| `data-consolidation-agent` | 数据整合 Agent | 多源数据整合、统一视图 | "整合多个数据源"、"对齐数据格式" |
| `report-distribution-agent` | 报告分发 Agent | 报告生成、多渠道分发 | "分发报告到各部门" |
---
## 项目管理类
| 技能 ID | 名称 | 用途 | 典型场景 |
|---------|------|------|----------|
| `senior-pm` | 资深项目经理 | 战略级项目管理、复杂依赖协调 | "规划项目里程碑"、"协调跨团队依赖" |
| `project-shepherd` | 项目守护者 | 跨职能协调、利益相关者对齐 | "跟进项目进度"、"管理风险" |
| `sprint-prioritizer` | Sprint 优先级专家 | 敏捷规划、功能优先级、资源分配 | "排序 Sprint 待办"、"优化资源分配" |
| `experiment-tracker` | 实验追踪器 | 实验设计、假设验证 | "设计 A/B 测试"、"追踪实验结果" |
| `feedback-synthesizer` | 用户反馈综合专家 | 多源反馈收集、主题分析 | "分析用户反馈"、"提取关键洞察" |
| `trend-researcher` | 趋势研究专家 | 市场趋势、竞争情报 | "研究市场趋势"、"竞争分析" |
| `agents-orchestrator` | 自主流水线管理器 | 完整开发工作流编排 | "编排多 Agent 工作流" |
---
## 设计 UX 类
| 技能 ID | 名称 | 用途 | 典型场景 |
|---------|------|------|----------|
| `ui-designer` | UI 设计专家 | 视觉设计系统、组件库、像素级界面 | "设计界面"、"创建设计系统" |
| `ux-architect` | UX 架构专家 | CSS 设计系统、布局框架 | "设计 UX 架构"、"创建 CSS 系统" |
| `ux-researcher` | UX 研究专家 | 用户行为分析、可用性测试 | "用户研究"、"可用性测试" |
| `visual-storyteller` | 视觉叙事专家 | 视觉叙事、品牌故事设计 | "设计品牌故事"、"信息可视化" |
| `image-prompt-engineer` | 图像提示专家 | AI 图像生成提示词工程 | "生成 AI 图像"、"优化图像提示词" |
| `whimsy-injector` | 趣味注入专家 | 品牌个性、愉悦交互、游戏化 | "增加品牌趣味性"、"设计惊喜时刻" |
| `brand-guardian` | 品牌守护专家 | 品牌战略、一致性维护、视觉识别 | "品牌审计"、"确保品牌一致性" |
---
## 内容营销类
| 技能 ID | 名称 | 用途 | 典型场景 |
|---------|------|------|----------|
| `content-creator` | 内容创作专家 | 多平台内容策略、编辑日历 | "制定内容策略"、"规划内容日历" |
| `chinese-writing` | 中文写作助手 | 中文文档、文章、报告撰写 | "帮我写一篇文章"、"润色文档" |
| `executive-summary-generator` | 执行摘要专家 | C 级决策摘要、战略沟通 | "生成执行摘要"、"为高管准备报告" |
| `social-media-strategist` | 社交媒体策略专家 | 跨平台策略、社交聆听 | "制定社交媒体策略" |
---
## 社交平台类
| 技能 ID | 名称 | 用途 | 典型场景 |
|---------|------|------|----------|
| `twitter-engager` | Twitter 互动专家 | 实时互动、推文串创作 | "Twitter 营销策略"、"增加互动" |
| `instagram-curator` | Instagram 策展专家 | 视觉叙事、多格式内容 | "Instagram 内容策略" |
| `tiktok-strategist` | TikTok 策略专家 | 病毒内容、算法优化 | "TikTok 营销"、"优化视频内容" |
| `reddit-community-builder` | Reddit 社区建设专家 | 真实互动、AMA 协调 | "Reddit 社区运营"、"AMA 策划" |
| `zhihu-strategist` | 知乎营销专家 | 专业内容、问答营销 | "知乎内容策略"、"问答营销" |
| `xiaohongshu-specialist` | 小红书运营专家 | 种草内容、KOC 合作 | "小红书运营"、"种草笔记" |
| `wechat-official-account` | 微信公众号专家 | 内容营销、粉丝互动 | "公众号运营"、"内容规划" |
| `growth-hacker` | 增长黑客专家 | 用户获取、病毒增长 | "增长策略"、"用户获取" |
| `app-store-optimizer` | 应用商店优化专家 | ASO 策略、关键词优化 | "App Store 优化"、"提升排名" |
---
## 运营支持类
| 技能 ID | 名称 | 用途 | 典型场景 |
|---------|------|------|----------|
| `studio-operations` | 工作室运营 | 日常运营管理、流程优化 | "优化工作流程"、"资源管理" |
| `studio-producer` | 工作室制作人 | 创意项目全生命周期管理 | "管理创意项目"、"协调资源" |
| `support-responder` | 客户支持专家 | 多渠道客户服务、问题解决 | "处理客户投诉"、"支持工单" |
| `workflow-optimizer` | 工作流优化专家 | 流程分析、自动化实施 | "优化业务流程"、"自动化工作" |
| `infrastructure-maintainer` | 基础设施维护专家 | 系统可靠性、性能优化 | "维护系统稳定"、"优化性能" |
| `tool-evaluator` | 工具评估专家 | 技术评估、工具选型 | "评估工具选型"、"技术选型建议" |
---
## XR/空间计算类
| 技能 ID | 名称 | 用途 | 典型场景 |
|---------|------|------|----------|
| `visionos-spatial-engineer` | visionOS 空间工程师 | Vision Pro 开发、空间计算 | "开发 Vision Pro 应用" |
| `macos-spatial-metal-engineer` | macOS Spatial/Metal 工程师 | Metal GPU 渲染、高性能图形 | "Metal 图形开发"、"GPU 优化" |
| `xr-immersive-developer` | XR 沉浸式开发者 | XR 全沉浸体验开发 | "开发 XR 沉浸体验" |
| `xr-interface-architect` | XR 界面架构师 | XR UI 系统架构、空间设计 | "设计 XR 界面系统" |
| `xr-cockpit-interaction-specialist` | XR 座舱交互专家 | 座舱式界面设计、多任务空间布局 | "设计座舱交互界面" |
| `terminal-integration-specialist` | 终端集成专家 | 空间计算终端集成、命令行界面 | "集成终端到空间环境" |
| `lsp-index-engineer` | LSP/Index 工程师 | 语言服务器协议、语义索引 | "构建代码智能系统" |
---
## 基础工具类
| 技能 ID | 名称 | 用途 | 典型场景 |
|---------|------|------|----------|
| `web-search` | 网络搜索 | 搜索信息、获取网页内容 | "搜索最新信息"、"查资料" |
| `file-operations` | 文件系统操作 | 读写、创建、删除文件 | "读取文件"、"写入文件" |
| `shell-command` | Shell 命令执行 | 执行终端命令、脚本运行 | "运行命令"、"执行脚本" |
| `git` | Git 版本控制 | 提交、推送、分支管理 | "提交代码"、"创建分支" |
| `code-review` | 代码审查 | 代码质量审查、最佳实践检查 | "审查这段代码" |
| `translation` | 翻译 | 多语言翻译 | "翻译这段文字" |
| `feishu-docs` | 飞书文档操作 | 创建、编辑飞书文档 | "创建飞书文档"、"搜索知识库" |
---
## 使用示例
### 示例 1: 用户询问财务问题
```
用户: "帮我分析一下腾讯去年的财报"
意图分析: 财务分析 → 财报解读
推荐技能: finance-tracker
调用: execute_skill("finance-tracker", {company: "腾讯", task: "财报分析"})
```
### 示例 2: 用户请求代码实现
```
用户: "帮我实现一个用户认证系统"
意图分析: 开发任务 → 后端开发 → 认证系统
推荐技能: senior-developer 或 backend-architect
调用: execute_skill("senior-developer", {task: "实现用户认证系统"})
```
### 示例 3: 用户需要数据分析
```
用户: "分析一下我们上个月的销售数据"
意图分析: 数据分析 → 业务洞察
推荐技能: analytics-reporter
调用: execute_skill("analytics-reporter", {task: "销售数据分析", period: "上个月"})
```
---
## 技能选择决策树
```
用户请求
├─ 涉及代码开发? ─────────────────────────────────────┐
│ ├─ 前端 UI → frontend-developer │
│ ├─ 后端系统 → backend-architect │
│ ├─ 全栈/通用 → senior-developer │
│ └─ 快速验证 → rapid-prototyper │
│ │
├─ 涉及数据/分析? ─────────────────────────────────────┤
│ ├─ 财务数据 → finance-tracker │
│ ├─ 业务分析 → analytics-reporter │
│ └─ 数据处理 → data-analysis │
│ │
├─ 涉及测试/质量? ─────────────────────────────────────┤
│ ├─ API 测试 → api-tester │
│ ├─ 安全审计 → security-engineer │
│ └─ 无障碍 → accessibility-auditor │
│ │
├─ 涉及设计/UX? ───────────────────────────────────────┤
│ ├─ UI 设计 → ui-designer │
│ ├─ UX 研究 → ux-researcher │
│ └─ 品牌设计 → brand-guardian │
│ │
├─ 涉及内容/营销? ─────────────────────────────────────┤
│ ├─ 内容创作 → content-creator │
│ ├─ 社交媒体 → social-media-strategist │
│ └─ 中文写作 → chinese-writing │
│ │
└─ 通用操作? ──────────────────────────────────────────┤
├─ 搜索信息 → web-search │
├─ 文件操作 → file-operations │
├─ Git 操作 → git │
└─ Shell 命令 → shell-command │
```
---
*此文档用于帮助 LLM 理解 ZCLAW 可用技能,实现智能技能路由。*