auto-updater

自动更新器

概述

auto-updater 会根据已识别的模式和经验，自动应用对技能和生态系统组件的改进。

用途：在整个生态系统中自动应用经过验证的改进

自动更新的 5 个步骤：

1. 识别改进 - 收集评审和经验中的建议
2. 评估安全性 - 确定哪些改进可以安全地自动执行
3. 应用更新 - 自动实施改进
4. 验证更改 - 确保改进有效且没有回归
5. 必要时回滚 - 如果验证失败，则撤销更改

安全性：在最终确定前始终进行验证，并可回滚

适用场景

• 在多个技能中应用系统性改进
• 在整个生态系统中实施指南更新
• 自动应用常见的增强模式
• 批量更新（例如，为所有缺少快速参考的技能添加快速参考）

自动更新工作流

第 1 步：识别改进

来源：

• system-reviewer 的建议
• best-practices-learner 记录的模式
• review-multi 中的常见发现
• 手动提出的改进请求

输出：潜在改进列表

耗时：15-30 分钟

---

第 2 步：评估安全性

可安全自动化：

• 结构性新增（添加快速参考部分）
• 内容新增（在标准位置添加示例）
• 格式标准化（统一标题级别）
• 文档更新（改进 README）

不可安全自动化：

• 逻辑更改（需要理解上下文）
• 内容重写（需要判断）
• 大规模重构（风险过高）
• 自定义实现

输出：分类后的改进（可安全自动化 vs 仅限手动）

耗时：20-40 分钟

---

第 3 步：应用更新

流程：

1. 备份受影响的技能（git commit 或复制）
2. 对每项技能应用改进
3. 记录所做的更改
4. 跟踪每项技能的成功或失败情况

方法：一次处理一项技能，每项验证通过后再继续处理下一项

耗时：因改进内容和技能数量而异

---

第 4 步：验证更改

针对每项已更新的技能：

1. 运行 skill-validator（通过/失败）
2. 运行 review-multi 结构检查（评分是否保持不变？）
3. 目视检查（是否正确？）
4. 标记为已验证或待审核

输出：每项技能的验证结果

耗时：每项技能 10-15 分钟

---

第 5 步：必要时回滚

如果验证失败：

1. 确认失败的技能
2. 从备份恢复（git revert 或复制回去）
3. 分析失败原因
4. 将此技能的该项改进标记为仅限手动

输出：已回滚的技能、失败分析

---

自动更新示例

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

---

快速参考

自动更新的 5 个步骤

步骤	重点	耗时	安全性
识别	收集改进	15-30 分钟	不适用
评估安全性	分类可安全自动化的改进	20-40 分钟	关键
应用	实施更改	不定	先备份
验证	检查质量是否保持	每项技能 10-15 分钟	必不可少
回滚	失败时撤销	每项技能 5 分钟	安全保障

安全与不安全的自动化

可安全自动化：

• 添加标准部分
• 格式标准化
• 添加文档
• 结构性改进（遵循既有模式）

不可安全自动化：

• 逻辑更改
• 内容重写
• 大规模重构
• 自定义实现

规则：如果需要判断或理解上下文 → 仅限手动

---

auto-updater 可在多个技能中同时安全、经验证地自动应用改进。