Back to Details

skill-evolution-driver

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

技能进化驱动师

Skill Evolution Driver

任务目标

Task Objectives

  • 本 Skill 用于：驱动技能进行自我进化，随着项目过程推进持续优化
  • 能力包含：
    1. 监控skill-manager存储的数据，识别技能优化机会
    2. 在空闲时提醒用户潜在的优化建议
    3. 维护技能优化任务清单
    4. 执行技能更新流程（备份、更新、测试、还原）
    5. 管理技能版本号
  • 触发条件：以下任一情况触发
    • 用户直接需求："优化技能"、"改进技能"、"技能需要更新"、"技能升级"、"修复技能问题"
    • 自动监控触发：监控到skill-manager存储的技能数据中有待优化的任务（如：status=pending的优化任务、日志中的错误和警告、缺失的必要字段）
    • 版本相关："技能版本号需要更新"、"需要记录技能变更"
    • 质量相关："技能格式不正确"、"需要检查技能质量"、"技能测试不通过"
  • This Skill is used to: Drive self-evolution of skills, continuously optimize as the project progresses
  • Capabilities include:
    1. Monitor data stored in skill-manager to identify skill optimization opportunities
    2. Notify users of potential optimization suggestions during idle time
    3. Maintain a list of skill optimization tasks
    4. Execute skill update processes (backup, update, testing, restoration)
    5. Manage skill version numbers
  • Trigger conditions: Triggered by any of the following situations
    • Direct user requests: "Optimize skill", "Improve skill", "Skill needs update", "Skill upgrade", "Fix skill issues"
    • Automatic monitoring trigger: Detects pending optimization tasks in skill data stored in skill-manager (such as optimization tasks with status=pending, errors and warnings in logs, missing required fields)
    • Version-related: "Skill version number needs update", "Need to record skill changes"
    • Quality-related: "Skill format is incorrect", "Need to check skill quality", "Skill test failed"

优化识别

Optimization Identification

数据来源

Data Sources

从skill-manager存储的技能数据中分析优化机会：
  1. 缺失信息：技能配置中缺乏必要字段（如version）
  2. 格式问题：数据格式不符合规范
  3. 重复信息：存在冗余或重复的内容
  4. 使用模式：根据访问频率和方式识别改进点
  5. 错误日志：从日志中识别常见错误或警告
  6. 跨技能协作问题：从其他技能的日志中识别对当前技能的依赖问题或改进建议
Analyze optimization opportunities from skill data stored in skill-manager:
  1. Missing information: Lack of required fields in skill configuration (such as version)
  2. Format issues: Data format does not comply with specifications
  3. Duplicate information: Redundant or duplicate content exists
  4. Usage patterns: Identify improvement points based on access frequency and methods
  5. Error logs: Identify common errors or warnings from logs
  6. Cross-skill collaboration issues: Identify dependency issues or improvement suggestions for the current skill from logs of other skills

优化类型

Optimization Types

  • format_improvement：格式改进
  • content_optimization：内容优化
  • version_update：版本号更新
  • bug_fix：Bug修复
  • feature_enhancement：功能增强
  • format_improvement: Format improvement
  • content_optimization: Content optimization
  • version_update: Version number update
  • bug_fix: Bug fix
  • feature_enhancement: Feature enhancement

进化流程

Evolution Process

步骤1：提醒用户

Step 1: Notify User

自动监控触发

Automatic Monitoring Trigger

智能体定期检查 skill-manager 存储的数据，识别优化机会：
检查工具：调用 
scripts/check_optimization_opportunities.py
bash
undefined
The agent periodically checks data stored in skill-manager to identify optimization opportunities:
Inspection Tools: Call 
scripts/check_optimization_opportunities.py
bash
undefined

检查所有技能

Check all skills

python scripts/check_optimization_opportunities.py
python scripts/check_optimization_opportunities.py

检查特定技能

Check specific skill

python scripts/check_optimization_opportunities.py --skill-name dev-observability

**检查内容**：
1. **待处理任务**：检查 skill-evolution-driver 自身存储的优化任务（status=pending）
2. **缺失字段**：检查技能配置是否缺少必要字段（如 version、deploy_mode、manual_path）
3. **错误日志**：检查技能日志中的 ERROR/WARNING/CRITICAL 日志
4. **目录问题**：检查技能目录结构是否符合规范

