Agent Skills
› microsoft/Generative-AI-for-beginners-dotnet
microsoft/Generative-AI-for-beginners-dotnet
GitHub定义多Agent协作标准，包括工作区感知、决策记录及跨Agent沟通规范。集中管理协作模式，消除冗余上下文，确保团队协同一致性与流程规范。
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.
定义多Agent协作标准，包括工作区感知、决策记录及跨Agent沟通规范。集中管理协作模式，消除冗余上下文，确保团队协同一致性与流程规范。
需要与其他Agent协作时
记录影响他人的决策时
执行代码或任务审查时
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill agent-collaboration -g -y
协调器初始化协议，用于在无团队仓库中引导用户创建Squad。分两阶段：先提议角色并等待确认，再生成脚手架文件与内置Agent配置，确保敏感信息不写入且符合安全规范。
检测到仓库根目录下不存在.squad/team.md文件
需要初始化全新的Squad团队环境
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill coordinator-init-mode -g -y
该 Skill 用于协调者在路由工作后，根据任务复杂度选择 Agent 响应模式（Direct/Lightweight/Standard/Full），提供决策表、示例及升级规则，以优化协作效率。
已确定负责 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
定义跨仓库AI团队（Squad）间的通信协议，支持知识查询、任务委托及上下文共享。提供四种交互模式：同步CLI、只读查询、Git异步及GitHub Issue委托，并包含选型决策树与强制参数规范，确保不同运行时环境下的信息准确交换。
需要跨仓库获取知识或信息
需将任务委托给其他独立团队
涉及跨仓库的依赖分析或PR审查
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill cross-squad-communication -g -y
指导Agent在多Squad实例间进行协作，包括发现、委派和消歧。明确区分产品级Squad与临时任务组，通过注册表实现跨仓库工作交接，避免紧密耦合。
用户提到'squad'并涉及多实例协调
需要跨团队或跨仓库分配任务
用户请求生成或委托给独立的Squad
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill cross-squad -g -y
定义通用错误恢复模式，指导智能体在失败时自适应处理。涵盖重试退避、替代方案、诊断修复、上下文升级及优雅降级，旨在提升系统韧性与自动化效率。
任务执行过程中发生错误或异常
需要制定或优化错误处理策略
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill error-recovery -g -y
定义Squad团队的Git分支模型与工作流，涵盖从dev分支开发、PR创建到合并清理的标准流程。新增git worktree支持多任务并行隔离开发，确保高效协作与代码发布管理。
需要遵循团队Git分支规范
执行功能开发与PR提交流程
处理多个并发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
用于捕获对话中的高/中/低置信度模式，从用户纠正、表扬或边缘案例中提取经验教训，防止重复错误并优化工作流。
用户纠正指令
用户表达赞赏
发现边缘情况
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
规范 Agent 处理敏感信息，禁止读取 .env 等含凭据文件及向 .squad/ 写入密钥，提供安全替代方案与提交前扫描验证机制。
Agent 需要读取配置文件或环境变量时
Agent 准备将日志、决策或代码片段提交到 git 仓库时
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill secret-handling -g -y
该技能指导Agent通过查询SQLite session_store数据库，识别因终端崩溃或网络中断而暂停的Copilot CLI会话。它提供多种SQL模式来过滤自动化会话、按主题或目录搜索，并获取上下文以便恢复未完成的工作。
恢复被中断的CLI会话
查询历史会话状态
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill session-recovery -g -y
定义Squad CLI工具的代码规范，包括零依赖、Node.js内置模块使用、错误处理及跨平台文件操作等开发约定。
需要遵循Squad项目编码规范时
修改Squad CLI源码或模板时
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill squad-conventions -g -y
说明 Squad 是自定义 Copilot Agent 而非 Skill，指导用户通过 task 工具调用协调器、使用 squad-commands 查看命令或执行 squad init 初始化项目。
用户请求使用 Squad 或组建 AI 团队
用户询问 Squad 可用命令或功能选项
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill squad-help -g -y
解析 Squad CLI 的版本标记机制与升级逻辑，涵盖版本探测、文件覆盖/保留策略及 npm 注册表查询，辅助协调器进行版本管理。
需要更新或检查 @bradygaster/squad-cli 版本时
执行 squad upgrade 命令前需确认行为时
查询 npm 注册表以获取最新可用版本时
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill squad-version-check -g -y
Squad CLI 交互式命令目录与菜单技能，提供安装升级、团队管理等功能导航。
用户输入 /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
定义多智能体协作规范，涵盖工作区感知、决策记录及跨代理沟通。提供标准化格式与反模式，确保团队上下文一致性与流程合规，避免冗余与冲突。
需要记录影响他人的技术决策
请求其他智能体协助或输入
执行代码审查并拒绝提交
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill agent-collaboration -g -y
为所有团队代理提供共享的硬性规则，包括产品隔离（禁止硬编码特定代理名称）和质量检查（完成前验证测试及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自动化令牌校验、注册表传播重试及草稿发布检测，旨在防止因配置错误导致的发布失败与系统中断。
配置或调试CI/CD发布流水线
排查npm包发布失败问题
制定发布安全规范
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill ci-validation-gates -g -y
定义Squad在多平台(CLI/VS Code等)下的代理启动适配策略，通过检测可用工具动态选择spawn方式，处理并行执行、模型选择及结果获取差异，确保跨环境行为一致。
需要跨平台(如CLI与VS Code)协调Agent启动逻辑
实现多表面环境下代理调用的自适应适配
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill client-compatibility -g -y
用于新仓库初始化团队配置的两阶段协议。第一阶段识别用户并提议角色阵容，需用户确认；第二阶段创建.squad脚手架文件及内置Agent。适用于从零开始建立协作环境的场景。
检测到仓库中不存在 .squad/team.md 文件
需要为新项目或从未配置过 squad 的仓库初始化团队结构
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill coordinator-init-mode -g -y
用于在路由确定执行者后，根据任务复杂度选择代理响应模式（直接、轻量、标准、全量），包含决策表、模板及升级规则，以平衡效率与服务质量。
需要为已分配的任务选择代理响应模式
判断任务复杂度并决定是否需要启动代理
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协调工作，实现任务的分配、执行与结果同步。
需要跨设备协同执行任务
在多台机器间分发工作负载
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill cross-machine-coordination -g -y
定义跨仓库AI团队间的通信协议，提供同步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与临时代理组，避免紧耦合。
用户提到 'squad' 并意图创建或委托给独立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提示词回归。
修改了协调器提示词文件
修改了代理章程或辅助脚本
需要验证模板变更对Squad会话行为的影响
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill e2e-template-testing -g -y
在启用经济模式时，将Layer 3模型选择切换为低成本替代方案，以优化会话或永久成本。支持短语、配置文件和CLI触发，但不覆盖用户明确意图配置。
用户要求节省成本或激活经济模式
检测到 .squad/config.json 中 economyMode 为 true
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检查社区
需要处理未回复的社区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账号认证管理
跨身份Git推送失败
混淆企业和个人凭证
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill gh-auth-isolation -g -y
定义Squad团队的Git分支工作流，包括dev-first模型、命名规范及多问题并行开发的git worktree使用指南。
需要遵循团队Git分支规范进行开发
需要在同一仓库中并行处理多个Issue
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 决策历史记录的维护，确保仅记录最终确认结果而非中间状态或已撤销的决定。通过防止过时信息污染下游代理的决策，保障历史文件作为唯一事实来源的准确性与可靠性。
需要更新决策历史记录时
发现历史文件中存在过时或不准确的条目时
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill history-hygiene -g -y
为社区对外回复提供语气规范，确保内容温暖、人性化且非机器人化。包含开场、共情、具体行动等13项写作模式及示例，适用于PAO在Issue和讨论中的外部沟通场景。
起草面向社区的Issue回复
撰写公开讨论区回应
生成用户支持或反馈回复
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill humanizer -g -y
用于团队初始化的流程，当团队文件不存在或为空时，先提议团队成员角色与名称，待用户确认后创建完整的团队结构目录及配置文件。
.squad/team.md 文件不存在
.squad/team.md 存在但 Members 部分无条目
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
该Skill用于为每个Agent启动自动选择最合适的LLM模型。通过5层优先级体系（持久配置、会话指令、章程偏好、任务类型及默认值）解析模型参数，确保在质量与成本间取得平衡，并支持用户设置持久化偏好。
Agent启动时
用户指定使用特定模型
需要为不同任务类型分配模型
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill model-selection -g -y
清理和压缩代理工作区上下文，包括压缩历史记录、修剪旧日志、归档过时决策及清理孤立文件。在上下文窗口紧张或会话过长时使用，以释放资源并优化状态。
历史文件超过15KB
工作区总大小超过1MB
启动大量代理前
长会话结束后
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill nap -g -y
解决多Agent通知泛滥问题，通过基于主题的路由将不同类型通知分发至指定渠道。支持配置映射、标签约定及适配器模式，实现解耦与精准投递，避免告警疲劳。
需要按类型路由Agent通知
防止单渠道通知过载导致重要信息被忽略
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill notification-routing -g -y
管理跨项目的全局个人AI智能体集合，支持自动发现、合并至会话及隔离写入权限。提供初始化、增删查等CLI命令，通过Ghost协议确保个人智能体仅建议不修改项目状态。
用户需要配置全局个人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
用于在 GitHub PR 描述中嵌入 Playwright 截图，辅助审查 UI 和文档变更。通过临时分支托管图片并更新 PR 描述。
PR 包含文档站点或 UI 组件的视觉变更
需要向审查者展示生成的视觉产物
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill pr-screenshots -g -y
优化GitHub Issue扫描效率，通过两遍扫描减少API调用。第一遍轻量列表过滤，第二遍按需详情获取，降低72%开销。
需要批量检查或处理GitHub Issues时
执行Ralph工单分诊流程时
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill ralph-two-pass-scan -g -y
