Skip to content

Commit afc0705

Browse files
jeremiah-snee-openxCopilotaaronpowell
authored
Collections Improvement with Tasks Collection POC (#270)
* add yaml block support * Add usage Section to Collections * new edge ai tasks collection with usage example from PR #159 * Update collections/edge-ai-tasks.collection.yml Co-authored-by: Copilot <[email protected]> * Update collections/edge-ai-tasks.md Co-authored-by: Copilot <[email protected]> * Update collections/edge-ai-tasks.collection.yml Co-authored-by: Copilot <[email protected]> * Update collections/edge-ai-tasks.md Co-authored-by: Copilot <[email protected]> * Fixing some bugs in the update script --------- Co-authored-by: Copilot <[email protected]> Co-authored-by: Aaron Powell <[email protected]>
1 parent ccee5c4 commit afc0705

File tree

6 files changed

+368
-46
lines changed

6 files changed

+368
-46
lines changed

‎.schemas/collection.schema.json‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,10 @@
5757
"type": "string",
5858
"description": "Type of the item",
5959
"enum": ["prompt", "instruction", "chat-mode"]
60+
},
61+
"usage": {
62+
"type": "string",
63+
"description": "Optional usage context for the item"
6064
}
6165
}
6266
},
@@ -81,4 +85,4 @@
8185
}
8286
}
8387
}
84-
}
88+
}

‎README.collections.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,5 +25,6 @@ Curated collections of related prompts, instructions, and chat modes organized a
2525
| [Power Apps Code Apps Development](collections/power-apps-code-apps.md) | Complete toolkit for Power Apps Code Apps development including project scaffolding, development standards, and expert guidance for building code-first applications with Power Platform integration. | 3 items | power-apps, power-platform, typescript, react, code-apps, dataverse, connectors |
2626
| [Project Planning & Management](collections/project-planning.md) | Tools and guidance for software project planning, feature breakdown, epic management, implementation planning, and task organization for development teams. | 17 items | planning, project-management, epic, feature, implementation, task, architecture, technical-spike |
2727
| [Security & Code Quality](collections/security-best-practices.md) | Security frameworks, accessibility guidelines, performance optimization, and code quality best practices for building secure, maintainable, and high-performance applications. | 6 items | security, accessibility, performance, code-quality, owasp, a11y, optimization, best-practices |
28+
| [Tasks by microsoft/edge-ai](collections/edge-ai-tasks.md) | Task Researcher and Task Planner for intermediate to expert users and large codebases - Brought to you by microsoft/edge-ai | 3 items | architecture, planning, research, tasks, implementation |
2829
| [Technical Spike](collections/technical-spike.md) | Tools for creation, management and research of technical spikes to reduce unknowns and assumptions before proceeding to specification and implementation of solutions. | 2 items | technical-spike, assumption-testing, validation, research |
2930
| [Testing & Test Automation](collections/testing-automation.md) | Comprehensive collection for writing tests, test automation, and test-driven development including unit tests, integration tests, and end-to-end testing strategies. | 11 items | testing, tdd, automation, unit-tests, integration, playwright, jest, nunit |

‎collections/edge-ai-tasks.collection.yml‎

