refactor: 清理未使用代码并添加未来功能标记
Some checks failed
CI / Rust Check (push) Has been cancelled
CI / Lint & TypeCheck (push) Has been cancelled
CI / Unit Tests (push) Has been cancelled
CI / Build Frontend (push) Has been cancelled
CI / Security Scan (push) Has been cancelled
CI / E2E Tests (push) Has been cancelled
Some checks failed
CI / Rust Check (push) Has been cancelled
CI / Lint & TypeCheck (push) Has been cancelled
CI / Unit Tests (push) Has been cancelled
CI / Build Frontend (push) Has been cancelled
CI / Security Scan (push) Has been cancelled
CI / E2E Tests (push) Has been cancelled
style: 统一代码格式和注释风格 docs: 更新多个功能文档的完整度和状态 feat(runtime): 添加路径验证工具支持 fix(pipeline): 改进条件判断和变量解析逻辑 test(types): 为ID类型添加全面测试用例 chore: 更新依赖项和Cargo.lock文件 perf(mcp): 优化MCP协议传输和错误处理
This commit is contained in:
iven
@@ -3,9 +3,9 @@
|
||||
> **分类**: Skills 生态
|
||||
> **优先级**: P1 - 重要
|
||||
> **成熟度**: L4 - 生产
|
||||
> **最后更新**: 2026-03-24
|
||||
> **最后更新**: 2026-03-25
|
||||
|
||||
> ✅ **实现更新**: Skills 动态扫描已实现。Kernel 集成了 `SkillRegistry`，支持通过 Tauri 命令 `skill_list` 和 `skill_refresh` 动态发现所有 **69 个**技能。**新增 `execute_skill` 工具**，允许 Agent 在对话中直接调用技能。
|
||||
> ✅ **实现更新**: Skills 动态扫描已实现。Kernel 集成了 `SkillRegistry`，支持通过 Tauri 命令 `skill_list` 和 `skill_refresh` 动态发现所有 **78+** 技能。**新增 `execute_skill` 工具**，允许 Agent 在对话中直接调用技能。
|
||||
|
||||
---
|
||||
|
||||
@@ -21,9 +21,30 @@ Skills 系统是 ZCLAW 的核心扩展机制，通过 SKILL.md 文件定义 Agen
|
||||
| 优先级 | P1 |
|
||||
| 成熟度 | L4 |
|
||||
| 依赖 | SkillRegistry (Rust), SkillDiscoveryEngine (TypeScript) |
|
||||
| SKILL.md 文件 | **69** |
|
||||
| **动态发现技能** | **69 (100%)** |
|
||||
| SKILL.md 文件 | **78+** |
|
||||
| **动态发现技能** | **78+ (100%)** |
|
||||
| **execute_skill 工具** | **✅ 已实现** |
|
||||
| **Crate 完整度** | **80%** |
|
||||
|
||||
### 1.2 Crate 架构
|
||||
|
||||
```
|
||||
crates/zclaw-skills/
|
||||
├── src/
|
||||
│ ├── lib.rs # Crate 入口
|
||||
│ ├── registry.rs # SkillRegistry (HashMap)
|
||||
│ ├── loader.rs # SKILL.md 解析器
|
||||
│ ├── executor.rs # 技能执行器 (PromptOnly/Python/Shell)
|
||||
│ ├── orchestration.rs # 技能编排引擎
|
||||
│ ├── auto_compose.rs # 自动组合技能
|
||||
│ └── context.rs # Context 验证
|
||||
└── Cargo.toml
|
||||
|
||||
待实现:
|
||||
- WASM 模式执行器
|
||||
- Native 模式执行器
|
||||
- input_schema/output_schema 验证
|
||||
```
|
||||
|
||||
### 1.2 动态扫描实现
|
||||
|
||||
@@ -135,14 +156,19 @@ tools:
|
||||
|
||||
| 分类 | 技能数 | 代表技能 |
|
||||
|------|--------|---------|
|
||||
| 开发工程 | 15+ | ai-engineer, senior-developer, backend-architect |
|
||||
| 协调管理 | 8+ | agents-orchestrator, project-shepherd |
|
||||
| 测试质量 | 6+ | code-reviewer, reality-checker, evidence-collector |
|
||||
| 设计体验 | 8+ | ux-architect, brand-guardian, ui-designer |
|
||||
| 数据分析 | 5+ | analytics-reporter, performance-benchmarker |
|
||||
| 社媒营销 | 12+ | twitter-engager, xiaohongshu-specialist |
|
||||
| 中文平台 | 5+ | chinese-writing, feishu-docs, wechat-oa |
|
||||
| XR/空间 | 4+ | visionos-spatial-engineer, xr-immersive-dev |
|
||||
| 开发工程 | 18+ | ai-engineer, senior-developer, backend-architect, frontend-developer |
|
||||
| 协调管理 | 10+ | agents-orchestrator, project-shepherd, sprint-prioritizer |
|
||||
| 测试质量 | 8+ | code-reviewer, reality-checker, evidence-collector, api-tester |
|
||||
| 设计体验 | 10+ | ux-architect, brand-guardian, ui-designer, visual-storyteller |
|
||||
| 数据分析 | 6+ | analytics-reporter, performance-benchmarker, finance-tracker |
|
||||
| 社媒营销 | 15+ | twitter-engager, xiaohongshu-specialist, zhihu-strategist |
|
||||
| 中文平台 | 6+ | chinese-writing, feishu-docs, wechat-oa |
|
||||
| XR/空间 | 5+ | visionos-spatial-engineer, xr-immersive-dev, xr-interface-architect |
|
||||
| 基础工具 | 5+ | web-search, file-operations, shell-command, git |
|
||||
| 商务销售 | 4+ | sales-data-extraction-agent, report-distribution-agent |
|
||||
| 教育学习 | 3+ | classroom-generator, agentic-identity-trust |
|
||||
| 安全合规 | 3+ | security-engineer, legal-compliance-checker |
|
||||
| GSD 工作流 | 20+ | gsd:debug, gsd:plan-phase, gsd:execute-phase, gsd:verify-work |
|
||||
|
||||
### 3.2 发现引擎
|
||||
|
||||
@@ -255,76 +281,64 @@ const collaborationTriggers = [
|
||||
|
||||
### 5.1 已实现功能
|
||||
|
||||
- [x] 73 个 SKILL.md 技能定义
|
||||
- [x] 78+ SKILL.md 技能定义
|
||||
- [x] 标准化模板
|
||||
- [x] 发现引擎 (静态注册 12 个核心技能)
|
||||
- [x] 发现引擎 (动态扫描 78+ 技能)
|
||||
- [x] 触发词匹配
|
||||
- [x] 协作规则
|
||||
- [x] Playbooks 集成
|
||||
- [x] SkillMarket UI 组件
|
||||
- [x] **execute_skill 工具** (运行时调用技能)
|
||||
- [x] **技能分类系统** (11 分类，ID 模式匹配)
|
||||
- [x] **技能注入 system prompt** (自动将技能列表注入)
|
||||
- [x] **PromptOnly/Python/Shell 三种执行模式**
|
||||
|
||||
### 5.2 技能分类统计
|
||||
|
||||
| 分类 | 数量 | 代表技能 |
|
||||
|------|------|---------|
|
||||
| 开发工程 | 15 | frontend-developer, backend-architect, ai-engineer |
|
||||
| 测试/QA | 5 | code-review, api-tester, accessibility-auditor |
|
||||
| 设计/UX | 5 | ui-designer, ux-architect, visual-storyteller |
|
||||
| 安全 | 2 | security-engineer, legal-compliance-checker |
|
||||
| 数据分析 | 5 | data-analysis, analytics-reporter, evidence-collector |
|
||||
| 运维/DevOps | 4 | devops-automator, infrastructure-maintainer |
|
||||
| 管理/PM | 8 | senior-pm, project-shepherd, agents-orchestrator |
|
||||
| 营销/社媒 | 12 | twitter-engager, xiaohongshu-specialist, zhihu-strategist |
|
||||
| 内容/写作 | 4 | chinese-writing, translation, content-creator |
|
||||
| 研究 | 3 | trend-researcher, feedback-synthesizer |
|
||||
| 商务/销售 | 3 | sales-data-extraction-agent, report-distribution-agent |
|
||||
| 教育 | 2 | classroom-generator, agentic-identity-trust |
|
||||
| 核心工具 | 4 | git, file-operations, web-search, shell-command |
|
||||
| 开发工程 | 18 | frontend-developer, backend-architect, ai-engineer |
|
||||
| 测试/QA | 8 | code-reviewer, api-tester, accessibility-auditor |
|
||||
| 设计/UX | 10 | ui-designer, ux-architect, visual-storyteller |
|
||||
| 安全 | 3 | security-engineer, legal-compliance-checker |
|
||||
| 数据分析 | 6 | analytics-reporter, evidence-collector |
|
||||
| 运维/DevOps | 5 | devops-automator, infrastructure-maintainer |
|
||||
| 管理/PM | 10 | senior-pm, project-shepherd, agents-orchestrator |
|
||||
| 营销/社媒 | 15 | twitter-engager, xiaohongshu-specialist, zhihu-strategist |
|
||||
| 内容/写作 | 5 | chinese-writing, translation, content-creator |
|
||||
| 研究 | 4 | trend-researcher, feedback-synthesizer |
|
||||
| 商务/销售 | 4 | sales-data-extraction-agent, report-distribution-agent |
|
||||
| 教育 | 3 | classroom-generator, agentic-identity-trust |
|
||||
| 核心工具 | 5 | git, file-operations, web-search, shell-command |
|
||||
| GSD 工作流 | 20+ | gsd:debug, gsd:plan-phase, gsd:execute-phase |
|
||||
| XR/空间 | 5 | visionos-spatial-engineer, xr-immersive-dev |
|
||||
|
||||
### 5.3 实现说明
|
||||
### 5.3 Crate 实现状态
|
||||
|
||||
**✅ 已实现动态扫描 (2026-03-24)**:
|
||||
- Kernel 集成 `SkillRegistry`，启动时自动扫描 `skills/` 目录
|
||||
- 前端通过 Tauri 命令 `skill_list` 获取所有技能
|
||||
- 支持 `skill_refresh` 命令重新扫描指定目录
|
||||
- 73 个技能全部可被发现
|
||||
**zclaw-skills crate (80% 完整度)**:
|
||||
|
||||
**数据结构映射**:
|
||||
```typescript
|
||||
// 前端 SkillInfo (保留兼容)
|
||||
interface SkillInfo {
|
||||
id: string;
|
||||
name: string;
|
||||
description: string;
|
||||
triggers: string[]; // 从 tags 映射
|
||||
capabilities: string[];
|
||||
toolDeps: string[]; // 后端暂无
|
||||
installed: boolean; // 从 enabled 映射
|
||||
category?: string; // 从 tags[0] 映射
|
||||
version?: string;
|
||||
mode?: string;
|
||||
}
|
||||
|
||||
// 后端 SkillManifest (Rust)
|
||||
struct SkillManifest {
|
||||
id: SkillId,
|
||||
name: String,
|
||||
description: String,
|
||||
version: String,
|
||||
mode: SkillMode,
|
||||
capabilities: Vec<String>,
|
||||
tags: Vec<String>,
|
||||
enabled: bool,
|
||||
}
|
||||
```
|
||||
| 功能 | 状态 | 说明 |
|
||||
|------|------|------|
|
||||
| SkillRegistry | ✅ | HashMap 存储，O(1) 查找 |
|
||||
| SKILL.md 解析 | ✅ | YAML frontmatter |
|
||||
| skill.toml 解析 | ✅ | 简化 TOML 解析器 |
|
||||
| PromptOnly 执行 | ✅ | 直接 prompt 注入 |
|
||||
| Python 执行 | ✅ | 子进程调用 |
|
||||
| Shell 执行 | ✅ | 子进程调用 |
|
||||
| 技能编排 | ✅ | orchestration.rs |
|
||||
| 自动组合 | ✅ | auto_compose.rs |
|
||||
| Context 验证 | ✅ | context.rs |
|
||||
| WASM 执行 | ❌ | 待实现 |
|
||||
| Native 执行 | ❌ | 待实现 |
|
||||
| Schema 验证 | ⚠️ | 解析但未验证 |
|
||||
|
||||
### 5.4 测试覆盖
|
||||
|
||||
- **单元测试**: 43 项 (swarm-skills.test.ts)
|
||||
- **单元测试**: 50+ 项 (swarm-skills.test.ts + executor.rs)
|
||||
- **集成测试**: 完整流程测试
|
||||
- **覆盖率**: ~90%
|
||||
|
||||
### 5.3 已知问题
|
||||
### 5.5 已知问题
|
||||
|
||||
| 问题 | 严重程度 | 状态 | 计划解决 |
|
||||
|------|---------|------|---------|
|
||||
@@ -340,16 +354,19 @@ struct SkillManifest {
|
||||
## 六、演化路线
|
||||
|
||||
### 6.1 短期计划（1-2 周）
|
||||
- [ ] 优化发现算法
|
||||
- [ ] 添加技能评分
|
||||
- [ ] 实现 WASM 执行模式
|
||||
- [ ] 实现 Native 执行模式
|
||||
- [ ] 添加 input_schema/output_schema 验证
|
||||
|
||||
### 6.2 中期计划（1-2 月）
|
||||
- [ ] 技能市场 UI
|
||||
- [ ] 用户自定义技能
|
||||
- [ ] 语义匹配优化
|
||||
|
||||
### 6.3 长期愿景
|
||||
- [ ] 技能共享社区
|
||||
- [ ] 技能认证体系
|
||||
- [ ] 技能版本控制
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user