Agent Skills
› microsoft/Generative-AI-for-beginners-dotnet
microsoft/Generative-AI-for-beginners-dotnet
GitHub定义多智能体协作规范，包括工作区感知、决策记录格式及跨代理沟通协议。旨在消除冗余上下文，统一团队行为模式，提升协同效率与一致性。
Install All Skills
npx skills add microsoft/Generative-AI-for-beginners-dotnet --all -g -y
Skills in Collection (67)
Showing top 50 of 67 by quality score. Use the install list command or open individual skills for the rest.
定义多智能体协作规范，包括工作区感知、决策记录格式及跨代理沟通协议。旨在消除冗余上下文，统一团队行为模式，提升协同效率与一致性。
需要与其他智能体协作时
记录影响团队的决策时
请求其他成员输入时
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill agent-collaboration -g -y
用于新仓库初始化Squad团队的协议。分两阶段：先识别用户并提议团队角色配置，等待确认后，再创建脚手架文件、状态及内置智能体。
检测到仓库中不存在 .squad/team.md 文件
需要为全新或未配置的仓库建立团队协作环境
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill coordinator-init-mode -g -y
定义Agent响应模式（Direct/Lightweight/Standard/Full）的选择决策表与模板，根据任务复杂度确定执行层级与资源消耗，指导协调器在路由后选择最佳处理流程。
需要为已分配的任务选择响应模式时
判断任务复杂度以决定是否需要启动Agent或并行处理时
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill coordinator-response-mode -g -y
定义Squad多智能体系统的文件层级、读写权限及冲突解决规则，区分权威配置与衍生状态，用于协调器解析归属权和处理写入冲突。
需要确定文件状态归属
查询文件写入权限
解决文件间冲突
审查是否违反追加-only规则
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill coordinator-source-of-truth -g -y
定义跨仓库 Squad 实例间的通信协议，涵盖同步 CLI、只读查询、Git 异步及 GitHub Issue 委派等模式，支持知识共享、任务委派与依赖分析。
需要向其他 Squad 请求信息或知识
需要将任务委派给其他 Squad
进行跨仓库依赖分析
PR 审查涉及多个仓库
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill cross-squad-communication -g -y
指导Agent在多Squad实例间进行协调、发现与任务委派，区分产品级Squad与临时代理组，通过注册表实现跨仓库协作。
用户提及spawn squads
需要跨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
定义基于dev分支的Squad协作Git工作流，规范分支命名、PR流程及多任务并行处理的git worktree用法。
需要遵循特定Git分支模型进行开发
需要并行处理多个Issue或跨仓库工作
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill git-workflow -g -y
规范子代理任务执行的迭代检索协议，限制最多3个周期，强制提供上下文与成功标准，并由协调员验证输出质量，防止无效循环。
需要委派子代理执行具体任务时
多轮迭代开发或调试场景
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill iterative-retrieval -g -y
用于从对话中提取高/中/低置信度的学习模式，防止重复错误并保留成功经验。在用户纠正、表扬或发现边缘情况时触发，将学到的知识归档至历史或决策文件。
用户纠正（如 no, wrong）
用户表扬（如 perfect, exactly）
发现边缘情况
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代理处理敏感信息的行为，禁止读取.env等密钥文件及在提交文件中输出凭证，提供安全替代方案并增加预提交扫描验证，防止凭据泄露。
需要读取环境变量或配置文件时
生成代码、日志或文档可能包含密钥时
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill secret-handling -g -y
用于恢复因终端崩溃或网络中断而暂停的 Copilot CLI 会话。通过查询 SQLite session_store，查找最近会话、过滤自动化进程并按主题或目录搜索，以便代理重新加载上下文并继续工作。
终端意外断开连接
需要恢复未完成的开发任务
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill session-recovery -g -y
定义Squad CLI工具的代码规范，涵盖零依赖、内置测试、错误处理及跨平台文件操作模式，指导开发者遵循统一标准进行源码修改。
需要遵循Squad项目编码规范时
修改Squad CLI源代码或添加新功能时
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill squad-conventions -g -y
说明Squad是自定义Copilot代理而非技能，指导如何通过task工具调用Squad协调器、使用squad-commands技能查看命令列表及初始化项目，纠正错误调用方式。
用户提到使用Squad或设置团队
询问Squad可用命令或功能
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill squad-help -g -y
记录Squad CLI版本戳记与升级机制，涵盖npm源探测、文件覆盖保留策略及CLI自更新流程。
查询squad-cli版本管理逻辑
了解squad upgrade行为细节
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill squad-version-check -g -y
提供Squad CLI的交互式命令目录，支持安装升级、团队管理、PR处理等功能。通过菜单引导用户选择操作并收集参数，路由至CLI或协调器执行。
用户输入/squad命令
询问squad可用功能
请求显示命令选项
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill squad -g -y
提出三层代理记忆模型（热/冷/维基），旨在解决上下文无限增长问题。通过分离当前会话、跨期摘要和结构化知识，实现按需加载，显著降低每次启动的上下文负载与延迟。
需要优化代理上下文窗口大小
设计代理长期记忆管理策略
减少代理启动时的加载延迟
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill tiered-memory -g -y
定义多智能体协作标准，包括工作树感知、决策记录格式及跨代理沟通协议。集中管理上下文以减少冗余，规范审查拒绝流程，确保团队协同一致性与效率。
需要与其他智能体协作时
进行决策记录或请求协助时
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill agent-collaboration -g -y
定义跨团队Agent的通用硬性规则，包括产品隔离（禁止硬编码特定Agent名称）和同行质量检查（提交前运行测试），确保代码解耦与质量。
需要遵循全局Agent行为准则时
编写或审查涉及多团队交互的代码/测试时
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 模式，包括 semver 验证、NPM Token 检查、重试逻辑和草稿发布检测，旨在防止发布事故。
CI/CD 流水线配置与优化
发布流程故障排查
构建脚本保护策略制定
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill ci-validation-gates -g -y
定义多平台（CLI/VS Code等）下 Agent 的自适应启动策略，通过检测可用工具自动切换并行、模型选择及结果收集逻辑。
需要跨平台适配 Agent 启动逻辑
处理不同环境下的并发与同步差异
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill client-compatibility -g -y
协调器初始化协议，用于在检测到仓库无团队配置时，通过两阶段流程（先提议后创建）引导用户建立AI协作团队。包含识别用户、构建角色阵容及生成Squad脚手架文件。
检测到仓库中不存在 .squad/team.md 文件
需要为全新或从未初始化的仓库设置AI协作环境
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
定义Squad智能体团队的权威文件层级、读写权限及冲突解决规则，明确静态配置与动态状态文件的归属，用于协调器在写入冲突或状态查询时进行裁决。
需要确定文件写入权限
解决多文件状态冲突
查询文件所有权归属
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill coordinator-source-of-truth -g -y
实现跨机器Agent协作，通过Git任务队列和GitHub Issue分配与执行工作，支持多设备间安全共享任务和结果。
需要在不同机器（如笔记本、DevBox）间协调Agent执行任务
通过Git提交或Issue创建跨机器的异步工作任务
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill cross-machine-coordination -g -y
定义跨仓库Squad实例间的通信协议，支持知识查询、任务委派及上下文共享。提供四种模式（CLI同步、只读查询、Git异步、Issue委派）供协调器根据场景选择，确保多Agent环境下的信息交互。
跨仓库知识查询
任务委派给其他Squad
跨仓库依赖分析
跨仓库PR评审
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill cross-squad-communication -g -y
指导Agent在多Squad实例间进行跨团队协作，区分真实Squad与临时任务组，通过注册表发现并协调工作委派、上下文共享及跨库任务分发。
用户提到'spawn squads'或'delegate to squad'
需要跨多个独立Squad实例协作
任务涉及不同仓库或团队边界
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill cross-squad -g -y
用于在多机器、跨组织环境下协调 Squad 协作。通过 Git 同步远程状态，生成 mesh.json 配置及同步脚本，实现分布式 Agent 间的上下文共享与通信。
Squad分布在不同的机器或虚拟机上
需要跨组织或公司获取其他团队的上下文文件
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
用于对协调器和智能体模板变更进行端到端验证，通过运行真实会话检测LLM运行时提示词回归。
修改了协调器提示词或智能体章程等模板文件
添加了新的条件块或修改了初始化脚手架
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill e2e-template-testing -g -y
当用户激活经济模式时，自动将Layer 3任务感知的模型选择切换为低成本替代方案。支持会话短语、持久化配置及CLI触发，旨在降低整体会话或永久性的AI调用成本，同时保留用户对特定模型的显式偏好。
用户输入'use economy mode'等节省成本的指令
检测到.config.json中economyMode为true
执行squad --economy命令
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
需要处理社区未回复的 Issue 或 Discussion
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill external-comms -g -y
用于审查和验证声明，通过反假设测试、核实引用及API端点来确保技术内容质量。适用于架构决策前或含绝对化表述时的自动触发，提供结构化事实核查输出。
验证技术内容准确性
检查引用和API端点有效性
交付物质量保证
代理声明包含绝对化词汇或百分比阈值时
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill fact-checking -g -y
解决AI代理在多GitHub身份（企业EMU与个人）共存时的认证冲突，提供检测身份、提取特定账户Token及隔离配置的方法，确保跨仓库操作安全。
需要区分企业和个人GitHub账号
在默认企业账号下推送个人仓库
创建涉及多身份的Pull Request
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill gh-auth-isolation -g -y
定义基于dev分支的Squad开发工作流，规范分支命名、PR创建及合并流程。支持使用git worktree并行处理多个Issue，实现多Agent隔离协作，提升并发开发效率与代码管理规范性。
需要遵循特定团队Git分支模型进行开发
需并行处理多个独立Issue任务
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill git-workflow -g -y
自动检测并配置 GitHub 多账户别名，通过 PowerShell 函数和 CMD 包装器实现个人与工作账户的快速切换，确保操作安全隔离。
用户拥有多个 GitHub 账户
需要区分个人和工作账户进行 Git 操作
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill github-multi-account -g -y
规范决策历史记录文件的写入行为，确保仅记录最终确认的结果而非中间状态或已撤销的决策。旨在防止未来代理因读取过时或不准确的历史信息而产生错误判断，保证历史数据的准确性和单一真相源。
需要记录项目决策或变更结果时
更新 history.md 等历史追踪文件时
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill history-hygiene -g -y
为社区外部回复提供人性化语气规范，确保温暖、直接且具同理心。涵盖开场、技术解释及结尾等场景的模式与示例，禁止机械或企业化表达。
撰写面向公众的 Issue 回复
生成社区讨论回应
起草对外沟通内容
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill humanizer -g -y
初始化团队配置。当团队文件缺失时，先识别用户并基于项目上下文生成虚拟角色阵容供确认，确认后创建完整的团队目录结构和配置文件。
.squad/team.md 不存在
team.md 中成员列表为空
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill init-mode -g -y
定义多智能体协作中的迭代检索协议，限制3轮循环，强制提供任务背景与成功标准，要求协调者验证输出，确保子任务高效闭环。
需要委派子任务给其他Agent执行时
需要规范多轮次Agent协作流程以确保质量时
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill iterative-retrieval -g -y
用于在Agent启动时根据配置、会话指令或任务类型自动解析并选择最合适的LLM模型，确保模型决策的一致性与持久化。
用户指定使用特定模型
需要启动新的Agent实例
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill model-selection -g -y
通过压缩历史、修剪日志和归档过期状态，清理上下文窗口预算。适用于长会话后或即将进行大量代理分发前，防止上下文溢出并优化存储。
long-running sessions
heavy fan-out work
history.md exceeds 15KB
.squad/ total size exceeds 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代理集合，支持自动发现、角色定义及与项目代理的隔离协作。提供初始化、增删查等CLI命令，通过幽灵协议确保个人代理仅建议不修改项目状态，实现用户级AI助手随项目流转。
需要配置或管理个人级别的AI代理
在多项目中复用相同的AI助手角色
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill personal-squad -g -y
指导 Agent 在修复 PR 审查意见后，通过 API 回复评论线程并可选标记已解决，确保修改可追溯。仅负责沟通反馈，不包含代码修复本身。
基于 PR 审查反馈修复代码
处理 Copilot 审查建议
响应审查者要求的变更
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill pr-review-response -g -y
自动化捕获 UI、文档站或生成页面的 Playwright 截图，通过临时分支托管图片并嵌入 GitHub PR 描述，辅助视觉变更审查。
PR 包含 UI 组件变更
PR 修改文档站点页面
PR 生成可视化产物
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill pr-screenshots -g -y
优化GitHub Issue扫描流程，通过两遍扫描减少API调用。第一遍轻量筛选，第二遍按需获取详情，降低72%开销，提升工单监控效率。
需要高效扫描GitHub仓库Issue列表
优化Issue triage或监控脚本性能
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill ralph-two-pass-scan -g -y