Lines changed: 90 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,90 @@
1+
id: edge-ai-tasks
2+
name: Tasks by microsoft/edge-ai
3+
description: Task Researcher and Task Planner for intermediate to expert users and large codebases - Brought to you by microsoft/edge-ai
4+
tags: [architecture, planning, research, tasks, implementation]
5+
items:
6+
# Planning Chat Modes
7+
- path: chatmodes/task-researcher.chatmode.md
8+
kind: chat-mode
9+
usage: |
10+
Now you can iterate on research for your tasks!
11+
12+
```markdown, research.prompt.md
13+
---
14+
mode: task-researcher
15+
title: Research microsoft fabric realtime intelligence terraform support
16+
---
17+
Review the microsoft documentation for fabric realtime intelligence
18+
and come up with ideas on how to implement this support into our terraform components.
19+
```
20+
21+
Research is dumped out into a .copilot-tracking/research/*-research.md file and will include discoveries for GHCP along with examples and schema that will be useful during implementation.
22+
23+
Also, task-researcher will provide additional ideas for implementation which you can work with GitHub Copilot on selecting the right one to focus on.
24+
25+
- path: chatmodes/task-planner.chatmode.md
26+
kind: chat-mode
27+
usage: |
28+
Also, task-researcher will provide additional ideas for implementation which you can work with GitHub Copilot on selecting the right one to focus on.
29+
30+
```markdown, task-plan.prompt.md
31+
---
32+
mode: task-planner
33+
title: Plan microsoft fabric realtime intelligence terraform support
34+
---
35+
#file: .copilot-tracking/research/*-fabric-rti-blueprint-modification-research.md
36+
Build a plan to support adding fabric rti to this project
37+
```
38+
39+
`task-planner` will help you create a plan for implementing your task(s). It will use your fully researched ideas or build new research if not already provided.
40+
41+
`task-planner` will produce three (3) files that will be used by `task-implementation.instructions.md`.
42+
43+
* `.copilot-tracking/plan/*-plan.instructions.md`
44+
45+
* A newly generated instructions file that has the plan as a checklist of Phases and Tasks.
46+
* `.copilot-tracking/details/*-details.md`
47+
48+
* The details for the implementation, the plan file refers to this file for specific details (important if you have a big plan).
49+
* `.copilot-tracking/prompts/implement-*.prompt.md`
50+
51+
* A newly generated prompt file that will create a `.copilot-tracking/changes/*-changes.md` file and proceed to implement the changes.
52+
53+
Continue to use `task-planner` to iterate on the plan until you have exactly what you want done to your codebase.
54+
55+
# Planning Instructions
56+
- path: instructions/task-implementation.instructions.md
57+
kind: instruction
58+
usage: |
59+
Continue to use `task-planner` to iterate on the plan until you have exactly what you want done to your codebase.
60+
61+
When you are ready to implement the plan, **create a new chat** and switch to `Agent` mode then fire off the newly generated prompt.
62+
63+
```markdown, implement-fabric-rti-changes.prompt.md
64+
---
65+
mode: agent
66+
title: Implement microsoft fabric realtime intelligence terraform support
67+
---
68+
/implement-fabric-rti-blueprint-modification phaseStop=true
69+
```
70+
71+
This prompt has the added benefit of attaching the plan as instructions, which helps with keeping the plan in context throughout the whole conversation.
72+
73+
**Expert Warning** ->>Use `phaseStop=false` to have Copilot implement the whole plan without stopping. Additionally, you can use `taskStop=true` to have Copilot stop after every Task implementation for finer detail control.
74+
75+
To use these generated instructions and prompts, you'll need to update your `settings.json` accordingly:
76+
77+
```json
78+
"chat.instructionsFilesLocations": {
79+
// Existing instructions folders...
80+
".copilot-tracking/plans": true
81+
},
82+
"chat.promptFilesLocations": {
83+
// Existing prompts folders...
84+
".copilot-tracking/prompts": true
85+
},
86+
```
87+
88+
display:
89+
ordering: alpha # or "manual" to preserve the order above
90+
show_badge: false # set to true to show collection badge on items

‎collections/edge-ai-tasks.md‎

Lines changed: 100 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,100 @@
1+
# Tasks by microsoft/edge-ai
2+
3+
Task Researcher and Task Planner for intermediate to expert users and large codebases - Brought to you by microsoft/edge-ai
4+
5+
**Tags:** architecture, planning, research, tasks, implementation
6+
7+
## Items in this Collection
8+
9+
| Title | Type | Description |
10+
| ----- | ---- | ----------- |
11+
| [Task Researcher Instructions](../chatmodes/task-researcher.chatmode.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Ftask-researcher.chatmode.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Ftask-researcher.chatmode.md) | Chat Mode | Task research specialist for comprehensive project analysis - Brought to you by microsoft/edge-ai [see usage](#task-researcher-instructions) |
12+
| [Task Planner Instructions](../chatmodes/task-planner.chatmode.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Ftask-planner.chatmode.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Ftask-planner.chatmode.md) | Chat Mode | Task planner for creating actionable implementation plans - Brought to you by microsoft/edge-ai [see usage](#task-planner-instructions) |
13+
| [Task Plan Implementation Instructions](../instructions/task-implementation.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Ftask-implementation.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Ftask-implementation.instructions.md) | Instruction | Instructions for implementing task plans with progressive tracking and change record - Brought to you by microsoft/edge-ai [see usage](#task-plan-implementation-instructions) |
14+
15+
## Collection Usage
16+
17+
### Task Researcher Instructions
18+
19+
Now you can iterate on research for your tasks!
20+
21+
```markdown, research.prompt.md
22+
---
23+
mode: task-researcher
24+
title: Research microsoft fabric realtime intelligence terraform support
25+
---
26+
Review the microsoft documentation for fabric realtime intelligence
27+
and come up with ideas on how to implement this support into our terraform components.
28+
```
29+
30+
Research is dumped out into a .copilot-tracking/research/*-research.md file and will include discoveries for GHCP along with examples and schema that will be useful during implementation.
31+
32+
Also, task-researcher will provide additional ideas for implementation which you can work with GitHub Copilot on selecting the right one to focus on.
33+
34+
---
35+
36+
### Task Planner Instructions
37+
38+
Also, task-researcher will provide additional ideas for implementation which you can work with GitHub Copilot on selecting the right one to focus on.
39+
40+
```markdown, task-plan.prompt.md
41+
---
42+
mode: task-planner
43+
title: Plan microsoft fabric realtime intelligence terraform support
44+
---
45+
#file: .copilot-tracking/research/*-fabric-rti-blueprint-modification-research.md
46+
Build a plan to support adding fabric rti to this project
47+
```
48+
49+
`task-planner` will help you create a plan for implementing your task(s). It will use your fully researched ideas or build new research if not already provided.
50+
51+
`task-planner` will produce three (3) files that will be used by `task-implementation.instructions.md`.
52+
53+
* `.copilot-tracking/plan/*-plan.instructions.md`
54+
55+
* A newly generated instructions file that has the plan as a checklist of Phases and Tasks.
56+
* `.copilot-tracking/details/*-details.md`
57+
58+
* The details for the implementation, the plan file refers to this file for specific details (important if you have a big plan).
59+
* `.copilot-tracking/prompts/implement-*.prompt.md`
60+
61+
* A newly generated prompt file that will create a `.copilot-tracking/changes/*-changes.md` file and proceed to implement the changes.
62+
63+
Continue to use `task-planner` to iterate on the plan until you have exactly what you want done to your codebase.
64+
65+
---
66+
67+
### Task Plan Implementation Instructions
68+
69+
Continue to use `task-planner` to iterate on the plan until you have exactly what you want done to your codebase.
70+
71+
When you are ready to implement the plan, **create a new chat** and switch to `Agent` mode then fire off the newly generated prompt.
72+
73+
```markdown, implement-fabric-rti-changes.prompt.md
74+
---
75+
mode: agent
76+
title: Implement microsoft fabric realtime intelligence terraform support
77+
---
78+
/implement-fabric-rti-blueprint-modification phaseStop=true
79+
```
80+
81+
This prompt has the added benefit of attaching the plan as instructions, which helps with keeping the plan in context throughout the whole conversation.
82+
83+
**Expert Warning** ->>Use `phaseStop=false` to have Copilot implement the whole plan without stopping. Additionally, you can use `taskStop=true` to have Copilot stop after every Task implementation for finer detail control.
84+
85+
To use these generated instructions and prompts, you'll need to update your `settings.json` accordingly:
86+
87+
```json
88+
"chat.instructionsFilesLocations": {
89+
// Existing instructions folders...
90+
".copilot-tracking/plans": true
91+
},
92+
"chat.promptFilesLocations": {
93+
// Existing prompts folders...
94+
".copilot-tracking/prompts": true
95+
},
96+
```
97+
98+
---
99+
100+
*This collection includes 3 curated items for tasks by microsoft/edge-ai.*

0 commit comments

Comments
 (0)