VS Code Agents 窗口会话架构
帮助代理安全实现和修复 VS Code Agents 窗口功能。
技能将范围限定为 src/vs/sessions/，要求先阅读规范，并强调 provider 隔离、权限拒绝语义和避免不安全时序；未说明用户确认、敏感数据流、变更回滚或外部副作用控制，因此扣分。
内容高度具体且规则大体一致，覆盖入口、状态、异步和异常边界；但仅静态阅读，未见针对该技能关键路径的专门测试、执行结果或统一故障诊断流程，按静态上限保守扣分。
目标受众和触发场景（实现或修复 Agents window）明确，且覆盖桌面、移动和 provider 边界；未明确非适用任务、输入输出格式、语义排除条件及中文或中国大陆网络环境适配，因此扣分。
文档采用前置要求、规范表和常见陷阱的分层结构，路径与命名较稳定，仓库还提供 MIT 许可、Microsoft 归属和 CI 维护信号；技能本身缺少版本、变更记录、安装依赖、FAQ 和明确维护责任说明。
规则可直接指导 Agents window 的代码修改，包含许多具体错误模式和修复方向；但没有技能输出模板、代表性完成结果或专门验证证据，实际收益和完整性只能部分确认。
技能引用了具体规范、入口和实现概念，仓库存在相关 CI 与测试基础设施；但提供材料未证明这些测试覆盖该技能关键路径，也未给出该修订版的执行结果，因此不能超过静态证据水平。
- 该技能依赖大量未随本次材料提供的 sessions 规范文件；使用者应确认这些路径和内容在目标修订版中存在且保持同步。
- 不要将仓库级 CI 或 Microsoft 身份误认为该技能已被独立验证；本评估未执行代码或测试。
- 规则数量很多但缺少优先级和冲突处理说明，复杂修改时可能需要人工判断。
它能做什么 & 适用场景
这是 microsoft/vscode 仓库中针对 Agents 窗口会话架构的单个 Agent Skill，路径为 .github/skills/sessions/SKILL.md。它覆盖 agents-first 应用的分层、目录结构、聊天组件、菜单、贡献点、入口文件和开发规范。修改 src/vs/sessions/ 下的代码前，Skill 要求先阅读编码指南、源码组织指南和相关规格文档，并在实现变化时同步更新规格。它适合需要直接维护 VS Code Agents 窗口代码的开发代理，而不是一般的聊天或编辑器使用场景。
它指导代理在修改代码前读取 .github/instructions/ 下的两份指南，以及 src/vs/sessions/ 下与改动相关的层级、布局、会话、会话列表、移动端或 AI 自定义规格文档。它要求代理遵守 core → services → contrib → providers 的内部层级、使用正确的 Sessions 菜单注册表、通过 IObservable 传播会话状态，并将新的贡献文件接入相应的 sessions.*.main.ts 入口。它还提供大量具体的实现陷阱和修复规则，涉及布局恢复、会话与聊天区分、提供方隔离、移动端布局、编辑器标签、权限处理、子代理聊天和异步状态管理。其产出是遵循这些约束的 Agents 窗口代码变更及同步的规格更新；源码没有提供可执行脚本或独立命令。
- VS Code 开发者要在 src/vs/sessions/ 中新增 Agents 窗口功能时，用它确定必须阅读的指南和规格。
- 维护者修复会话切换、布局恢复、侧边栏或辅助栏行为时，用它检查状态同步和网格布局约束。
- 开发者修改会话提供方、聊天数据流或多聊天支持时，用它避免跨提供方依赖和错误的会话模型访问。
- 负责移动端 Agents 窗口界面的工程师，用它查阅手机视口、抽屉式侧边栏和视图门控规则。
- 需要调整 Agents 窗口菜单、编辑器集成或贡献入口的贡献者，用它确认注册位置和加载入口。
优缺点一览
- 覆盖 Agents 窗口从分层、布局、会话模型到入口加载的多个工程约束。
- 包含许多针对真实实现错误的具体规则，例如避免用延时修复竞态、保持提供方隔离和使用可观察状态。
- 与 VS Code 源码目录和规格文件路径直接对应，适合仓库内开发维护。
- 所在仓库采用 MIT 许可证，并由 Microsoft 与社区共同开发。
- 范围严格限定在 VS Code Agents 窗口，不能代表仓库中其他 60 个 Skill 的能力。
- 使用它需要访问并理解 VS Code 源码及相关规格文档，学习成本高于通用编码 Skill。
- 提供的 SKILL.md 在当前资料中被截断，未展示部分应视为未知。
- 源材料没有提供该 Skill 的独立安装命令、测试套件或运行时依赖说明。
如何安装
该 Skill 位于仓库的 .github/skills/sessions/SKILL.md。将 microsoft/vscode 仓库中的这一 Skill 文件置于兼容 Agent Skills 的目录结构中即可保留其路径和上下文；源材料没有说明某个客户端的具体安装命令或目录。
如何使用
在需要实现或修复 Agents 窗口功能时触发它，例如："请修改 src/vs/sessions/ 中的会话列表，并先阅读相关 coding guidelines、source-code-organization 和 SESSIONS_LIST 规格；完成后同步更新规格。" 实际改动前应按 Skill 中的顺序阅读强制文档和相关规格。