Back to Details

auto-updater

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Auto Updater

自动更新工具（Auto Updater）

Overview

概述

auto-updater automatically applies improvements to skills and ecosystem components based on identified patterns and learnings.
Purpose: Automated application of validated improvements across ecosystem
The 5-Step Auto-Update Workflow:
  1. Identify Improvements - Gather recommendations from reviews and learnings
  2. Assess Safety - Determine which can be safely automated
  3. Apply Updates - Implement improvements automatically
  4. Validate Changes - Ensure improvements effective, no regressions
  5. Rollback if Needed - Revert changes if validation fails
Safety: Always validates before finalizing, can rollback
auto-updater会基于识别到的模式和经验，自动对技能及生态系统组件进行优化。
用途：在整个生态系统中自动应用经过验证的优化措施
五步自动更新工作流:
  1. 识别优化点 - 收集评审和经验总结中的建议
  2. 安全性评估 - 判断哪些优化可以安全地自动化执行
  3. 应用更新 - 自动实施优化措施
  4. 验证变更 - 确保优化有效且无回归问题
  5. 必要时回滚 - 若验证失败则撤销变更
安全性：在最终确认前始终会进行验证，支持回滚

When to Use

适用场景

  • Applying systematic improvements across multiple skills
  • Implementing guideline updates ecosystem-wide
  • Automating common enhancement patterns
  • Bulk updates (e.g., add Quick Reference to all skills missing it)
  • 在多个技能中应用系统性优化
  • 在全生态系统范围内实施准则更新
  • 自动化常见的增强模式
  • 批量更新（例如，为所有缺少快速参考的技能添加Quick Reference）

Auto-Update Workflow

自动更新工作流

Step 1: Identify Improvements

步骤1：识别优化点

Sources:
  • system-reviewer recommendations
  • best-practices-learner documented patterns
  • review-multi common findings
  • Manual improvement requests
Output: List of potential improvements
Time: 15-30 minutes
来源:
  • system-reviewer的建议
  • best-practices-learner记录的模式
  • review-multi的常见发现
  • 手动提交的优化请求
输出: 潜在优化点列表
耗时: 15-30分钟

Step 2: Assess Safety

步骤2：安全性评估

Safe to Automate:
  • Structural additions (add Quick Reference section)
  • Content additions (add examples in standard locations)
  • Format standardization (consistent heading levels)
  • Documentation updates (README enhancements)
NOT Safe to Automate:
  • Logic changes (requires understanding context)
  • Content rewrites (needs judgment)
  • Major refactoring (risk too high)
  • Custom implementations
Output: Classified improvements (auto-safe vs manual-only)
Time: 20-40 minutes
可安全自动化的操作:
  • 结构性添加（添加Quick Reference章节）
  • 内容添加（在标准位置添加示例）
  • 格式标准化（统一标题层级）
  • 文档更新（优化README）
不可安全自动化的操作:
  • 逻辑变更（需要理解上下文）
  • 内容重写（需要判断）
  • 重大重构（风险过高）
  • 自定义实现
输出: 分类后的优化点（可自动执行 vs 仅手动执行）
耗时: 20-40分钟

Step 3: Apply Updates

步骤3：应用更新

Process:
  1. Backup affected skills (git commit or copy)
  2. Apply improvement to each skill
  3. Log changes made
  4. Track success/failure per skill
Approach: One skill at a time, validate each before moving to next
Time: Varies by improvement and skill count
流程:
  1. 备份受影响的技能（git commit或复制）
  2. 对每个技能应用优化
  3. 记录所做的变更
  4. 跟踪每个技能的更新成功/失败情况
方法: 逐个处理技能，在处理下一个前先验证当前技能
耗时: 取决于优化内容和技能数量

Step 4: Validate Changes

步骤4：验证变更

For Each Updated Skill:
  1. Run skill-validator (pass/fail)
  2. Run review-multi structure check (score maintained?)
  3. Visual inspection (looks correct?)
  4. Mark as validated or flagged for review
Output: Validation results per skill
Time: 10-15 minutes per skill
针对每个更新后的技能:
  1. 运行skill-validator（通过/失败）
  2. 运行review-multi结构检查（分数是否保持不变？）
  3. 视觉检查（显示是否正确？）
  4. 标记为已验证或需评审
输出: 每个技能的验证结果
耗时: 10-15分钟/技能