**提醒格式**：
检测到潜在优化机会：
  • 技能：skill-name
  • 优化类型：format_improvement
  • 描述：SKILL.md缺少version字段
  • 是否开始优化？（y/n）
undefined
python scripts/check_optimization_opportunities.py --skill-name dev-observability

**Inspection Content**:
1. **Pending tasks**: Check optimization tasks stored in skill-evolution-driver itself (status=pending)
2. **Missing fields**: Check if skill configuration lacks required fields (such as version, deploy_mode, manual_path)
3. **Error logs**: Check ERROR/WARNING/CRITICAL logs in skill logs
4. **Directory issues**: Check if skill directory structure complies with specifications

**Notification Format**:
Potential optimization opportunities detected:
  • Skill: skill-name
  • Optimization type: format_improvement
  • Description: SKILL.md is missing version field
  • Start optimization? (y/n)
undefined

用户主动触发

User-Initiated Trigger

当用户表达以下需求时，直接提醒用户：
  • "优化技能"、"改进技能"
  • "技能需要更新"、"技能升级"
  • "修复技能问题"
  • "技能版本号需要更新"
  • "技能格式不正确"、"需要检查技能质量"
Directly notify the user when the user expresses the following needs:
  • "Optimize skill", "Improve skill"
  • "Skill needs update", "Skill upgrade"
  • "Fix skill issues"
  • "Skill version number needs update"
  • "Skill format is incorrect", "Need to check skill quality"

步骤2：维护任务清单

Step 2: Maintain Task List

若用户同意，调用skill-manager存储优化任务：
json
{
  "task_id": "OPT-001",
  "skill_name": "skill-name",
  "optimization_type": "format_improvement",
  "description": "SKILL.md缺少version字段",
  "status": "pending",
  "feasibility": "pending",
  "backup_path": "",
  "old_version": "",
  "new_version": "",
  "test_result": "",
  "notes": "",
  "created_at": "2024-01-22 12:00:00",
  "updated_at": "2024-01-22 12:00:00"
}
存储方式：更新 skill-evolution-driver 在 skill-manager 中的配置
python
import sys
sys.path.insert(0, '/workspace/projects/skill-manager/scripts')
from skill_manager import SkillStorage

storage = SkillStorage(data_path="/workspace/projects/skill-data.json")
existing_config = storage.get_config("skill-evolution-driver") or {}
existing_config["optimization_tasks"] = [task_dict]  # 任务列表
storage.save_config("skill-evolution-driver", existing_config)
If the user agrees, call skill-manager to store the optimization task:
json
{
  "task_id": "OPT-001",
  "skill_name": "skill-name",
  "optimization_type": "format_improvement",
  "description": "SKILL.md is missing version field",
  "status": "pending",
  "feasibility": "pending",
  "backup_path": "",
  "old_version": "",
  "new_version": "",
  "test_result": "",
  "notes": "",
  "created_at": "2024-01-22 12:00:00",
  "updated_at": "2024-01-22 12:00:00"
}
Storage method: Update the configuration of skill-evolution-driver in skill-manager
python
import sys
sys.path.insert(0, '/workspace/projects/skill-manager/scripts')
from skill_manager import SkillStorage

storage = SkillStorage(data_path="/workspace/projects/skill-data.json")
existing_config = storage.get_config("skill-evolution-driver") or {}
existing_config["optimization_tasks"] = [task_dict]  # Task list
storage.save_config("skill-evolution-driver", existing_config)

步骤3：分析可行性

Step 3: Analyze Feasibility

分析该技能的优化可行性：
可行性评估标准：
  • 技能目录结构完整
  • SKILL.md格式正确
  • 脚本语法正确
  • 依赖关系清晰
  • 优化内容明确
不可行情况：
  • 技能目录不存在或损坏
  • SKILL.md格式错误，无法解析
  • 优化内容不明确或过于复杂
  • 优化可能破坏现有功能
更新任务状态：
  • 可行：
    feasibility: "feasible"
  • 不可行：
    feasibility: "not_feasible"
    ，并在
    notes
    中说明原因
