技能更新助手
将重要的仓库经验沉淀为可复用的技能或指令。
技能仅指导在仓库内检查、创建或更新技能和说明文件，未见恶意行为、凭证窃取或外部数据外传；README、LICENSE 和官方 Microsoft 来源提供了可追溯归属。但它没有要求在覆盖现有文件前取得用户确认，没有定义备份、回滚、最小修改范围或敏感信息处理规则，因此扣分。
流程包含触发条件、分类决策、文件检查、质量检查和用户告知步骤，正常路径较清楚。可是“major learning”判断主观，命令依赖本地目录和 grep，未定义缺失文件、冲突内容、写入失败或验证失败时的诊断与恢复方式；静态审查按上限给分，扣除执行证据相关分数。
目标受众和触发场景较明确，包括“learn!”、重大模式、陷阱和可复用知识；技能与仓库维护任务匹配，也没有依赖海外服务。对非适用场景、学习重要性的判定标准、中文工作流和不同代理目录布局的边界说明不足，因此扣分。
文档有 frontmatter、分层标题、Skill/Instruction/Learning 决策、路径约定、示例模板、质量检查和完成后告知要求，具备较好的可读性。缺少安装或依赖说明、版本策略、变更日志、明确维护责任和更新流程；许可证信息只能由仓库上下文补充，不能视为技能自身完整治理，因此扣分。
该技能能把会话中的经验转化为持久化仓库文档，并提供了可直接执行的分类和写作步骤，核心价值可信。由于没有代表性生成结果、自动校验或测试证明，且最终内容仍依赖用户或代理的判断和手工编辑，静态条件下不能超过 7 分并作扣减。
技能正文、仓库许可证、README、版本信息和相关 CI/test 文件均可审计，触发条件和文件格式可复核。没有针对该技能关键路径的专门测试、实际运行记录或第三方复现证据，因此只能接近静态审查上限 5 分，未给满分。
- 更新现有技能或说明文件前应明确展示差异并获得用户确认，同时保留可回滚的备份或版本控制记录。
- 应补充缺失目录、命令失败、重复知识、命名冲突和写入失败时的处理与诊断说明。
- “重大学习”和“值得长期保存”的判定较主观，建议增加可操作的阈值和不适用案例。
它能做什么 & 适用场景
此技能用于在会话中发现重要的仓库经验后，创建或更新持久化的技能与指令。它覆盖经验识别、现有文件检查、内容归档、质量检查和向用户说明结果的流程。技能会根据知识规模和适用范围，在现有指令、新技能或新指令之间做出归类。它适合需要持续积累项目知识的开发仓库维护工作。
识别重复出现的模式、非显而易见的陷阱、架构约束和可复用领域知识；使用 ls 检查 .github/skills/、.agents/skills/ 和 .github/instructions/，使用 grep 搜索相关内容；将小型经验加入现有指令的 ## Learnings 部分，或创建、更新 .github/skills/{name}/SKILL.md 与 .agents/skills/{name}/SKILL.md；也可以创建带有 applyTo 的指令文件；保存前检查内容的通用性、可操作性、示例、重复情况和描述清晰度，并向用户说明保存位置及变更类型。
- 维护 VS Code 等大型仓库的开发者：在发现重要架构约束后，将其保存为未来会话可复用的知识。
- 代理用户：用户明确说“learn!”时，按照既定流程归档学习内容。
- 项目贡献者：发现一个反复出现的调试陷阱时，判断应加入现有指令还是创建独立技能。
- 仓库维护者：需要让某条规则按文件模式自动生效时，将其整理为带 `applyTo` 的指令。
优缺点一览
- 提供了从识别学习到保存和告知用户的完整归档流程。
- 明确区分学习、技能和指令，帮助选择合适的持久化位置。
- 要求加入具体示例，并检查通用性、可操作性和重复内容。
- 纯粹使用 `SKILL.md`、shell 命令和文件操作，便于兼容通用 Agent Skills 客户端。
- 它描述的是工作流程和文件约定，没有提供自动化脚本或测试套件。
- 源材料没有记录独立安装方式、客户端配置方式或失败恢复流程。
- 分类和内容质量仍依赖代理对学习规模、领域范围及适用性的判断。
如何安装
源材料未提供独立安装命令。该技能位于 src/vs/sessions/skills/update-skills/SKILL.md；完整技能集合可从 https://github.com/microsoft/vscode 获取。仓库整体采用 MIT 许可证。
如何使用
在兼容 Agent Skills 的客户端中加载该技能，并在发现重要仓库经验时发送 learn!，或明确要求捕获一项学习。源材料未规定更具体的客户端配置、触发器注册或独立运行命令。