2026/9/11 19:30:49

COPILOT.md

COPILOT.md COPILOT.md【免费下载链接】awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-copilot架构决策认证统一走 src/auth 中间件禁止在业务层直接操作 session。模式约定数据访问必须通过 repository 层禁止在 controller 中直接写 SQL。命名约定布尔变量以 is/has/can 开头异步函数以 fetch/save/delete 前缀命名。当前指令文件中即明确建议Add a COPILOT.md file并强调记录Copilot 应当遵循的架构决策与约定。 ### 在复杂模块顶部写策略性注释 在复杂模块开头用两三行描述整体流程或目的能让 Copilot 快速建立模块心智模型 typescript /** * 订单结算流水线 * 1. 校验库存 → 2. 锁定价格 → 3. 扣减余额 → 4. 生成凭证 * 任一步失败则整体回滚并记录审计日志。 */显式引用既有模式直接告诉 Copilot参照某个具体文件比让它自行联想更可靠Follow the same pattern assrc/api/users.tswhen implementing the new products endpoint.这会引导 Copilot 去读取src/api/users.ts复用其路由注册、错误处理与响应包装方式而非凭空发明新风格。多文件改动先讲范围再逐步执行先描述范围Scope First动手改代码之前先把涉及面讲清楚I need to update the User model, API endpoint, and tests.这句提示让 Copilot 建立改动全景避免只改了模型、漏了调用方这类典型遗漏。增量工作Work Incrementally一次只改一个文件每步验证。不要一次索要全部改动——错误被提前拦截且每个 diff 都更易审查。先确认理解Check Understanding在复杂重构前先问What files would you need to see?。这正是仓库中 what-context-needed 技能的标准动作要求 Copilot 在回答前先列出所需文件、说明相关性、标注已见文件与不确定项再回答。配套技能context-map 与 refactor-plancontext-map在动手前生成任务相关文件地图包含 Files to Modify、Dependencies、Test Files、Reference Patterns 与 Risk Assessment破坏性变更 / 数据库迁移 / 配置变更三项风险勾选并要求地图被审查通过后才继续实现refactor-plan多文件重构前输出完整计划明确 Current State → Target State → Affected Files → 分阶段执行先契约与类型、再实现、再调用方、再测试、最后清理→ Rollback Plan → Risks并强制在实现前等待用户确认。配套 Agentcontext-architect仓库中的 context-architect.agent.md 把上述流程固化为一个专门 Agent它在动手前总是先绘制上下文地图、追踪依赖imports/exports/类型引用、核对既有模式、规划改动顺序、定位受影响测试随后输出标准化的 Context Map 并征询确认。其声明的工具集search/codebase、search/usages、read/readFile、edit/editFiles、execute/runInTerminal等与永远先搜索代码库再假设文件位置宁找既有模式不发明新模式范围过大时建议拆分为更小的 PR等准则是本文多文件改动原则的工程化落地。当 Copilot 表现不佳时诊断与修复症状可能原因对策建议明显偏题上下文缺失打开相关文件到标签页或显式粘贴代码片段建议陈旧未感知最近改动重新打开文件或重启会话回答泛泛而谈提示词太笼统增加约束、点明框架、引用既有代码作为参照这四种动作——补上下文、刷新会话、加约束、给范例——覆盖了绝大多数Copilot 不给力场景。若问题依旧可用 what-context-needed 技能让 Copilot 自述它缺什么。落地把上下文工程固化为团队资产awesome-copilot 仓库已将上述方法论封装为可安装的 context-engineering 插件安装方式# Using Copilot CLI copilot plugin install context-engineeringawesome-copilot【免费下载链接】awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-copilot创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考