Analyze the feasibility of optimizing the skill:
Feasibility Evaluation Criteria:
  • Complete skill directory structure
  • Correct SKILL.md format
  • Valid script syntax
  • Clear dependency relationships
  • Clear optimization content
Infeasible Scenarios:
  • Skill directory does not exist or is damaged
  • SKILL.md format is incorrect and cannot be parsed
  • Optimization content is unclear or overly complex
  • Optimization may damage existing functions
Update task status:
  • Feasible: 
    feasibility: "feasible"
  • Infeasible: 
    feasibility: "not_feasible"
    , and explain the reason in 
    notes

步骤4：备份技能

Step 4: Backup Skill

调用 
scripts/backup_skill.py
备份技能：
bash
python scripts/backup_skill.py --skill-dir /workspace/projects/skill-name
备份文件格式：
skill-name.backup.<timestamp>.skill
更新任务：
  • backup_path: "/workspace/projects/skill-name.backup.<timestamp>.skill"
Call 
scripts/backup_skill.py
to backup the skill:
bash
python scripts/backup_skill.py --skill-dir /workspace/projects/skill-name
Backup file format: 
skill-name.backup.<timestamp>.skill
Update task:
  • backup_path: "/workspace/projects/skill-name.backup.<timestamp>.skill"

步骤5：更新技能

Step 5: Update Skill

执行具体的优化操作，并更新版本号：
  1. 执行优化：根据优化类型修改技能内容
  2. 更新版本号：调用 
    scripts/update_version.py
bash
python scripts/update_version.py --skill-dir /workspace/projects/skill-name --type patch
版本号类型：
  • patch
    ：修订版本（v1.0.0 -> v1.0.1）
  • minor
    ：次版本（v1.0.0 -> v1.1.0）
  • major
    ：主版本（v1.0.0 -> v2.0.0）
更新任务：
  • old_version: "v1.0.0"
  • new_version: "v1.0.1"
Execute specific optimization operations and update the version number:
  1. Execute optimization: Modify skill content according to optimization type
  2. Update version number: Call 
    scripts/update_version.py
bash
python scripts/update_version.py --skill-dir /workspace/projects/skill-name --type patch
Version number types:
  • patch
    : Patch version (v1.0.0 -> v1.0.1)
  • minor
    : Minor version (v1.0.0 -> v1.1.0)
  • major
    : Major version (v1.0.0 -> v2.0.0)
Update task:
  • old_version: "v1.0.0"
  • new_version: "v1.0.1"

步骤6：进行测试

Step 6: Conduct Testing

对更新后的技能进行测试验证：
测试内容：
  1. SKILL.md格式验证（YAML前言区）
  2. 脚本语法检查（Python语法）
  3. 目录结构验证（符合固定结构）
  4. 依赖完整性检查（dependency字段）
测试脚本：
bash
python scripts/backup_skill.py --validate-only --skill-dir /workspace/projects/skill-name
Test and verify the updated skill:
Testing Content:
  1. SKILL.md format verification (YAML preamble area)
  2. Script syntax check (Python syntax)
  3. Directory structure verification (complies with fixed structure)
  4. Dependency integrity check (dependency field)
Test script:
bash
python scripts/backup_skill.py --validate-only --skill-dir /workspace/projects/skill-name

步骤7：处理测试结果

Step 7: Handle Test Results

测试不通过：
  1. 调用 
    scripts/restore_skill.py
    还原技能
  2. 使用 
    manage_optimization_tasks.py
    更新任务状态
bash
undefined
Test Failed:
  1. Call 
    scripts/restore_skill.py
    to restore the skill
  2. Use 
    manage_optimization_tasks.py
    to update task status
bash
undefined

还原技能

Restore skill

python scripts/restore_skill.py --backup-file <备份路径> --skill-dir /workspace/projects/skill-name
python scripts/restore_skill.py --backup-file <backup path> --skill-dir /workspace/projects/skill-name

更新任务状态

Update task status

python scripts/manage_optimization_tasks.py update
--task-id OPT-001
--status failed
--test-result failed
--notes "测试失败：SKILL.md格式错误"

**测试通过**：
1. 使用 `manage_optimization_tasks.py` 更新任务状态
2. 打包新的.skill文件
3. 告知用户更新内容
4. 提醒用户重新加载技能

