开发与工程 ✓ Microsoft · 官方 instruction-filesproject-conventionsconversation-analysiscodebase-explorationagent-customization

项目指令创建器

把对话中的规则和偏好整理成项目指令文件。

FollowSkills 评估 · FSRS-2.0
不推荐
51/ 100 五分制 2.6 / 5
信任安全17 / 25 · 3.4/5

技能明确要求先回顾对话、提取用户偏好,并在规则不清时澄清适用范围;未要求凭据、网络访问或高风险操作。但“保存”指令缺少写入前明确确认、变更范围、回滚方式、数据流披露和敏感信息处理要求,因此扣分。

可靠稳定7 / 20 · 1.8/5

步骤顺序基本一致,包含澄清、起草、迭代和总结;但依赖未随证据提供的 agent-customization 指南,未定义文件路径、格式校验、写入失败或异常输入的诊断反馈,也没有该技能专用测试,因此仅给静态合理性分。

适用触发10 / 15 · 3.3/5

名称、描述和参数提示明确指向创建项目规则文件,且禁用模型自动调用可避免误触发;但未说明不适用场景、输入边界、不同项目结构下的处理方式、中文输出支持或环境限制,因此触发精度和适用边界证据有限。

规范维护8 / 15 · 2.7/5

YAML 元数据、用途和主要流程清晰,具备一定渐进式结构;但关键指南是外部关联内容且未提供,缺少安装/依赖说明、示例文件、FAQ、已知限制、版本策略、变更记录和明确维护路径,因此扣分。

有效结果6 / 15 · 2.0/5

它覆盖从对话提取规则、澄清范围、起草文件到最终总结的核心流程,预期能完成基础任务;但输出模板、验证标准和可直接使用的示例不足,且需要用户多轮审阅,静态证据不足以证明结果完整或优于手动编辑,因此受限于静态上限给分。

证据核验3 / 10 · 1.5/5

技能文本本身可审计,仓库还提供通用 CI、许可证和治理材料;但没有覆盖该 SKILL.md 关键路径的专用测试、示例执行记录或第三方复现证据,且本次未执行,因此仅给有限可验证性分。

证据充分度: 评估于 2026年7月20日 审查版本 5b3e1be7be9e
使用前请注意
  • 该技能依赖未提供的 agent-customization 指南;缺少该文件时,模板和原则无法完整验证。
  • 执行保存前应明确确认目标路径、写入内容和覆盖范围,并提供撤销或恢复方案。
  • 不要将对话中的凭据、个人信息或其他敏感内容未经筛选写入持久化 instructions.md 文件。
  • 当前没有专用测试或执行证据,使用前应人工检查生成文件的格式、范围和实际行为。
查看完整评分方法 →

它能做什么 & 适用场景

该技能用于创建项目规则或约定对应的 .instructions.md 文件。它会先检查对话历史,提取用户反复强调的修正、偏好、编码模式和项目约定。若规则不明确,它会询问适用范围、技术或文件类型,以及规则是强制要求还是偏好;必要时还会探索代码库。完成草稿后,它会保存指令、指出含糊之处并继续迭代,最后总结规则并建议下一步可创建的定制项。

读取当前对话历史,归纳用户提出的修正、偏好、编码模式和项目约定;在缺少明确规则时询问适用范围、受影响的技术或文件类型,以及规则的强制程度;必要时探索代码库;起草并保存一个 .instructions.md 文件;指出草稿中最含糊或薄弱的部分并请求反馈;在定稿后总结该指令的约束、提供示例提示,并建议相关的后续定制。该技能还要求加载并遵循 agent-customization 技能中的 instructions.md,但该文件内容未包含在本资料中。

  1. 开发者在多轮对话中反复纠正代码风格,希望把这些修正沉淀为长期项目规则。
  2. 团队需要为特定文件类型或技术栈建立明确约定,但尚未确定规则适用范围。
  3. 项目已有一些隐含惯例,使用者希望通过代码库探索补充创建指令所需的上下文。
  4. 使用者想先生成一个指令草稿,再通过针对含糊部分的问答逐步定稿。

优缺点一览

优点
  • 能把对话中的持续性反馈、编码模式和项目约定整理成 .instructions.md 文件。
  • 支持在规则不明确时主动澄清范围、技术对象和强制程度。
  • 包含草拟、发现歧义、反馈迭代和定稿总结的完整流程。
  • 源仓库 README 声明代码采用 MIT 许可证。
局限
  • 依赖名为 agent-customization 的相关技能及其 instructions.md,但资料没有提供该文件的模板或原则内容。
  • 资料未说明生成的 .instructions.md 保存到哪个具体目录。
  • SKILL.md 标记为 disable-model-invocation: true,不能依赖模型自动调用,需由用户明确触发或由客户端以兼容方式处理。
  • 资料没有提供该单独技能的测试套件、平台测试结果或失败处理细节。

如何安装

