Agent Skills
› microsoft/Generative-AI-for-beginners-dotnet
microsoft/Generative-AI-for-beginners-dotnet
GitHub定义多智能体协作规范,包括工作区感知、决策记录及跨智能体沟通模式。通过集中化管理减少冗余,确保团队行为一致,涵盖收件箱提交、审查协议及反模式约束。
安装全部 Skills
npx skills add microsoft/Generative-AI-for-beginners-dotnet --all -g -y
集合内 Skills (67)
按质量分展示前 50 个(共 67 个),完整列表请用安装命令预览或逐个打开详情。
定义多智能体协作规范,包括工作区感知、决策记录及跨智能体沟通模式。通过集中化管理减少冗余,确保团队行为一致,涵盖收件箱提交、审查协议及反模式约束。
需要协调多个智能体共同完成复杂任务时
涉及跨角色决策记录或请求其他智能体协助时
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill agent-collaboration -g -y
用于初始化无团队仓库的两阶段协议。第一阶段识别用户并提议角色,需用户确认;第二阶段创建团队文件、配置及内置代理,实现项目脚手架搭建。
检测到仓库不存在 .squad/team.md 文件
需要为全新或未配置的仓库建立团队协作环境
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill coordinator-init-mode -g -y
该 Skill 用于协调器根据任务复杂度选择 Agent 响应模式(Direct/Lightweight/Standard/Full),提供决策表、示例提示词及升级规则,以优化多智能体协作效率。
路由确定处理 Agent 后需选择响应模式
需要根据任务复杂度决定是否生成 Agent 或并行分发
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill coordinator-response-mode -g -y
定义Squad多智能体协作的文件层级、读写权限及冲突解决规则,明确权威配置与衍生状态文件的归属,用于协调器解析状态归属和审计访问权限。
协调器需要解决文件写入冲突
确定某条状态的所属文件或所有者
审核智能体是否违反追加只读规则
回答关于Squad文件布局的疑问
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill coordinator-source-of-truth -g -y
定义跨仓库 Squad 间通信协议,支持查询、任务委派及上下文共享。提供同步 CLI、只读查询、Git 异步及 GitHub Issue 四种模式,指导代理根据场景选择最优交互方式以实现去运行时环境下的协作。
跨仓库知识查询
任务委派给其他 Squad
跨库依赖分析
跨边界 PR 审查
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill cross-squad-communication -g -y
指导 Agent 在多 Squad 实例间进行工作协调、发现与委派,区分产品级 Squad 与临时任务组,实现跨仓库边界的工作交接。
用户提到 'squad' 且指代独立安装的 Squad 实例
需要跨多个 Squad 或仓库协调工作或委派任务
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill cross-squad -g -y
为智能体提供标准化的错误恢复模式,包括重试、回退、诊断修复、升级和优雅降级。旨在让智能体在失败时自适应而非仅报告错误,提升系统鲁棒性。
API调用或网络请求失败
构建或测试报错
依赖工具不可用
非关键步骤执行失败
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill error-recovery -g -y
定义Squad团队基于dev分支的Git工作流,规范分支命名、PR提交流程及多任务并行开发的Worktree使用方式。
需要遵循团队Git分支规范
在单仓库中并行处理多个Issue
创建或管理功能分支
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill git-workflow -g -y
规范Agent子任务协作的迭代检索技能,通过限制3次循环、强制提供WHY上下文及协调员验证,确保子任务交付质量与闭环。
需要启动子Agent执行特定范围的工作
协调员需验证子Agent输出结果
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill iterative-retrieval -g -y
一种学习捕获技能,通过分析对话中的修正、表扬和边缘情况,提取高/中/低置信度的模式,防止重复错误并优化工作流程。
用户纠正指令
用户表扬反馈
发现边缘案例
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill reflect -g -y
定义代码审查拒绝流程与严格锁定机制,防止作者自我修订,强制由其他代理独立修改或升级,确保审查独立性并处理死锁。
审查者拒绝工作成果
需要指定不同代理进行修订
协调器执行锁定逻辑
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill reviewer-protocol -g -y
规范AI Agent安全处理敏感信息,禁止读取.env等配置文件及输出密钥、密码等敏感数据至提交文件。提供替代方案如读取示例文件或询问用户,并包含预提交扫描机制以防止凭证泄露。
Agent需要读取环境变量或配置时
Agent生成代码、日志或决策记录需写入版本控制前
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill secret-handling -g -y
提供查询 Copilot CLI session_store SQLite 数据库的技能,用于检测因终端崩溃或网络中断导致的未完成任务,并通过检索会话历史、检查点和文件变更来恢复工作上下文。
Agent 会话意外中断后需要恢复
查询近期未完成的 CLI 会话记录
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill session-recovery -g -y
定义Squad CLI工具的开发规范,包括零依赖、Node.js内置测试、错误处理及跨平台文件操作等核心模式。
修改Squad源码时参考编码规范
编写CLI工具功能代码
进行跨平台兼容性开发
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill squad-conventions -g -y
提供Squad自定义Copilot代理的正确调用指南,区分其与Skill的差异,涵盖代理协调、命令查看及项目初始化等场景。
使用Squad构建功能
设置AI团队
查询Squad可用命令
初始化新项目中的Squad
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill squad-help -g -y
解析 Squad CLI 版本管理机制,涵盖版本写入、读取逻辑及升级时的文件保留与覆盖策略。
查询 squad-cli 版本信息
执行或分析 squad upgrade 命令
排查版本相关异常
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill squad-version-check -g -y
Squad CLI的交互式命令目录与菜单技能,支持通过斜杠命令或自然语言触发。提供分类操作导航、参数收集及确认流程,涵盖安装升级、团队管理等功能,路由至对应CLI或协调器Agent。
用户输入 /squad 斜杠命令
询问 'squad commands' 或 'what can squad do'
请求显示 Squad 选项或帮助
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill squad -g -y
提出三层代理记忆模型(热/冷/维基),通过分离当前会话、跨期摘要和持久知识,减少上下文加载量,优化Agent性能与成本。
设计Agent记忆架构
优化上下文管理策略
降低Token消耗
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill tiered-memory -g -y
定义多Agent协作标准,包括工作树感知、决策记录及跨Agent沟通模式。通过集中化管理避免冗余,规范决策写入格式与评审协议,确保团队协同一致。
需要与其他Agent协调工作时
记录影响他人的技术决策时
请求其他成员协助或输入时
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill agent-collaboration -g -y
定义跨团队 Agent 的两项硬性规则:产品隔离(禁止硬编码特定 Agent 名称)和质量检查(完成前运行测试并验证 CI),旨在防止团队间耦合及确保代码质量。
编写或修改涉及多团队共享的测试、CI 工作流或产品代码时
完成开发任务前需要进行最终质量验证和回归测试时
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill agent-conduct -g -y
指导编写架构提案以在编码前对齐共识。涵盖提案结构(问题、方案、影响等)、语气规范、版本重构模式及决策与风险评估,确保文档具体、有据且无夸大。
需要撰写技术架构提案
评估架构变更对现有工作流的影响
进行重大技术决策前的文档对齐
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill architectural-proposals -g -y
定义防御性CI/CD发布模式,涵盖语义化版本校验、NPM自动化令牌验证、注册表重试机制及草稿发布检测,旨在防止因配置错误导致的发布故障。
需要配置或优化npm包发布流程
排查CI/CD流水线中的发布失败问题
制定发布安全规范
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill ci-validation-gates -g -y
定义跨平台(CLI/VS Code等)智能体协调器的检测与适配机制,根据可用工具动态选择spawn策略、并行模式及参数配置,确保多端行为一致。
需要跨平台兼容的Agent调度
根据运行环境自动适配执行逻辑
处理不同IDE或CLI的工具差异
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill client-compatibility -g -y
用于新仓库初始化团队配置的协调技能。检测无团队时,先通过用户交互确认角色与名称,再创建脚手架文件、状态及内置代理,确保敏感信息不存储。
检测到仓库不存在 .squad/team.md 文件
需要从零开始构建团队配置
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill coordinator-init-mode -g -y
提供基于任务复杂度的响应模式(Direct/Lightweight/Standard/Full)决策表、示例提示词及升级规则,用于协调器选择最佳处理流程。
路由确定代理后需选择响应模式
根据任务复杂度决定是否生成代理
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill coordinator-response-mode -g -y
定义多智能体团队的文件权威层级、读写权限及冲突解决规则,区分静态配置与可变状态,为协调器提供文件归属和写入决策依据。
解决文件状态归属疑问
判定谁有权写入特定文件
审查是否违反追加只读规则
裁决文件间冲突
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill coordinator-source-of-truth -g -y
实现跨机器协作,通过Git任务队列和GitHub Issue让不同设备上的Agent自动分配、执行并同步任务结果。
需要跨设备协调Agent工作流
将任务分发到特定远程机器执行
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill cross-machine-coordination -g -y
定义跨仓库 Squad 间通信协议,涵盖同步 CLI、只读查询、Git 异步及 GitHub Issue 委派四种模式,支持知识共享、任务委托与依赖分析。
跨仓库信息交换
任务委派给其他 Squad
跨库依赖分析
跨边界 PR 审查
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill cross-squad-communication -g -y
指导Agent在多Squad实例间进行协作,包括发现、委派和消除歧义。区分产品级Squad与临时代理组,通过注册表发现对等Squad并协调跨仓库工作交接,避免紧耦合。
用户提及spawn, delegate或address squad
任务需跨多个独立Squad实例完成
涉及多仓库协作或架构决策
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill cross-squad -g -y
协调跨机器/组织的开发小组通信,通过Git同步状态文件。生成mesh.json配置、安装同步脚本并初始化远程仓库,使分布式Agent能读取本地化上下文。
多个开发小组位于不同机器或组织
需要跨网络边界同步共享状态文件
配置分布式协作拓扑结构
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill distributed-mesh -g -y
提供基于微软风格指南和团队规范的文档编写标准,涵盖标题、语气、结构及测试同步规则,确保文档一致性。
编写技术文档
审核文档格式
更新文档内容
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill docs-standards -g -y
用于验证协调器和智能体模板变更的端到端测试技能。通过本地构建CLI并运行真实会话,检测LLM运行时提示词回归,确保模板修改不影响Squad会话行为。
修改了协调器提示词文件
修改了智能体章程文件
添加了新的条件块或初始化脚手架
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill e2e-template-testing -g -y
在启用经济模式时,将Layer 3模型选择切换为低成本替代方案,以优化会话或持久化成本。
用户请求使用经济模式以节省成本
检测到配置文件中的economyMode标志
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill economy-mode -g -y
定义通用的错误恢复模式,指导智能体在失败时自适应处理。涵盖重试、降级、修复及上报等策略,旨在提升系统鲁棒性,避免简单报错。
任务执行过程中遇到API超时或网络错误
构建、测试或代码检查出现结构性错误
主用工具不可用且存在替代方案
非关键步骤失败需继续交付部分结果
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill error-recovery -g -y
用于扫描社区未回复的Issue和Discussion,基于分类模板自动生成回复草稿,并强制要求人工审核后方可发布。
用户指令'PAO, check community'
需要批量处理社区反馈
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill external-comms -g -y
用于审查和验证技术内容、引用及API端点的事实核查技能。通过生成反假设并测试证据,对交付物进行质量保障,输出结构化报告以标记声明的可信度。
验证技术内容或交付物的准确性
检查外部引用、URL或API端点的存在性
代理声明包含绝对化词汇或具体百分比阈值时
架构决策前的自动触发审查
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill fact-checking -g -y
指导 AI Agent 在混合使用企业 EMU 和个人 GitHub 账号时,安全识别身份、提取 Token 及隔离配置,避免凭证混淆导致的推送或 PR 创建失败。
需要在默认企业账号下操作个人 GitHub 仓库
AI Agent 需要切换 GitHub 认证上下文
处理多账户 GitHub 凭证冲突
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill gh-auth-isolation -g -y
定义基于 dev 分支的 Squad 协作流程,涵盖分支规范、PR 创建及 issue 状态管理。新增 git worktree 支持并行多任务处理,避免文件冲突并提升多 Agent 协作效率。
需要遵循团队 Git 分支规范进行开发
同时处理多个独立 Issue 需要隔离工作环境
执行代码提交、推送或创建 Pull Request
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill git-workflow -g -y
自动检测多 GitHub 账号并配置别名,区分个人与工作账户。通过 PowerShell 脚本和 CMD 包装器实现一键切换,简化多账号管理流程。
用户拥有多个 GitHub 账号
需要切换不同 GitHub 身份执行操作
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill github-multi-account -g -y
规范 Agent 决策历史记录的维护,要求仅记录最终确认的结果而非中间状态或撤销前的请求。通过确保 history.md 作为唯一事实来源,防止未来 Agent 因读取过时信息而重复错误,提升决策链路的准确性。
需要更新项目决策历史记录时
涉及关键版本或配置变更的最终确认阶段
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill history-hygiene -g -y
规范社区外部回复的语气,确保温暖、人性化且非机器人风格。提供具体写作模式如主动语态、共情标记及示例,用于指导PAO在Issue和讨论中的对外沟通内容生成。
起草面向社区的Issue回复
撰写公开讨论区的回应内容
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill humanizer -g -y
初始化团队配置,先通过算法生成角色提案并等待用户确认,再创建完整的团队目录结构和配置文件。
检测到 .squad/team.md 不存在或成员列表为空
用户请求建立新团队
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill init-mode -g -y
规范多智能体协作的子任务委派流程,通过强制包含背景与成功标准、限制最多3次迭代及协调员验证机制,确保输出质量并防止循环冗余。
需要派生子智能体执行特定范围的任务
多智能体协作中需要结构化交接和结果验证
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill iterative-retrieval -g -y
智能协调器根据五层优先级规则为每个代理选择最合适的LLM模型,支持持久化配置、会话指令及任务类型自动推断,以平衡性能与成本。
用户指定使用特定模型
需要启动新的Agent实例时
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill model-selection -g -y
通过压缩历史、清理旧日志和归档过期决策,释放上下文窗口预算。适用于会话前或文件过大时,维护状态整洁。
history.md超过15KB
.squad/总大小超过1MB
长时间运行后
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill nap -g -y
实现基于主题的通知路由,防止单通道信息过载。通过标签约定和分发器将通知按类型路由至不同渠道,提升告警可见性并减少信号干扰。
多智能体团队通知淹没重要告警
需要按类型分离通知以降低疲劳
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill notification-routing -g -y
管理用户级个人AI代理集合,支持跨项目自动发现、与项目代理合并及隔离读写权限(Ghost Protocol),提供初始化、增删查等CLI命令。
需要跨项目使用个人专属AI助手
配置或查看个人Squad代理状态
启用或禁用个人代理的自动发现功能
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill personal-squad -g -y
指导Agent在修复PR代码后,回复评论线程以建立反馈与解决的追踪链接。通过读取评论、执行代码修改并逐一回复,确保审查者能清晰查看修复内容,提升协作效率。
基于PR审查反馈修复代码
处理Copilot审查建议
响应审查者要求的变更
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill pr-review-response -g -y
自动化捕获UI或文档变更的截图,并通过临时分支托管图片,嵌入GitHub PR描述中供审查,提升视觉变更的Review效率。
PR涉及UI组件或文档站点的视觉变更
需要向PR添加截图以便无需检出代码即可查看效果
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill pr-screenshots -g -y
通过两遍扫描策略优化GitHub Issue监控,首遍轻量列表过滤已分配或低信号问题,次遍按需获取详情,减少72% API调用。
需要批量检查GitHub开放Issue状态
执行Ralph Issue分诊流程
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill ralph-two-pass-scan -g -y