```bash
python scripts/manage_optimization_tasks.py update
--task-id OPT-001
--status failed
--test-result failed
--notes "Test failed: SKILL.md format error"

**Test Passed**:
1. Use `manage_optimization_tasks.py` to update task status
2. Package the new .skill file
3. Inform the user of update content
4. Remind the user to reload the skill

```bash

更新任务状态

Update task status

python scripts/manage_optimization_tasks.py update
--task-id OPT-001
--status completed
--test-result passed
--notes "优化成功：已添加version字段"
--new-version v1.0.1
--backup-path /workspace/projects/skill-name.backup.20260122120000.skill

**重要**：必须更新任务状态为 `completed`，避免下次检查时重复提醒相同的优化机会。
python scripts/manage_optimization_tasks.py update
--task-id OPT-001
--status completed
--test-result passed
--notes "Optimization successful: version field added"
--new-version v1.0.1
--backup-path /workspace/projects/skill-name.backup.20260122120000.skill

**Important**: Must update the task status to `completed` to avoid repeated reminders of the same optimization opportunity during next inspection.

步骤8：通知用户

Step 8: Notify User

根据测试结果通知用户：
测试通过：
✓ 技能优化成功
- 技能：skill-name
- 版本：v1.0.0 -> v1.0.1
- 更新内容：添加version字段
- 备份：skill-name.backup.<timestamp>.skill

请重新加载AI交互界面以使用更新后的技能。
测试不通过：
✗ 技能优化失败
- 技能：skill-name
- 原因：测试失败
- 详情：SKILL.md格式错误
- 技能已还原
Notify the user based on test results:
Test Passed:
✓ Skill optimization successful
- Skill: skill-name
- Version: v1.0.0 -> v1.0.1
- Update content: Added version field
- Backup: skill-name.backup.<timestamp>.skill

Please reload the AI interaction interface to use the updated skill.
Test Failed:
✗ Skill optimization failed
- Skill: skill-name
- Reason: Test failed
- Details: SKILL.md format error
- Skill has been restored

核心功能说明

Core Function Description

智能体可处理的功能

Functions Handled by the Agent

  • 监控skill-manager数据，识别优化机会
  • 在空闲时提醒用户优化建议
  • 维护技能优化任务清单
  • 分析优化可行性
  • 执行优化操作
  • 进行测试验证
  • 处理测试结果
  • 通知用户
  • Monitor skill-manager data to identify optimization opportunities
  • Notify users of optimization suggestions during idle time
  • Maintain skill optimization task list
  • Analyze optimization feasibility
  • Execute optimization operations
  • Conduct test verification
  • Handle test results
  • Notify users

脚本实现的功能

Functions Implemented by Scripts

  • 检查优化机会：
    scripts/check_optimization_opportunities.py
    扫描skill-manager数据，自动识别优化机会（过滤已完成的任务）
  • 管理优化任务：
    scripts/manage_optimization_tasks.py
    提供优化任务的增删改查功能（add/update/list）
  • 备份技能：
    scripts/backup_skill.py
    备份整个skill目录
  • 还原技能：
    scripts/restore_skill.py
    从备份还原技能
  • 更新版本号：
    scripts/update_version.py
    增加SKILL.md中的version字段
  • 测试验证：
    scripts/backup_skill.py --validate-only
    验证技能格式
  • Check optimization opportunities: 
    scripts/check_optimization_opportunities.py
    scans skill-manager data to automatically identify optimization opportunities (filter completed tasks)
  • Manage optimization tasks: 
    scripts/manage_optimization_tasks.py
    provides add/delete/update/query functions for optimization tasks
  • Backup skill: 
    scripts/backup_skill.py
    backs up the entire skill directory
  • Restore skill: 
    scripts/restore_skill.py
    restores skill from backup
  • Update version number: 
    scripts/update_version.py
    updates the version field in SKILL.md
  • Test verification: 
    scripts/backup_skill.py --validate-only
    verifies skill format

资源索引