该资料未提供单独的安装命令或安装目录规范。此技能位于 microsoft/vscode 仓库的 extensions/copilot/assets/prompts/skills/create-instructions/ 目录;整个仓库采用 MIT 许可证。若要使用,应将该技能目录作为 Agent Skill 提供给兼容的客户端,并确认相关的 agent-customization/instructions.md 可用。

如何使用

在已加载该技能的客户端中,以明确的规则或约定作为请求开始,例如:“为项目创建一条指令:所有 TypeScript 文件使用单引号,并且只对 src/ 目录生效。”如果对话中没有形成清晰规则,技能会继续询问适用范围、技术或文件类型以及强制程度。具体的客户端触发方式和生成文件位置未在资料中说明。

常见问题

这个技能会自动从所有历史对话中生成规则吗?
资料只要求它先检查当前可用的对话历史,并提取其中的修正、偏好、编码模式和项目约定;没有说明会跨会话读取全部历史。
它能处理没有明确规则的请求吗?
可以。没有清晰规则时,它会询问规则应适用于全部内容还是特定文件、涉及哪些技术或文件类型,以及这是强制规则还是偏好。
使用它是否需要网络、MCP 或特定运行时?
资料没有显示它需要网络、MCP、Shell 或特定运行时。它确实涉及读取对话、探索代码库以及保存指令文件,因此需要客户端提供相应的文件系统访问能力。
它是否适合直接安装到任意 Agent Skill 客户端?
它使用 Agent Skill 常见的 SKILL.md 结构,但包含 disable-model-invocation 这一平台相关字段。资料明确支持其在 Claude Code 基线环境中工作;迁移到其他客户端时可能需要调整该字段和触发方式。

同仓库的其他 Skills

均来自 microsoft/vscode

开发与工程 ✓ Microsoft · 官方

工具重命名兼容性检查

防止内置工具重命名破坏现有提示词与工具配置。

开发与工程 ✓ Microsoft · 官方

Copilot Chat OpenTelemetry 埋点指南

为 Copilot Chat 统一设计和维护 OpenTelemetry 埋点。

开发与工程 ✓ Microsoft · 官方

VS Code 配置策略维护助手

规范 VS Code 企业配置策略的注册、导出与验证。

设计与前端 ✓ Microsoft · 官方

VS Code 设计哲学

用价值、原则和设计动作,把“看起来不对”转化为可执行的界面改进。

开发与工程 ✓ Microsoft · 官方

Agent 主机端到端测试助手

用严格的回放夹具维护 VS Code Agent 主机端到端测试。

开发与工程 ✓ Microsoft · 官方

VS Code 集成浏览器架构指南

帮助开发者安全理解和修改 VS Code 集成浏览器的跨进程架构。

开发与工程 ✓ Microsoft · 官方

VS Code Agents 窗口会话架构

帮助代理安全实现和修复 VS Code Agents 窗口功能。

开发与工程 ✓ Microsoft · 官方

智能提交助手

根据仓库惯例生成提交信息并安全提交代码变更。

开发与工程 ✓ Microsoft · 官方

Agent Host 日志分析

定位 Agent Host 导出日志中的会话、传输与主机问题。

开发与工程 ✓ Microsoft · 官方

VS Code 单元测试助手

在 VS Code 源码仓库中按文件、测试名称或匹配模式运行单元测试。

开发与工程 ✓ Microsoft · 官方

VS Code Agent 定制助手

帮助创建、修复和排查 VS Code Agent 定制文件及其加载问题。

开发与工程 ✓ Microsoft · 官方

Code OSS 启动与调试

为 VS Code 源码构建提供隔离启动、Playwright 自动化和多进程调试端口。

开发与工程 ✓ Microsoft · 官方

VS Code 无障碍开发助手

为 VS Code 交互式功能提供可执行的无障碍实现规范。

设计与前端 ✓ Microsoft · 官方

VS Code CSS 布局规范

用 VS Code 规范构建稳健的 CSS 布局与文本截断体验

开发与工程 ✓ Microsoft · 官方

VS Code Chat 性能实验室

基准测试聊天渲染性能,并检测会话中的内存泄漏。

开发与工程 ✓ Microsoft · 官方

组件夹具与截图测试

帮助你为 VS Code 组件创建稳定、可主题化的截图测试夹具。

开发与工程 ✓ Microsoft · 官方

VS Code 冒烟测试助手

运行、筛选并调试 VS Code 端到端冒烟测试。

开发与工程 ✓ Microsoft · 官方

VS Code 崩溃转储符号化

将原生 VS Code 崩溃转储转换为带方法名的可读回溯。

开发与工程 ✓ Microsoft · 官方

VS Code 本地 Web 工作台

在本地 vscode.dev 中验证 VS Code 工作台和 Agents 窗口改动。

开发与工程 ✓ Microsoft · 官方

反馈执行器

读取当前会话反馈并落实对应代码修改。

相关 Skills