特工学院任务建设者
- 作者仓库星标 2,528
- 作者仓库 agent-academy
- 领域
- 人工智能
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @microsoft · 未声明许可证
- 上下文用量评级
- 中等消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 允许外网请求
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
在写任何东西之前,请收集以下内容。在一条消息中提问,而不是一次提出一个问题: 所需信息: 任务类型: 课程任务(招募/特工/指挥官)还是特种部队?主题/功能:这涵盖了哪些 Copilot Studio 功能、集成或概念?粗略描述:学习者最终会*构建或做什么*?
使用 `web_search` 和 `web_fetch` 来: 检查重复项:搜索 `site:github.com/microsoft/agent-academy [topic keyword]` 和 `microsoft.github.io/agent-academy [topic keyword]`。如果存在非常相似的东西,请标记它并询问用户是否继续或旋转角度。映射现有任务:获取 https://microsoft.github.io/agent-academy/recruit/ 和
特工学院任务使用军事/间谍行动主题名称。规则: 课程任务:使用`🚨 Mission XX: [Action Verb] + [What They Build]` 示例:`🚨 Mission 03: Create a Multi-Agent Orchestration System` 行动名称出现在简报段落中:`Operation [Codename]` 代号具有戏剧性和主题性:“Operation Talent Scout”、“Operation Symphony”、
不要将这些留空。使用 Copilot Studio 的知识和功能填写它们:写 2-4 段背景。声音:充满活力,而不是枯燥的文档。始终包含一个类比。存储库中现有的:MCP =“AI 集成的 USB-C”Orchestrator =“交响乐指挥”
根据 Copilot Studio 知识填写任务任务:每步一个操作,清晰的动作动词(选择、导航、输入、配置、测试) 粗体 UI 元素名称:测试您的代理、发布、保存 代码格式:要输入的值、字段名称、要发送的测试消息 自由使用 `[!NOTE]`、`[!TIP]`、`[!WARNING]` 标注
有关完整标签分类,请参阅`references/tags.md`。选择1-3个技术标签和1-3个行业标签。难度 = 徽章上的星星数量: 1 颗星:初级(单一功能,30 分钟以下,无需管理员) 2 颗星:中级(2-3 个概念,30-60 分钟,一些配置) 3 颗星:高级(多步骤,VSCode,需要 Azure/管理员,60 分钟以上)
支架 Markdown 文件直接在相应文件夹的存储库中创建任务文件。如果是新兵课程任务,请在`docs/recruit/`下创建一个具有适当任务名称的文件夹,并在其中放置一个`index.md`文件以及一个用于图像的`assets`文件夹,例如`docs/recruit/mcp-lab/index.md`。在各自的文件夹下对特工和指挥官任务重复此模式。对于特种部队,在`docs/special-ops/`下创建一个名为slug的文件夹,并将`index.md`文件和`assets`文件夹放入其中,例如`docs/special-ops/mcp-lab/index.md`。
# Agent Academy Mission Builder
This skill scaffolds new content for the **microsoft/agent-academy** repository at
https://github.com/microsoft/agent-academy. It covers two distinct mission types and handles
everything from naming to final markdown output, including badge generation for Special Ops.
Think of this skill like a mission briefing officer: it gets the concept from you, does the
reconnaissance (checks the repo, checks for duplicates, maps cross-links), then hands you back
a fully briefed document you only need to fill in the "boots on the ground" steps for.
---
## Phase 0: Gather Intel (Interview the User)
Before writing anything, collect the following. Ask in one message, not one question at a time:
**Required info:**
1. **Mission type**: Course mission (Recruit / Operative / Commander) OR Special Ops?
2. **Topic / feature**: What Copilot Studio capability, integration, or concept does this cover?
3. **Rough description**: What will the learner *build or do* by the end?
4. **Difficulty** (for Special Ops): Beginner / Intermediate / Advanced (maps to 1 / 2 / 3 stars)
5. **Prerequisites**: What must the learner have done or have access to?
For **course missions**, also ask:
- Which mission number does this follow? (sets the folder name like `07-`)
- What is the overall course scenario it fits into? (e.g., Operative = Hiring system)
For **Special Ops**, also ask:
- Industry or use-case context (healthcare, retail, HR, IT, finance, etc.)? Or "general"?
- Any specific integrations (SharePoint, Teams, Dataverse, Azure, MCP, etc.)?
If the user hasn't given you enough to go on, ask. Otherwise proceed.
---
## Phase 1: Reconnaissance (Repo Check)
Use `web_search` and `web_fetch` to:
1. **Check for duplicates**: Search `site:github.com/microsoft/agent-academy [topic keyword]`
and `microsoft.github.io/agent-academy [topic keyword]`. If something very similar exists,
flag it and ask the user whether to proceed anyway or pivot the angle.
2. **Map existing missions**: Fetch https://microsoft.github.io/agent-academy/recruit/ and
https://microsoft.github.io/agent-academy/operative/ to get the current mission list.
Use this to:
- Assign the correct next mission number for course missions
- Identify missions to cross-link (e.g., if this mission uses MCP, link to Mission 10 MCP)
- Spot curriculum gaps the new mission fills
3. **Check Special Ops listing**: Fetch https://microsoft.github.io/agent-academy/special-ops/
to see what already exists and identify tags/categories in use.
Report findings briefly before proceeding. If there's a close duplicate, surface it clearly.
---
## Phase 2: Mission Naming
Agent Academy missions use military/spy operation themed names. Rules:
- **Course missions**: Use `🚨 Mission XX: [Action Verb] + [What They Build]`
Examples: `🚨 Mission 03: Create a Multi-Agent Orchestration System`
The operation name appears in the briefing paragraph: `Operation [Codename]`
Codenames are dramatic and thematic: "Operation Talent Scout", "Operation Symphony",
"Operation MCP Rendezvous". They relate to what the mission accomplishes.
- **Special Ops**: The lab *title* is a punchy phrase, often with a symbol if relevant.
Examples: `Microsoft Copilot Studio & MCP`, `Power Platform CLI MCP`
The operation name in the briefing: same dramatic style.
The **badge bottom banner name** is a clever play on the mission topic. See badge section.
**Naming formula for operation codenames**: [Military/Intelligence Term] + [Thematic Noun].
Examples:
- Adaptive Cards → "Operation Flash Card"
- Event Triggers → "Operation Trip Wire"
- AI Safety → "Operation Safe Harbor"
- Document Generation → "Operation Paper Trail"
- Dataverse Grounding → "Operation Deep Root"
Generate 2-3 name options and let the user pick, or auto-select the best one.
---
## Phase 3: Scaffold the Markdown
### Course Mission Template
File: `docs/[rank]/[NN]-[slug]/index.md`
```markdown
---
title: "Mission NN: [Title]"
---
# [Emoji] Mission [NN]: [Full Title]
**Welcome, [Rank].** [1-2 sentence scene-setter in mission briefing voice.]
Your assignment, should you choose to accept it, is **[Operation Codename]** —
[one sentence high-level goal].
[2-3 sentences expanding on what they'll build and how it connects to the course scenario.]
## Mission Objective
By the end of this mission, you will have:
- [Concrete deliverable 1]
- [Concrete deliverable 2]
- [Concrete deliverable 3]
## Prerequisites
Before embarking on this mission, ensure you have:
- Completed [Mission N-1: Title](../[folder]/)
- [Any specific access or setup]
> [!TIP]
> [Optional tip for getting access if stuck]
## Background Intel
> [!NOTE]
> [Key concept explanation — 2-4 paragraphs. Explain the why before the how. Include an analogy.]
## Mission Tasks
### Task 1: [Name]
[Brief intro sentence]
1. [Step 1]
2. [Step 2]
3. [Step 3]
> [!NOTE]
> [Callout with context or warning about a common mistake]
### Task 2: [Name]
[... repeat pattern ...]
## Mission Complete
**Mission [NN] is completed!** You now have mastered the following skills:
✅ **[Skill 1]**: [One sentence — what they can now do]
✅ **[Skill 2]**: [One sentence]
✅ **[Skill 3]**: [One sentence]
## Related Missions
- [Mission N-1: Title](../[prev-folder]/) — [Why it connects]
- [Mission N+1: Title](../[next-folder]/) — [What builds on this]
## Further Reading
- [Microsoft docs link]
- [Related Academy content]
```
### Special Ops Template
File: `docs/special-ops/[slug]/index.md`
```markdown
---
title: "[Mission Title]"
tags:
- [technology-tag]
- [industry-tag]
difficulty: [1|2|3]
---
# [Emoji] [Mission Title]
> **Difficulty**: [stars] | **Time**: ~[N] min | **Type**: Special Ops

**Welcome, agent.** Your mission — should you choose to accept it — is [one-liner].
## What You'll Build
- [Specific deliverable 1]
- [Specific deliverable 2]
- [Specific deliverable 3]
## Prerequisites
- [Access/license requirement]
- [Tool requirement]
> [!WARNING]
> [Access barrier callout if needed]
## Concept Brief
[2-4 paragraphs on the core concept. Why does it exist? When would you use it?
Include an analogy.]
### Key Terms
| Term | Definition |
|------|------------|
| [Term] | [Plain-language definition] |
## The Scenario
> [!NOTE]
> **Scenario:** [Company] is a [industry] company that needs to [problem]. You are building
> an agent that [solution].
## Mission Tasks
### Task 1: [Name]
1. [Step]
2. [Step]
### Task 2: [Name]
[...]
## Mission Accomplished
Congrats, agent — mission accomplished! Claim your badge:
`https://aka.ms/agent-academy-special-ops/[slug]/form`
## Tags
**Technology**: [tag1], [tag2]
**Industry**: [industry]
**Difficulty**: [stars]
## Related Content
- [Relevant course mission link]
- [Official docs link]
```
---
## Phase 4: Auto-Draft Background Intel and Scenario
Don't leave these blank. Fill them in using knowledge of Copilot Studio and the feature:
1. Write 2-4 paragraphs of background. Voice: energetic, not dry docs.
2. Always include an analogy. Existing ones in the repo:
- MCP = "USB-C of AI integration"
- Orchestrator = "symphony conductor"
- Agent = "digital coworker"
Find a new one for the new concept.
3. For Special Ops: draft the fictional scenario with company name, industry, and problem.
---
## Phase 5: Step-by-Step Drafting
Fill in Mission Tasks based on Copilot Studio knowledge:
- One action per step, clear action verbs (Select, Navigate, Enter, Configure, Test)
- Bold UI element names: **Test your agent**, **Publish**, **Save**
- Code format for: values to type, field names, test messages to send
- Use `[!NOTE]`, `[!TIP]`, `[!WARNING]` callouts freely
- Where exact steps are unknown, add `<!-- TODO: Add screenshot -->` and
`[FILL IN: describe what needs to happen here]` placeholders
---
## Phase 6: Tags and Cross-Links (Special Ops Only)
See `references/tags.md` for full tag taxonomy. Select 1-3 technology tags and 1-3 industry tags.
Difficulty = number of stars on the badge:
- 1 star: Beginner (single feature, under 30 min, no admin required)
- 2 stars: Intermediate (2-3 concepts, 30-60 min, some config)
- 3 stars: Advanced (multi-step, VSCode, Azure/admin required, 60+ min)
Always cross-link to the most relevant course mission. Check `docs/recruit/index.md`, `docs/operative/index.md`, `docs/commander/index.md`, and `docs/special-ops/index.md` for the current mission inventory.
---
## Phase 7: Deliver Output
1. **Scaffolded markdown file** create the mission file directly in the repo in the corresponding folder. If it's a recruit course mission, create a folder under `docs/recruit/` with the appropriate mission name and place an `index.md` file inside as well as an `assets` folder for images, for example, `docs/recruit/mcp-lab/index.md`. Repeat this pattern for operative and commander missions under their respective folders. For Special Ops, create the folder under `docs/special-ops/` with the slug name and place the `index.md` file and `assets` folder inside, for example, `docs/special-ops/mcp-lab/index.md`.
2. **Summary** of what was pre-filled vs. what needs manual work (be explicit about TODOs)
3. **Cross-link map** of which missions link here, and where this links
4. **For Special Ops**: Tags, difficulty, badge banner name, and image generation prompt
5. **Duplicate check result** with links to anything similar that exists
End every delivery with:
> "The bones are done. Fill in the step-by-step and swap in real screenshots. Want me to
> draft any specific task section in more detail?"
---
## Reference Files
Read these when needed:
- `WRITING_STYLE.md` (repo root) — Voice, tone, formatting rules
- `docs/recruit/index.md` — Recruit mission inventory for numbering and cross-linking
- `docs/operative/index.md` — Operative mission inventory
- `docs/commander/index.md` — Commander mission inventory
- `docs/special-ops/index.md` — Existing Special Ops for tag patterns and duplicate check 按说明文件中的顺序排列。
第 0 阶段:收集情报(采访用户)
第一阶段:侦察(回购检查)
第二阶段:任务命名
课程任务模板
特种部队模板
文件/命令 -> 07- · web_search · web_fetch · site:github.com/microsoft/agent-academy [topic keyword] · microsoft.github.io/agent-academy [topic keyword] · 🚨 Mission XX: [Action Verb] + [What They Build] · 🚨 Mission 03: Create a Multi-Agent Orchestration System · Operation [Codename]
内容校验值 -> 40f6854cb58b
当前原文的自动摘译,尚未人工审校。
第一阶段:侦察(回购检查)
使用
web_search和web_fetch可以: 检查重复项:搜索site:github.com/microsoft/agent-academy [topic keyword]和microsoft.github.io/agent-academy [topic keyword]。如果存在非常相似的东西,请标记它并询问用户是否继续或旋转角度。映射现有任务:获取 https://microsoft.github.io/agent-academy/recruit/ 和课程任务模板
文件:
docs/[rank]/[NN]-[slug]/index.md特种部队模板
文件:
docs/special-ops/[slug]/index.md