Resource Index

  • 优化机会检查工具：见 scripts/check_optimization_opportunities.py（自动扫描skill-manager数据，识别优化机会，过滤已完成的任务）
  • 优化任务管理工具：见 scripts/manage_optimization_tasks.py（优化任务的增删改查）
  • 备份工具：见 scripts/backup_skill.py（备份技能目录）
  • 还原工具：见 scripts/restore_skill.py（从备份还原技能）
  • 版本管理：见 scripts/update_version.py（更新版本号）
  • 优化指南：见 references/optimization_guide.md（优化类型、测试标准、最佳实践）
  • Optimization opportunity inspection tool: See scripts/check_optimization_opportunities.py (automatically scans skill-manager data to identify optimization opportunities and filter completed tasks)
  • Optimization task management tool: See scripts/manage_optimization_tasks.py (add/delete/update/query of optimization tasks)
  • Backup tool: See scripts/backup_skill.py (backs up skill directory)
  • Restore tool: See scripts/restore_skill.py (restores skill from backup)
  • Version management: See scripts/update_version.py (updates version number)
  • Optimization guide: See references/optimization_guide.md (optimization types, test standards, best practices)

注意事项

Notes

  • 优化前必须备份技能
  • 优化过程中保持task状态同步更新
  • 测试不通过必须还原技能
  • 版本号遵循语义化版本规范
  • 重大变更需用户明确确认
  • 优化完成后必须更新任务状态为 
    completed
    ，避免重复提醒
  • 优化后需提醒用户重新加载技能
  • Must backup the skill before optimization
  • Keep task status synchronized during optimization process
  • Must restore the skill if test fails
  • Version numbers follow semantic versioning specifications
  • Major changes require explicit user confirmation
  • Must update task status to 
    completed
    after optimization to avoid repeated reminders
  • Remind user to reload the skill after optimization

最佳实践

Best Practices

  • 定期监控skill-manager数据，识别优化机会
  • 优先处理高价值、低风险的优化
  • 优化前充分分析可行性
  • 保持详细的优化日志
  • 定期清理过期的备份文件
  • 向用户提供清晰的优化说明
  • Regularly monitor skill-manager data to identify optimization opportunities
  • Prioritize high-value, low-risk optimizations
  • Fully analyze feasibility before optimization
  • Maintain detailed optimization logs
  • Regularly clean up expired backup files
  • Provide clear optimization instructions to users

使用示例

Usage Examples

示例1：添加version字段

Example 1: Add version field

检测到skill-name的SKILL.md缺少version字段。
  1. 提醒用户
  2. 用户同意后，创建优化任务
  3. 分析可行性：可行
  4. 备份技能：skill-name.backup.20240122120000.skill
  5. 更新SKILL.md，添加version: v1.0.0
  6. 测试验证：通过
  7. 更新任务状态：completed
  8. 通知用户：优化成功
Detected that SKILL.md of skill-name is missing version field.
  1. Notify user
  2. Create optimization task after user agrees
  3. Analyze feasibility: feasible
  4. Backup skill: skill-name.backup.20240122120000.skill
  5. Update SKILL.md, add version: v1.0.0
  6. Test verification: passed
  7. Update task status: completed
  8. Notify user: optimization successful

示例2：格式改进

Example 2: Format improvement

检测到skill-name的SKILL.md格式不符合规范。
  1. 提醒用户
  2. 用户同意后，创建优化任务
  3. 分析可行性：可行
  4. 备份技能
  5. 修正SKILL.md格式
  6. 测试验证：通过
  7. 更新任务状态：completed
  8. 通知用户：优化成功
Detected that SKILL.md of skill-name does not comply with format specifications.
  1. Notify user
  2. Create optimization task after user agrees
  3. Analyze feasibility: feasible
  4. Backup skill
  5. Correct SKILL.md format
  6. Test verification: passed
  7. Update task status: completed
  8. Notify user: optimization successful

示例3：不可行的优化

Example 3: Infeasible optimization

检测到skill-name的优化内容过于复杂。
  1. 提醒用户
  2. 用户同意后，创建优化任务
  3. 分析可行性：不可行
  4. 更新任务状态：failed
  5. 更新备注：优化内容过于复杂，需要人工介入
  6. 通知用户：优化不可行，需人工处理
Detected that optimization content of skill-name is overly complex.
  1. Notify user
  2. Create optimization task after user agrees
  3. Analyze feasibility: infeasible
  4. Update task status: failed
  5. Update notes: optimization content is overly complex, requires manual intervention
  6. Notify user: optimization is infeasible, manual processing required