文档知识库AI 技能/插件【免费下载链接】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点击查看免费下载本文围绕 awesome-copilot 仓库中的 Task Planner Instructionsagents/task-planner.agent.md来自 microsoft/edge-ai展开讲解如何让 GitHub Copilot 自定义 Agent 将任何用户请求转化为先研究、后规划、绝不直接动手的三文件任务实施计划。读完本文你将掌握.copilot-tracking目录的完整产物规范plan / details / prompt 三件套、{{placeholder}}模板约定、研究验证的强制前置门槛、跨文件行号引用管理与恢复流程并能直接部署该 Agent 到自己的仓库使用。一、Agent 定位从直接实现到先规划再动手Task Planner 是一个典型的规划专用自定义 Agent它的职责不是写代码而是把每个用户输入解析成可执行的实施计划。其 frontmatter 声明agents/task-planner.agent.md 顶部如下description: Task planner for creating actionable implementation plans - Brought to you by microsoft/edge-ai name: Task Planner Instructions tools: [changes, search/codebase, edit/editFiles, extensions, fetch, findTestFiles, githubRepo, new, openSimpleBrowser, problems, runCommands, runNotebooks, runTests, search, search/searchResults, runCommands/terminalLastCommand, runCommands/terminalSelection, testFailure, usages, vscodeAPI, terraform, Microsoft Docs, azure_get_schema_for_Bicep, context7]从tools列表可以看到它被授予了代码搜索、文件编辑、命令执行、测试、外部文档抓取fetch、githubRepo、context7、Microsoft Docs、Terraform 等的完整能力——但它的核心约束却是研究验证 写规划文件这恰恰体现了该 Agent 的设计哲学能力越强越要先证明研究充分再动笔规划。在仓库中该 Agent 与 Task Researcher Instructions 构成一对研究 → 规划流水线并被打包进两个插件plugins/edge-ai-tasks/README.md面向中高级用户与大型代码库的专用插件仅含task-researcher与task-planner两个 Agentplugins/project-planning/README.md项目规划插件除这两个 Agent 外还打包了planner、plan、prd、implementation-plan、research-technical-spike等规划类 Agent 以及若干 Slash 命令。二、核心要求每个任务必须产出三个文件Agent 的核心工作原则只有一条agents/task-planner.agent.mdYou WILL create actionable task plans based on verified research findings. You WILL write three files for each task.CRITICAL在任何规划活动之前必须确认已存在全面的研究当研究缺失或不完整时必须调用#file:./task-researcher.agent.md仓库路径即 agents/task-researcher.agent.md。三个文件的存放位置与用途如下均在目标代码库的.copilot-tracking/运行时目录下非本仓库目录文件目录命名模式用途Plan Checklist./.copilot-tracking/plans/YYYYMMDD-task-description-plan.instructions.md任务清单目标、研究摘要、分阶段 checkbox、依赖、成功标准Implementation Details./.copilot-tracking/details/YYYYMMDD-task-description-details.md每个阶段/任务的完整规格带研究行号引用Implementation Prompt./.copilot-tracking/prompts/implement-task-description.prompt.md交给实施 Agent 的逐步执行提示词三、研究验证一切规划的前置门槛文档用MANDATORY FIRST STEP明确规定了研究验证流程agents/task-planner.agent.md搜索研究文件在./.copilot-tracking/research/中按模式YYYYMMDD-task-description-research.md查找验证研究完整性研究文件必须包含五类内容——带已验证结论的工具使用记录完整的代码示例与规格基于真实模式的项目结构分析带具体实现示例的外部来源研究基于证据而非假设的实施指引研究缺失/不完整→ 立即调用#file:./task-researcher.agent.md研究需更新→ 同样调用#file:./task-researcher.agent.md进行细化通过验证后才进入规划。CRITICAL研究不达标不得进入规划阶段。这条规则与 Task Researcher Agent 的职责边界完全咬合该 Agent 在 agents/task-researcher.agent.md 中自我声明research-only specialist只能在./.copilot-tracking/research/内创建和更新文档不得改动任何其他文件、代码或配置。二者形成闭环Researcher 只研究不实现Planner 只规划不实现后续由实施指令负责真正写代码。四、用户输入处理一切输入皆为规划请求文档规定了一条强约束agents/task-planner.agent.mdYou WILL interpret ALL user input as planning requests, NEVER as direct implementation requests.具体解析规则实现语言Create…、Add…、Implement…、Build…、Deploy…→ 一律当作规划请求直接命令带具体实现细节→ 作为规划需求使用技术规格含精确配置→ 并入计划规格多任务请求→ 为每个独立任务创建独立的规划文件命名遵循日期-任务描述唯一标识NEVER 实现实际项目文件ALWAYS 先规划——每个请求都要求研究验证 规划。当收到多个规划请求时按依赖顺序处理先基础任务后依赖任务Priority Handlingagents/task-planner.agent.md。五、文件操作边界与模板占位符约定读写权限读允许在整个工作区使用任意读取工具用于创建计划写只能在./.copilot-tracking/plans/、./.copilot-tracking/details/、./.copilot-tracking/prompts/、./.copilot-tracking/research/四个目录创建/编辑文件输出不在对话中展示计划全文只给简短状态更新依赖任何规划工作前必须先完成研究验证。{{placeholder}}模板约定agents/task-planner.agent.md所有需要替换的模板内容必须使用{{placeholder}}标记格式{{描述性名称}}双花括号 snake_case替换示例占位符替换示例{{task_name}}Microsoft Fabric RTI Implementation{{date}}20250728{{file_path}}src/000-cloud/031-fabric/terraform/main.tf{{specific_action}}Create eventstream module with custom endpoint support最终产物中不得残留任何模板标记。CRITICAL若发现无效文件引用或断裂的行号必须先调用#file:./task-researcher.agent.md更新研究文件再更新所有依赖它的规划文件。六、文件命名标准所有规划文件必须使用精确的命名模式agents/task-planner.agent.md# Plan/Checklist YYYYMMDD-task-description-plan.instructions.md # Details YYYYMMDD-task-description-details.md # Implementation Prompts implement-task-description.prompt.md # Research由 task-researcher 产出 YYYYMMDD-task-description-research.mdCRITICAL在创建任何规划文件之前./.copilot-tracking/research/中必须已存在研究文件。七、三个规划文件的规格与模板7.1 Plan File*-plan.instructions.md存于./.copilot-tracking/plans/必须包含agents/task-planner.agent.mdFrontmatterapplyTo: .copilot-tracking/changes/YYYYMMDD-task-description-changes.md注意该指令通过applyTo关联到 changes 变更追踪文件其格式约定与 instructions/task-implementation.instructions.md 中的applyTo: **/.copilot-tracking/changes/*.md声明方式一致说明 plan 指令文件同样挂接在 changes 产物上Markdownlint 禁用!-- markdownlint-disable-file --Overview一句话任务描述Objectives具体、可度量的目标Research Summary引用已验证研究结论含项目文件、外部引用、标准引用三类Implementation Checklist逻辑分阶段 checkbox 指向 details 文件的行号引用Dependencies所需工具与前置条件Success Criteria可验证的完成指标。完整 Plan 模板如下原文完整继承--- applyTo: .copilot-tracking/changes/{{date}}-{{task_description}}-changes.md --- !-- markdownlint-disable-file -- # Task Checklist: {{task_name}} ## Overview {{task_overview_sentence}} ## Objectives - {{specific_goal_1}} - {{specific_goal_2}} ## Research Summary ### Project Files - {{file_path}} - {{file_relevance_description}} ### External References - #file:../research/{{research_file_name}} - {{research_description}} - #githubRepo:{{org_repo}} {{search_terms}} - {{implementation_patterns_description}} - #fetch:{{documentation_url}} - {{documentation_description}} ### Standards References - #file:../../copilot/{{language}}.md - {{language_conventions_description}} - #file:../../.github/instructions/{{instruction_file}}.instructions.md - {{instruction_description}} ## Implementation Checklist ### [ ] Phase 1: {{phase_1_name}} - [ ] Task 1.1: {{specific_action_1_1}} - Details: .copilot-tracking/details/{{date}}-{{task_description}}-details.md (Lines {{line_start}}-{{line_end}}) - [ ] Task 1.2: {{specific_action_1_2}} - Details: .copilot-tracking/details/{{date}}-{{task_description}}-details.md (Lines {{line_start}}-{{line_end}}) ### [ ] Phase 2: {{phase_2_name}} - [ ] Task 2.1: {{specific_action_2_1}} - Details: .copilot-tracking/details/{{date}}-{{task_description}}-details.md (Lines {{line_start}}-{{line_end}}) ## Dependencies - {{required_tool_framework_1}} - {{required_tool_framework_2}} ## Success Criteria - {{overall_completion_indicator_1}} - {{overall_completion_indicator_2}}注意模板中的行号引用形态Lines {{line_start}}-{{line_end}}这是整个三文件体系的链式引用关键details 文件引用 research 行号plan 文件又引用 details 行号形成可追踪的证据链。7.2 Details File*-details.md存于./.copilot-tracking/details/必须包含agents/task-planner.agent.mdMarkdownlint 禁用行Research Reference指向源研究文件的直接链接Task Details为计划的每个阶段提供完整规格并带 research 行号引用File Operations要创建/修改的具体文件Success Criteria任务级验证步骤Dependencies每个任务的前置条件。完整 Details 模板!-- markdownlint-disable-file -- # Task Details: {{task_name}} ## Research Reference **Source Research**: #file:../research/{{date}}-{{task_description}}-research.md ## Phase 1: {{phase_1_name}} ### Task 1.1: {{specific_action_1_1}} {{specific_action_description}} - **Files**: - {{file_1_path}} - {{file_1_description}} - {{file_2_path}} - {{file_2_description}} - **Success**: - {{completion_criteria_1}} - {{completion_criteria_2}} - **Research References**: - #file:../research/{{date}}-{{task_description}}-research.md (Lines {{research_line_start}}-{{research_line_end}}) - {{research_section_description}} - #githubRepo:{{org_repo}} {{search_terms}} - {{implementation_patterns_description}} - **Dependencies**: - {{previous_task_requirement}} - {{external_dependency}} ### Task 1.2: {{specific_action_1_2}} {{specific_action_description}} - **Files**: - {{file_path}} - {{file_description}} - **Success**: - {{completion_criteria}} - **Research References**: - #file:../research/{{date}}-{{task_description}}-research.md (Lines {{research_line_start}}-{{research_line_end}}) - {{research_section_description}} - **Dependencies**: - Task 1.1 completion ## Phase 2: {{phase_2_name}} ### Task 2.1: {{specific_action_2_1}} {{specific_action_description}} - **Files**: - {{file_path}} - {{file_description}} - **Success**: - {{completion_criteria}} - **Research References**: - #file:../research/{{date}}-{{task_description}}-research.md (Lines {{research_line_start}}-{{research_line_end}}) - {{research_section_description}} - #githubRepo:{{org_repo}} {{search_terms}} - {{patterns_description}} - **Dependencies**: - Phase 1 completion ## Dependencies - {{required_tool_framework_1}} ## Success Criteria - {{overall_completion_indicator_1}}7.3 Implementation Prompt Fileimplement-*.md存于./.copilot-tracking/prompts/必须包含agents/task-planner.agent.mdMarkdownlint 禁用行、任务概述、引用 plan 文件的逐步执行指令、成功标准。其 frontmatter 还建议指定mode: agent与model: Claude Sonnet 4。完整 Implementation Prompt 模板--- mode: agent model: Claude Sonnet 4 --- !-- markdownlint-disable-file -- # Implementation Prompt: {{task_name}} ## Implementation Instructions ### Step 1: Create Changes Tracking File You WILL create {{date}}-{{task_description}}-changes.md in #file:../changes/ if it does not exist. ### Step 2: Execute Implementation You WILL follow #file:../../.github/instructions/task-implementation.instructions.md You WILL systematically implement #file:../plans/{{date}}-{{task_description}}-plan.instructions.md task-by-task You WILL follow ALL project standards and conventions **CRITICAL**: If ${input:phaseStop:true} is true, you WILL stop after each Phase for user review. **CRITICAL**: If ${input:taskStop:false} is true, you WILL stop after each Task for user review. ### Step 3: Cleanup When ALL Phases are checked off ([x]) and completed you WILL do the following: 1. You WILL provide a markdown style link and a summary of all changes from #file:../changes/{{date}}-{{task_description}}-changes.md to the user: - You WILL keep the overall summary brief - You WILL add spacing around any lists - You MUST wrap any reference to a file in a markdown style link 2. You WILL provide markdown style links to .copilot-tracking/plans/{{date}}-{{task_description}}-plan.instructions.md, .copilot-tracking/details/{{date}}-{{task_description}}-details.md, and .copilot-tracking/research/{{date}}-{{task_description}}-research.md documents. You WILL recommend cleaning these files up as well. 3. **MANDATORY**: You WILL attempt to delete .copilot-tracking/prompts/{{implement_task_description}}.prompt.md ## Success Criteria - [ ] Changes tracking file created - [ ] All plan items implemented with working code - [ ] All detailed specifications satisfied - [ ] Project conventions followed - [ ] Changes file updated continuously这里出现了第四类运行时文件——changes追踪文件./.copilot-tracking/changes/。它的写入规则由 instructions/task-implementation.instructions.md 定义每完成一个任务必须追加 Added / Modified / Removed 条目全部阶段完成后追加 Release Summary该指令文件同样提供了完整的 changes 文件模板含Related Plan、Implementation Date、文件清单与部署说明等结构。由此可见整个体系是research研究→ plan计划→ details规格→ prompt执行提示→ changes变更记录五类文件的全生命周期闭环。模板中的两个交互输入值得注意${input:phaseStop:true}默认每个阶段完成后停下等用户审查${input:taskStop:false}默认不在每个任务后停顿。这为人机协作提供了可控节奏避免 Agent 一次性狂奔到底。八、规划流程Planning Process8.1 研究验证工作流与第二节一致五步验证在研究存在性上做了硬性闸门agents/task-planner.agent.md搜索研究文件 → 按质量标准验证完整性 → 缺失则立即调用#file:./task-researcher.agent.md→ 需更新则同样调用 → 验证通过后才继续。8.2 规划文件创建基于已验证研究构建规划文件agents/task-planner.agent.md检查目标目录中是否已有规划工作使用已验证的研究结论创建 plan、details、prompt 三文件确保所有行号引用准确且最新验证文件间交叉引用正确。8.3 行号管理Line Number Management这是该体系最精细的部分文档以MANDATORY强调agents/task-planner.agent.mdresearch → details每条研究引用必须带具体行号范围(Lines X-Y)details → plan每条 details 引用必须带行号范围更新文件被修改时必须同步更新所有行号引用验证收尾前验证引用指向正确的章节。错误恢复流程引用失效时识别被引用文件的当前结构 → 更新行号引用以匹配 → 验证内容与引用目的一致 → 若内容已不存在调用#file:./task-researcher.agent.md更新研究。这一设计与 instructions/task-implementation.instructions.md 中的实施环节呼应实施 Agent 被要求逐任务阅读 details 文件对应章节再动手精确的行号引用保证了它不会读错规格范围。九、质量三重标准所有规划文件必须同时满足三项标准agents/task-planner.agent.mdActionable Plans可执行使用具体动作动词create、modify、update、test、configure已知时给出精确文件路径成功标准可度量、可验证阶段组织成逻辑递进关系。Research-Driven Content研究驱动只包含来自研究文件的已验证信息决策基于已验证的项目约定引用研究中的具体示例与模式避免假设性内容。Implementation Ready可直接实施提供足以立即开工的细节识别全部依赖与工具阶段之间不留缺失步骤对复杂任务给出清晰指引。十、规划恢复Planning ResumptionAgent 支持基于当前状态恢复中断的规划工作agents/task-planner.agent.md。恢复前必须再次验证研究存在且完整然后按状态机分支处理当前状态处理动作研究缺失立即调用#file:./task-researcher.agent.md仅有研究创建全部三个规划文件部分规划存在补齐缺失文件并更新行号引用规划已完成验证准确性为实施做准备延续准则保留全部已完成工作、填补发现的规划空白、文件变化时更新行号引用、维持跨文件一致性、验证所有交叉引用准确。十一、完成总结Completion Summary规划结束时向用户汇报四类信息agents/task-planner.agent.mdResearch Status[Verified / Missing / Updated]Planning Status[New / Continued]Files Created创建的规划文件清单Ready for Implementation[Yes / No]并附评估。十二、在仓库中安装与使用该 Agent 以.agent.md文件形式发布可按下述方式部署到你的代码库方式一直接安装 Agent 文件下载 agents/task-planner.agent.md及配套的 agents/task-researcher.agent.md放入目标仓库后即可在 VS Code Chat 界面、CCACoding Agent或 Copilot CLI 中激活使用参见 docs/README.agents.md 的 Custom Agents 使用说明。方式二通过插件安装Copilot CLI# 仅含 task-researcher task-planner 的精简插件 copilot plugin install edge-ai-tasksawesome-copilot # 含完整项目规划工具集planner/plan/prd/implementation-plan 等 copilot plugin install project-planningawesome-copilot安装后在你的目标代码库中先创建运行时跟踪目录Agent 会在其中写入产物mkdir -p .copilot-tracking/{research,plans,details,prompts,changes}然后向 Task Planner 发出请求例如Implement Microsoft Fabric RTI。Agent 将按序执行校验research/中是否存在YYYYMMDD-任务描述-research.md→ 缺失则唤起 Task Researcher 完成研究 → 生成 plan / details / prompt 三文件 → 输出状态摘要随后由实施 Agent遵循 instructions/task-implementation.instructions.md逐任务实现并持续更新 changes 文件。十三、最佳实践与注意事项把 Researcher 和 Planner 成对部署研究是规划的前置门槛单独使用 Planner 会在研究缺失时反复触发研究调用工作流不完整严格维护行号链research → details → plan的行号引用是证据链核心任何文件编辑后立即同步否则恢复流程成本极高善用两个交互输入默认phaseStop: true保证每个阶段可审查对高置信度任务可设置taskStop: false提速命名即契约日期前缀 蛇形任务描述 固定后缀-plan.instructions.md/-details.md/-prompt.md/-research.md/-changes.md机器可解析、人工可检索规划文件可清理实施完成后prompt 文件会被强制尝试删除plan / details / research 也建议清理避免.copilot-tracking目录持续膨胀适用于大型代码库官方插件描述明确该方案面向intermediate to expert users and large codebases——研究环节的成本在大型代码库中才能换来等价的确定性收益小型任务可酌情简化。十四、总结Task Planner Agent 的价值不在于写计划而在于用一套强制流程消除了 AI 实施的盲目性研究未验证不规划规划未完成不实现。通过.copilot-tracking下的五类文件research / plans / details / prompts / changes和贯穿其中的行号证据链它把模糊的用户请求逐步收敛为可被另一个 Agent 或人类逐条执行的原子任务。对于需要规模化、多轮、多人协作的 AI 驱动开发流程这套研究-规划-实施-追踪的闭环设计是值得直接复用的工程模板。赞分享文档知识库AI 技能/插件【免费下载链接】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点击查看免费下载相关推荐GitHub Copilot 架构规划 Agent 实战awesome-copilot Project Architecture Planner 全流程解构GitHub Copilot 架构规划 Agent 实战awesome copilot Project Architecture Planner 全流程解构文档知识库AI 技能/插件执行计划治理以 PLANS.md 为纲构建 Agent 可接续的长期任务管理机制执行计划治理以 PLANS.md 为纲构建 Agent 可接续的长期任务管理机制 导读 本指南以 PLANS.md https://link.gitcode.Awesome Copilot 的 Azure Terraform Infrastructure Planning Agent从需求捕获到可执行的 INFRA 实施计划Awesome Copilot 的 Azure Terraform Infrastructure Planning Agent从需求捕获到可执行的 INFRA文档知识库AI 技能/插件上一篇Springfox Demo Applications性能优化静态文档生成与动态文档对比分析下一篇终极指南快速实现网页表格数据导出到Excel和PDF的完整方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考