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 文件
需要初始化全新的 Squad 团队环境
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill coordinator-init-mode -g -y
用于在路由确定执行者后，根据任务复杂度选择响应模式（Direct/Lightweight/Standard/Full），提供决策表、示例及升级规则，确保匹配合适的协作层级。
已确定处理Agent需选择响应模式
根据任务复杂度决定协作级别
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
定义跨仓库 Squad AI 团队间的通信协议，涵盖同步查询、异步任务委派及依赖分析，支持 CLI、Git 文件及 GitHub Issue 四种交互模式。
需要跨仓库获取知识或信息
需将任务委派给其他 Squad
进行跨仓库依赖分析
PR 审查跨越仓库边界
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill cross-squad-communication -g -y
用于跨Squad实例协调工作，处理发现、委托及消歧义。当用户指代独立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-first模型、分支命名规范及多任务并行处理的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
规范智能体处理敏感信息，禁止读取.env文件及在提交文件中输出密钥、密码等敏感数据，提供安全替代方案与预提交扫描验证机制。
涉及环境变量或配置文件的读取操作
生成包含API密钥、密码等敏感信息的日志或决策记录
执行代码提交前的安全检查
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill secret-handling -g -y
通过查询 SQLite session_store 数据库，查找并恢复因中断而暂停的 Copilot CLI 会话。支持按时间、关键词或工作目录过滤，获取上下文以继续未完成的工作。
终端崩溃或网络断开后恢复工作
需要查找特定时间段内的中断会话
根据关键词搜索相关会话历史
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill session-recovery -g -y
定义Squad CLI工具的核心开发规范，涵盖零依赖约束、内置测试框架使用、错误处理模式及跨平台文件操作标准。
询问Squad项目编码规范
需要遵循Squad代码风格进行开发
了解Squad项目的测试和错误处理约定
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill squad-conventions -g -y
说明 Squad 是自定义 Copilot 代理而非技能，指导用户通过 task 工具调用、查看命令或初始化项目，避免错误调用方式。
用户提及使用 Squad 或设置团队
查询 Squad 可用命令或功能
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill squad-help -g -y
解析 Squad CLI 版本机制，涵盖版本写入、升级时的文件保留与覆盖逻辑，以及通过 npm registry 查询最新版本的方法。
需要检查或更新 Squad CLI 版本
询问 squad upgrade 的具体行为或文件影响
查询 npm 上的最新包版本
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill squad-version-check -g -y
提供Squad CLI的交互式菜单与命令路由，支持安装升级、团队管理、PR处理等功能。通过自然语言或斜杠命令触发，引导用户完成配置与操作。
用户输入/squad命令
询问squad可用功能或帮助
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill squad -g -y
提出三层代理记忆模型（热/冷/维基）以优化上下文加载，减少每次启动时的数据负载。旨在通过分层策略实现按需读取，提升Agent性能并解决历史上下文无限增长问题。
设计Agent记忆架构
优化LLM上下文管理
减少Agent启动开销
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
定义所有智能体必须遵守的硬性规则，包括产品隔离（禁止硬编码特定团队名称）和同行质量检查（提交前验证测试），确保代码通用性与稳定性。
编写或修改产品代码及测试用例时
执行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协调器。通过两阶段协议：先提议由用户确认的8-9人虚拟团队阵容，确认后自动创建.squad目录、角色配置及.gitattributes等脚手架文件。
检测到仓库根目录下不存在 .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
定义Squad协调器的权威文件层级与状态归属规则，明确各文件的读写权限、冲突解决及派生/追加约束，用于解析状态归属和审批写入操作。
需要确定文件状态归属
检查写入权限或追加规则
解决文件冲突
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill coordinator-source-of-truth -g -y
实现跨机器智能体通过Git任务队列协调工作，支持分配、执行和结果回传，确保多设备间安全协作。
需要跨不同机器（如笔记本、DevBox）分配和执行任务
智能体间需要通过Git进行异步工作共享与状态同步
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill cross-machine-coordination -g -y
定义跨仓库 Squad AI 团队间的通信协议，支持同步 CLI、异步 Git 文件及 GitHub Issue 模式，用于知识查询、任务委派与依赖分析。
需要跨仓库获取信息或知识
将任务委派给其他独立 Squad
进行跨仓库依赖分析
PR 审查请求跨越仓库边界
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill cross-squad-communication -g -y
协调多个独立 Squad 实例间的工作，处理跨仓库的任务发现、委派与消歧。区分正式 Squad 产品与临时代理组，确保通过注册表发现对等体并使用标准协议通信，避免紧耦合。
用户提到 'squad' 并意图创建或委托给独立的 Squad 实例
任务需要跨多个 Squad 协作或涉及多仓库边界
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill cross-squad -g -y
配置跨机器/组织的分布式小队协作拓扑，生成mesh.json并安装同步脚本。通过git拉取远程状态使文件本地化，实现不同主机间的小队通信与上下文共享。
多机开发环境协调
跨组织团队协作
CI Runner间状态同步
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-templates/ 下的协调器提示词或智能体章程
新增或修改了条件块及初始化脚手架脚本
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill e2e-template-testing -g -y
在启用经济模式时，将Layer 3模型选择切换为低成本替代方案，支持会话短语、持久化配置和CLI触发，同时保留用户显式意图优先权。
用户请求降低成本或启用经济模式
检测到配置文件中的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
用于扫描社区未回复的议题和讨论，基于分类模板生成回复草稿，并强制经过人工审核后展示，全程记录审计日志。
需要回复社区用户提问或反馈时
定期清理积压的未响应社区议题
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
指导 Agent 在混合使用企业和个人 GitHub 账号时，安全检测身份、提取 Token 及隔离配置，避免凭证混淆导致操作失败。
Agent 需向个人 GitHub 仓库推送代码
Agent 需在个人 Fork 上创建 Pull Request
Agent 需要切换或验证当前 GitHub 认证身份
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill gh-auth-isolation -g -y
定义Squad分支模型与Git工作流，规范从dev分支开发、PR提交流程及Issue标记。支持多任务并行时通过git worktree隔离环境，确保代码集成与发布流程标准化。
需要创建功能分支或提交PR
需要并行处理多个Issue
询问团队Git分支规范
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill git-workflow -g -y
自动检测GitHub多账号并配置别名，实现个人与工作账号的无缝切换，提升多账户管理效率。
用户拥有多个GitHub账号
需要区分个人与工作账号操作
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill github-multi-account -g -y
规范历史记录的维护，要求仅记录最终确认的结果而非中间状态或已撤销的决定，确保未来智能体读取时获得唯一且准确的事实依据，避免决策污染。
需要更新项目历史记录文件时
决策发生变更或反转时
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
用于团队初始化的流程，检测团队文件缺失时先提案角色构成，待用户确认后再创建目录结构和配置文件。
.squad/team.md不存在或无成员
用户确认团队组成
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill init-mode -g -y
定义多智能体协作的迭代检索模式，限制最多3个循环，强制提供任务背景与成功标准，并由协调者验证输出。用于规范子代理派生、执行及验收流程，防止上下文丢失和无限重试。
需要委派子任务给其他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
清理和压缩代理上下文，通过归档旧日志、修剪历史文件和清理孤立文件来释放上下文窗口预算。适用于会话过长或状态目录过大时，以优化系统性能。
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智能体配置
管理跨项目共享的AI助手
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill personal-squad -g -y
指导智能体在修复代码后回复PR审查评论，确保变更可追溯。涵盖读取评论、执行修复及生成回复消息，提升协作透明度。
根据PR审查反馈修复代码
处理Copilot审查建议
响应审查者要求的更改
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill pr-review-response -g -y
通过Playwright捕获视觉变更截图，利用临时分支托管图片并嵌入GitHub PR描述，辅助审查无需检出代码。
PR包含UI组件或文档站点变更
需要为PR添加可视化预览
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill pr-screenshots -g -y
通过两遍扫描优化 GitHub Issue 处理，首遍轻量列表过滤减少 API 调用，次遍按需获取详情，提升监控效率。
需要高效扫描 GitHub Issues
降低 GitHub API 请求次数
npx skills add microsoft/Generative-AI-for-beginners-dotnet --skill ralph-two-pass-scan -g -y