Step 5: Rollback if Needed

步骤5：必要时回滚

If Validation Fails:
  1. Identify which skill failed
  2. Restore from backup (git revert or copy back)
  3. Analyze why it failed
  4. Mark improvement as manual-only for that skill
Output: Rolled back skill, failure analysis
若验证失败:
  1. 确定哪个技能验证失败
  2. 从备份恢复（git revert或复制回原文件）
  3. 分析失败原因
  4. 将该技能的此优化标记为仅手动执行
输出: 已回滚的技能、失败分析

Example Auto-Update

自动更新示例

Auto-Update: Add Quick Reference to All Skills Missing It

Step 1: Identify
- Improvements: Add Quick Reference section
- Target Skills: planning-architect, task-development, todo-management
- Count: 3 skills to update

Step 2: Assess Safety
- ✅ Safe: Adding new section (doesn't modify existing content)
- ✅ Safe: Standard format (use template)
- ✅ Safe: Low risk (can validate easily)
- Decision: Auto-update approved

Step 3: Apply
- Backup: Git commit all 3 skills
- Apply to planning-architect: ✅ Success
- Apply to task-development: ✅ Success
- Apply to todo-management: ✅ Success
- Changes: 3/3 skills updated

Step 4: Validate
- planning-architect: 5/5 structure (maintained)
- task-development: 5/5 structure (maintained)
- todo-management: 5/5 structure (maintained)
- All validations: ✅ PASS

Step 5: Rollback
- Not needed (all validations passed)

Result: ✅ 3 skills successfully auto-updated
Time: 90 minutes (vs 3-4 hours manual)
Impact: 100% Quick Reference coverage achieved
Quality: All skills maintained 5/5 scores
Auto-Update: Add Quick Reference to All Skills Missing It

Step 1: Identify
- Improvements: Add Quick Reference section
- Target Skills: planning-architect, task-development, todo-management
- Count: 3 skills to update

Step 2: Assess Safety
- ✅ Safe: Adding new section (doesn't modify existing content)
- ✅ Safe: Standard format (use template)
- ✅ Safe: Low risk (can validate easily)
- Decision: Auto-update approved

Step 3: Apply
- Backup: Git commit all 3 skills
- Apply to planning-architect: ✅ Success
- Apply to task-development: ✅ Success
- Apply to todo-management: ✅ Success
- Changes: 3/3 skills updated

Step 4: Validate
- planning-architect: 5/5 structure (maintained)
- task-development: 5/5 structure (maintained)
- todo-management: 5/5 structure (maintained)
- All validations: ✅ PASS

Step 5: Rollback
- Not needed (all validations passed)

Result: ✅ 3 skills successfully auto-updated
Time: 90 minutes (vs 3-4 hours manual)
Impact: 100% Quick Reference coverage achieved
Quality: All skills maintained 5/5 scores

Quick Reference

快速参考

5-Step Auto-Update Workflow

五步自动更新工作流

StepFocusTimeSafety
IdentifyGather improvements15-30mN/A
Assess SafetyClassify auto-safe20-40mCritical
ApplyImplement changesVariesBackup first
ValidateCheck quality maintained10-15m/skillEssential
RollbackRevert if fails5m/skillSafety net
步骤重点耗时安全性
识别收集优化点15-30分钟不适用
安全性评估分类可自动执行的优化点20-40分钟关键
应用实施变更视情况而定先备份
验证检查质量是否保持10-15分钟/技能必要
回滚失败时撤销5分钟/技能安全保障

Safe vs Unsafe Automation

可安全自动化 vs 不可安全自动化

Safe to Automate:
  • Adding standard sections
  • Format standardization
  • Documentation additions
  • Structural improvements (following patterns)
NOT Safe:
  • Logic changes
  • Content rewrites
  • Major refactoring
  • Custom implementations
Rule: If requires judgment or understanding → Manual only
auto-updater enables safe, validated, automated improvement application across multiple skills simultaneously.
可安全自动化:
  • 添加标准章节
  • 格式标准化
  • 文档补充
  • 结构性优化（遵循既定模式）
不可安全自动化:
  • 逻辑变更
  • 内容重写
  • 重大重构
  • 自定义实现
规则: 若需要判断或理解上下文 → 仅手动执行
auto-updater支持同时对多个技能进行安全、经过验证的自动化优化应用。