القائمة
当用户询问 VS Code API 的定义、methods、interfaces、events、types，或希望了解可用的 VS Code APIs 时使用。 触发场景包括类似 “what does vscode.X do”、“how to use VS Code API”、“VS Code type definition”，或检查 API compatibility 的问题。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | vscode-api |
| description | 当用户询问 VS Code API 的定义、methods、interfaces、events、types，或希望了解可用的 VS Code APIs 时使用。 触发场景包括类似 “what does vscode.X do”、“how to use VS Code API”、“VS Code type definition”，或检查 API compatibility 的问题。 |
| version | 1.0.0 |
| tags | ["vscode"] |
此技能用于从官方的 TypeScript declaration files 和 documentation 中查找 VS Code API definitions。
VS Code API 的 type definitions 来自官方仓库：
Local vscode.d.ts:
./vscode.d.ts
Latest (main branch):
https://raw.githubusercontent.com/microsoft/vscode/main/src/vscode-dts/vscode.d.ts
Current version (matching project's @types/vscode):
https://raw.githubusercontent.com/microsoft/vscode/{version}/src/vscode-dts/vscode.d.ts
官方 documentation 位于 https://code.visualstudio.com/api，提供更丰富的上下文，包括 screenshots、examples 和 guides。请从 overview pages 开始，并按需导航到子页面：
| Section | Entry Point | Use For |
|---|---|---|
| UX Guidelines | /api/ux-guidelines/overview | UI/UX best practices, visual patterns |
| Extension Capabilities | /api/extension-capabilities/overview | Common capabilities, extending workbench |
| Extension Guides | /api/extension-guides/overview | Implementation guides (tree views, webviews, commands, etc.) |
| Language Extensions | /api/language-extensions/overview | LSP, syntax highlighting, language features |
| References | /api/references/vscode-api | API docs, contribution points, activation events |
| Testing & Publishing | /api/working-with-extensions/testing-extension | Testing strategies, bundling |
| Advanced Topics | /api/advanced-topics/extension-host | Extension host, remote development |
读取项目的 package.json 以找到 @types/vscode 版本：
grep -A1 '"@types/vscode"' package.json
版本一般类似 "^1.96.0" —— 提取其基础版本号（例如 1.96.0）。
在以下场景使用 vscode.d.ts：
在以下场景使用 documentation website：
在以下场景同时使用两者：
使用 WebFetch 获取 vscode.d.ts 文件：
项目当前版本：
https://raw.githubusercontent.com/microsoft/vscode/{version}/src/vscode-dts/vscode.d.ts
最新 main branch：
https://raw.githubusercontent.com/microsoft/vscode/main/src/vscode-dts/vscode.d.ts
从顶层 section pages 开始，并按需探索子页面。此方式通常能随 documentation 更新保持最新。
Top-level entry points：
https://code.visualstudio.com/api/ux-guidelines/overview
https://code.visualstudio.com/api/extension-capabilities/overview
https://code.visualstudio.com/api/extension-guides/overview
https://code.visualstudio.com/api/language-extensions/overview
https://code.visualstudio.com/api/references/vscode-api
https://code.visualstudio.com/api/working-with-extensions/testing-extension
https://code.visualstudio.com/api/advanced-topics/extension-host
Navigation strategy：
当用户询问特定 API（例如 TreeView、workspace.onDidChangeConfiguration）时：
当用户希望检查 API changes 或 new features 时：
当展示来自 vscode.d.ts 的 API definitions 时：
// From vscode.d.ts (version X.X.X)
/**
* [JSDoc description from the file]
*/
interface/class/function ApiName {
// ... relevant members
}
当同时呈现 type definitions 与 documentation context 时：
## API: [name]
### Type Definition
[TypeScript definition from vscode.d.ts]
### Documentation
[Summary from code.visualstudio.com/api]
### Key Points
- [Important usage notes]
- [Best practices from UX guidelines if applicable]
- [Related APIs or patterns]
当进行版本对比时，展示两者并附带变更总结：
## API: [name]
### Current (v1.96.0)
[definition]
### Latest (main)
[definition]
### Changes
- [list of differences]
TreeDataProvider, TextDocument, Uri, Position, Rangevscode.window, vscode.workspace, vscode.commandsonDid* patterns like onDidChangeConfigurationDisposableTreeItemCollapsibleState, DiagnosticSeverity@deprecated tags在任何创造性工作之前必须使用此技能——创建功能、构建组件、添加功能或修改行为。在实现之前先探索用户意图、需求和设计。
在需要根据本地改动自动完成提交、推送和语义化打标时使用，尤其适用于发布流程要求 CHANGELOG 存在对应版本条目的场景。
当你有规格说明或需求用于多步骤任务时使用，在动手写代码之前
当创建新技能、编辑现有技能或在部署前验证技能是否有效时使用
创建具有高设计质量、独特的生产级前端界面，或应用 Anthropic 官方品牌视觉风格指南。当用户要求构建 Web 组件、页面、应用程序时，生成富有创意且打磨精良的代码；当涉及品牌色彩、风格指南或公司设计标准时，应用 Anthropic 的外观和感觉。
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.