项目指令创建器
把对话中的规则和偏好整理成项目指令文件。
技能明确要求先回顾对话、提取用户偏好,并在规则不清时澄清适用范围;未要求凭据、网络访问或高风险操作。但“保存”指令缺少写入前明确确认、变更范围、回滚方式、数据流披露和敏感信息处理要求,因此扣分。
步骤顺序基本一致,包含澄清、起草、迭代和总结;但依赖未随证据提供的 agent-customization 指南,未定义文件路径、格式校验、写入失败或异常输入的诊断反馈,也没有该技能专用测试,因此仅给静态合理性分。
名称、描述和参数提示明确指向创建项目规则文件,且禁用模型自动调用可避免误触发;但未说明不适用场景、输入边界、不同项目结构下的处理方式、中文输出支持或环境限制,因此触发精度和适用边界证据有限。
YAML 元数据、用途和主要流程清晰,具备一定渐进式结构;但关键指南是外部关联内容且未提供,缺少安装/依赖说明、示例文件、FAQ、已知限制、版本策略、变更记录和明确维护路径,因此扣分。
它覆盖从对话提取规则、澄清范围、起草文件到最终总结的核心流程,预期能完成基础任务;但输出模板、验证标准和可直接使用的示例不足,且需要用户多轮审阅,静态证据不足以证明结果完整或优于手动编辑,因此受限于静态上限给分。
技能文本本身可审计,仓库还提供通用 CI、许可证和治理材料;但没有覆盖该 SKILL.md 关键路径的专用测试、示例执行记录或第三方复现证据,且本次未执行,因此仅给有限可验证性分。
- 该技能依赖未提供的 agent-customization 指南;缺少该文件时,模板和原则无法完整验证。
- 执行保存前应明确确认目标路径、写入内容和覆盖范围,并提供撤销或恢复方案。
- 不要将对话中的凭据、个人信息或其他敏感内容未经筛选写入持久化 instructions.md 文件。
- 当前没有专用测试或执行证据,使用前应人工检查生成文件的格式、范围和实际行为。
它能做什么 & 适用场景
该技能用于创建项目规则或约定对应的 .instructions.md 文件。它会先检查对话历史,提取用户反复强调的修正、偏好、编码模式和项目约定。若规则不明确,它会询问适用范围、技术或文件类型,以及规则是强制要求还是偏好;必要时还会探索代码库。完成草稿后,它会保存指令、指出含糊之处并继续迭代,最后总结规则并建议下一步可创建的定制项。
读取当前对话历史,归纳用户提出的修正、偏好、编码模式和项目约定;在缺少明确规则时询问适用范围、受影响的技术或文件类型,以及规则的强制程度;必要时探索代码库;起草并保存一个 .instructions.md 文件;指出草稿中最含糊或薄弱的部分并请求反馈;在定稿后总结该指令的约束、提供示例提示,并建议相关的后续定制。该技能还要求加载并遵循 agent-customization 技能中的 instructions.md,但该文件内容未包含在本资料中。
- 开发者在多轮对话中反复纠正代码风格,希望把这些修正沉淀为长期项目规则。
- 团队需要为特定文件类型或技术栈建立明确约定,但尚未确定规则适用范围。
- 项目已有一些隐含惯例,使用者希望通过代码库探索补充创建指令所需的上下文。
- 使用者想先生成一个指令草稿,再通过针对含糊部分的问答逐步定稿。
优缺点一览
- 能把对话中的持续性反馈、编码模式和项目约定整理成 .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/ 目录生效。”如果对话中没有形成清晰规则,技能会继续询问适用范围、技术或文件类型以及强制程度。具体的客户端触发方式和生成文件位置未在资料中说明。