Agent Skills
› microsoft/Generative-AI-for-beginners-dotnet
microsoft/Generative-AI-for-beginners-dotnet
GitHub定义多智能体协作规范，包括工作树感知、决策记录格式及跨代理沟通协议。旨在消除冗余上下文，统一团队行为模式，确保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间高效协同与清晰的责任划分。
需要与其他智能体协作时
记录影响他人的决策时
请求其他成员输入时
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill agent-collaboration -g -y
用于新项目初始化，分两阶段构建AI协作团队：先提议角色并等待用户确认，再创建.squad/脚手架文件、配置Git属性及内置智能体。
检测到仓库中不存在 .squad/team.md 文件
需要为全新或未配置的仓库设置AI协作环境
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill coordinator-init-mode -g -y
定义Agent响应模式选择策略，根据任务复杂度在Direct、Lightweight、Standard和Full四种模式间决策。提供决策表、示例提示词及升级规则，用于确定工作处理方式和代理调用层级。
路由完成后需选择响应模式
判断任务复杂度以决定代理调用级别
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill coordinator-response-mode -g -y
定义Squad多Agent协作的文件层级、所有权及读写权限规则，解决状态归属与写入冲突。
解析文件写入冲突
确认文件所有权
审查是否违反追加只读规则
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill coordinator-source-of-truth -g -y
定义跨仓库 Squad 间通信协议，涵盖同步 CLI、只读查询、Git 异步及 GitHub Issue 委托四种模式。指导 AI Agent 在独立运行时环境下的信息交换与任务委派。
需要向其他仓库的 Squad 发送查询或请求知识
需要将任务委派给其他仓库的 Squad
需要进行跨仓库依赖分析
PR 审查请求跨越仓库边界
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill cross-squad-communication -g -y
指导Agent在多个独立Squad实例间进行协调，包括发现、委派和消歧。明确区分产品级Squad与临时任务组，通过注册表定位对等方并调用配套通信协议，实现跨仓库协作而不产生紧耦合。
用户提及'spawn squads'或'delegate to a 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-first模型、分支命名规范及Issue处理流程。新增git worktree支持并行多Issue开发，实现隔离目录与高效协作。
需要创建功能分支或提交代码时
协调多个Agent并行处理不同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
规范 Agent 处理敏感信息的安全行为，禁止读取 .env 等配置文件及输出密钥、密码等机密数据至提交文件，提供安全替代方案并集成预提交扫描验证。
涉及环境变量或配置文件操作
生成包含 API Key、密码、连接字符串等敏感数据的日志或决策记录
执行 Git 提交前的安全检查
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill secret-handling -g -y
指导Agent通过查询SQLite会话库，查找并恢复因终端崩溃或网络中断而暂停的CLI会话。支持按时间、关键词、目录筛选，并获取上下文以继续工作。
恢复被中断的开发任务
查找历史会话记录
从断点继续工作
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill session-recovery -g -y
定义 Squad CLI 工具的核心开发规范，涵盖零依赖约束、内置测试、错误处理及跨平台文件操作模式，指导代码编写与重构。
修改 Squad CLI 源码
遵循项目编码规范
实现跨平台兼容功能
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill squad-conventions -g -y
说明Squad是自定义Copilot代理而非技能，指导通过task工具调用Squad协调器、使用squad-commands技能查看命令列表及初始化项目。
用户请求使用Squad或设置AI团队
查询Squad可用命令或帮助信息
在项目中初始化Squad环境
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill squad-help -g -y
解析Squad CLI版本戳记与升级机制，涵盖npm注册表探测、文件覆盖与保留策略及自升级流程。
查询Squad CLI版本更新逻辑
了解升级时哪些文件会被覆盖或保留
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill squad-version-check -g -y
Squad CLI 交互式命令目录与菜单技能，提供安装升级、团队管理、Issue/PR处理等功能的路由与参数引导。
用户输入 /squad 斜杠命令
询问 squad 可用功能或选项
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill squad -g -y
提出三层Agent记忆模型（热/冷/维基），通过分离当前会话、跨会话摘要和结构化知识，解决上下文无限增长问题，优化每次启动时的加载效率与相关性。
需要优化Agent上下文加载性能
设计Agent记忆管理架构
减少LLM调用成本
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
定义多平台（CLI/VS Code等）环境检测与自适应代理生成策略，通过识别可用工具动态调整调用方式、并行逻辑及参数配置，确保跨表面的一致性体验。
需要跨不同客户端平台运行Agent时
处理代理生成和结果收集的适配逻辑时
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill client-compatibility -g -y
用于在仓库首次初始化时构建协作团队。通过两阶段协议：先提议由用户确认的角色组合，再创建必要的脚手架文件与配置，完成环境搭建。
检测到仓库中不存在 .squad/team.md 文件
需要初始化新的 Squad 协作环境
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实现跨设备任务分配、执行与结果同步，支持Ralph自动调度。
需要协调不同机器上的Agent执行任务
跨设备共享工作负载或传递结果
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill cross-machine-coordination -g -y
定义跨仓库 Squad 间通信协议，支持同步 CLI、只读查询、Git 异步及 GitHub Issue 委派等模式，实现独立 AI 团队间的上下文共享与任务协作。
需要跨仓库查询知识或信息
将任务委派给其他 Squad
进行跨仓库依赖分析
处理跨仓库的 PR 评审请求
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill cross-squad-communication -g -y
指导Agent在多Squad实例间进行跨团队协作，包括发现、委派和歧义消除。明确区分独立Squad与临时子代理，提供跨仓库工作交接和上下文共享的标准模式，避免紧耦合。
用户提到spawn squad或delegate to squad
任务需要跨多个Squad实例协作
涉及多仓库边界的工作交接
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill cross-squad -g -y
配置跨机器/组织的分布式 Squad 协作拓扑，生成 mesh.json 并安装同步脚本，实现通过 Git 和 curl 拉取远程文件至本地，使 Agent 能读取异地上下文。
Squads 分布在多台机器或 VM 上
需要跨组织获取共享状态
Agent 需读取非本地文件系统上的文件
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill distributed-mesh -g -y
规范 Squad 文档写作风格与结构，遵循微软指南及团队约定，涵盖标题格式、语态、排版及测试同步规则，确保文档一致性与可发现性。
编写或修改技术文档
检查文档是否符合微软风格指南
添加新功能说明页面
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill docs-standards -g -y
对Squad协调器和智能体模板变更进行端到端验证，通过本地CLI运行真实会话检测LLM运行时回归。
修改了协调器提示词或智能体章程等模板文件
需要验证模板变更对实际会话行为的影响
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill e2e-template-testing -g -y
启用经济模式，将Layer 3模型自动切换至低成本替代方案以节省费用。支持会话短语、持久化配置及CLI触发，不覆盖用户显式意图，通过调整模型选择表实现成本优化。
用户请求使用经济模式或降低成本
检测到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
PAO社区沟通工作流，用于扫描GitHub议题与讨论，起草回复并生成供人工审核的表格。支持多种响应分类与模板选择，严格遵循人工审核机制，确保不自动发布。
用户手动触发 '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 安全处理 GitHub 多身份（企业 EMU 与个人账号）切换，避免凭证混淆。涵盖检测当前身份、提取特定用户 Token、使用 HTTPS 推送至个人仓库及创建 PR 等模式，确保跨上下文操作的安全隔离。
需要向非默认 GitHub 账户的仓库推送代码
需要以不同身份创建 Pull Request
检测到 GitHub CLI 认证身份与操作目标不匹配
需要在同一终端会话中隔离多个 GitHub 配置
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill gh-auth-isolation -g -y
定义Squad团队的Git分支工作流，包含dev-first模型、分支命名规范及Issue处理流程。支持使用git worktree并行处理多个Issue，确保多Agent协作时的隔离与高效。
需要遵循团队Git分支规范
在单仓库中并行处理多个Issue
初始化或切换至Squad开发环境
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
规范 Agent 决策历史记录，要求仅记录最终确认结果而非中间过程或撤销决定。防止因历史数据过时导致下游 Agent 做出错误判断，确保历史文件作为唯一事实来源的准确性。
需要记录项目决策、版本变更或关键状态时
更新 history.md 等持久化记忆文件时
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill history-hygiene -g -y
规范 PAO 对外社区回复的语调，确保温暖、人性化且非机器人风格。包含开启、排查、引导等场景的模式与示例，强调主动语态、同理心及具体信息，禁止粗俗语言和无意义链接。
起草面向外部社区的回复
处理 Issue 或讨论中的用户反馈
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill humanizer -g -y
初始化团队流程，检测缺失团队配置后，先通过算法生成角色提案并等待用户确认，随后创建团队目录结构、配置文件及成员注册表。
项目首次启动需建立团队
团队文件存在但成员列表为空
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模型。通过5层解析层级（配置、会话指令、章程、任务感知等）优先匹配，支持用户持久化偏好设置，确保每次代理启动时正确选择模型参数。
用户指定使用特定模型
智能体启动或任务分配时
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
实现基于主题的通知路由机制，通过标签将Agent消息分发至不同渠道，解决单通道信息过载问题。
需要区分通知类型并路由到特定渠道
解决多Agent场景下的通知淹没或疲劳问题
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill notification-routing -g -y
管理跨项目个人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 截图，辅助审查视觉变更。通过临时分支托管图片并更新 PR 描述，避免提交二进制文件。
PR 涉及文档站点或 UI 组件的视觉变更
需要展示生成的可视化产物（如 Storybook、图表）
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill pr-screenshots -g -y
通过两遍扫描优化 GitHub Issue 处理，第一遍轻量列表过滤，第二遍按需详情获取，减少 API 调用并提升效率。
需要高效批量处理 GitHub Issues
优化 Issue 筛选流程
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill ralph-two-pass-scan -g -y
