指令发生器

其他 社区

技能解读

当前原文的自动摘译,尚未人工审校。

快速决策:哪个指令文件?

需要·文件·位置适用于整个工作区/所有文件·copilot-instructions.md或AGENTS.md·.github/或根适用于特定文件类型或文件夹·<name>.instructions.md·.github/instructions/适用于用户(跨工作区)·<name>.instructions.md·{{VSCODE_USER_PROMPTS_FOLDER}}/``applyTo模式:

工作流程

按顺序执行以下步骤。完成后标记每个 ✓。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@tomevault-io · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
Python
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第 1 步——明确范围

写之前先回答:这是给谁的?所有团队成员(工作空间)还是仅此用户(用户级别)?哪些文件会触发它?语言、框架、文件夹还是所有文件?什么行为改变?风格、安全规则、禁止模式或工作流程步骤?

02
第 2 步 — 选择深度

变体 · 使用场合 · 目标长度 简洁的规则 · 简单的首选项(命名、样式、导入) · ≤ 20 行 扩展规则 · 脆弱的工作流程、多步骤过程、容易出错的区域 · 20–60 行 基于参考 · 大型规则集;使用渐进式披露 · SKILL 正文 → `details.md` 如果指令正文超过 60 行,请将其拆分:

03
第 3 步 — 编写说明

请参阅 templates/instructions-concise.md 和 templates/instructions-extended.md。从命令行构建存根:

04
第四步——重写模糊规则

通过此测试运行每条规则:“Claude 可以不加判断地确定通过/失败吗?”模糊(拒绝)·具体(接受)“编写好的代码”·“更喜欢纯函数;避免实用程序模块中的副作用”“简洁”·“将函数体保持在 40 行以内;如果超出则提取帮助程序”“正确处理错误”·“在 try/catch 中包装异步调用;向调用者显示错误 - 永远不要吞下”

05
第五步——检查是否存在矛盾

[ ] 此文件中的任何规则是否与其他规则相矛盾? [ ] 是否有任何规则与`.github/copilot-instructions.md`中的现有说明相矛盾? [ ] `applyTo`模式足够精确吗? (过于宽泛的模式 → 高上下文成本)

06
第 6 步 — 验证质量检查表

[ ] 每条规则都是强制性且可验证的(没有“应该”、“尝试”、“考虑”)。 [ ] `applyTo` 模式是正确的 glob 语法 - 针对目标文件路径进行验证。 [ ] 没有时间敏感信息(没有带有到期日期的版本号,没有 API 阶段)。 [ ] 始终使用一致的术语(相同术语表示相同概念)。 [ ] 说明不会重复 VS Code/Copilot 默认值。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。