如何把 agent-skills 接入 Windsurf.windsurfrules 与全局规则怎么选、放哪些技能【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skillsagent-skills 把资深工程师的工作流TDD、增量实现、代码评审等打包成一组SKILL.md供 AI 编码代理执行。Windsurf 没有原生插件安装方式项目文档给出的接入路径是把技能内容写进 Windsurf 的规则配置项目级用.windsurfrules文件跨项目用 Global Rules。本文基于 docs/windsurf-setup.md 完成这条接入并回答两个选择问题——规则放哪、放哪些技能。准备条件准备 agent-skills 本地副本Windsurf 的接入方式是把SKILL.md的内容拼进规则文件所以你需要先有一份本地副本以便用命令读取每个技能的文件git clone https://gitcode.com/GitHub_Trending/agentskill/agent-skills克隆完成后结构上有两处与本文相关见 README.mdskills/目录每个子目录是一个技能内含SKILL.md例如 skills/test-driven-development/SKILL.mdreferences/目录7 个补充清单如 references/security-checklist.md供技能按需引用。每个SKILL.md都遵循统一结构Overview、When to Use、Process、Verification 等章节其中 Verification 一节定义了技能完成的证据要求——这也是后文验证方式的基础结构定义见 docs/getting-started.md 的 Skill Anatomy 部分。.windsurfrules 还是 Global Rules按作用域选docs/windsurf-setup.md 对两种位置的定位很明确.windsurfrulesWindsurf 用它承载项目特定的代理指令文件放在你的项目根目录Global Rules面向希望在所有项目中都生效的技能入口是 Windsurf → Settings → AI → Global Rules。据此选择规则只有一条只在本项目生效的技能放.windsurfrules长期跨项目通用的技能才进 Global Rules。另外有一条硬性约束Windsurf 的上下文有限文档建议.windsurfrules聚焦在2-3 个核心技能stay within context limits选能补上你最大质量短板的技能而不是把所有技能都拼进去。[skills/context-engineering/SKILL.md](https://link.gitcode.com/i/41c1dbb57f1af94c4de7a39248a34760)也把.windsurfrules列为 Windsurf 对应的规则文件即项目级规则文件是这里的主路径。放哪些技能两个推荐组合与补充方式文档给出了两份推荐组合来源和侧重点不同按你的项目阶段二选一来源组合侧重docs/windsurf-setup.md 的示例命令test-driven-developmentincremental-implementationcode-review-and-quality构建与合并前的质量把关docs/getting-started.md 的 Minimal 推荐spec-driven-developmenttest-driven-developmentcode-review-and-quality从定义要做什么到证明它可用两份文档的共同点是都包含test-driven-development和code-review-and-quality差异在于前者用incremental-implementation改动横跨多文件时的薄垂直切片流程后者用spec-driven-development动手前先写 PRD。如果你的项目还没有成文的规范倾向后者如果规范已存在、主要问题是实现与合并质量倾向前者。当需要更多技能时不要继续往.windsurfrules里塞docs/windsurf-setup.md 给出的是会话内临时注入在具体阶段把对应技能内容粘贴进对话例如构建鉴权时粘贴security-and-hardening。docs/getting-started.md 也按阶段列了按需加载的建议如 UI 工作配frontend-ui-engineering、调试配debugging-and-error-recovery。浏览全部 25 个技能的 Use When 列可以在 README.md 的 All 24 Skills 表格中找到。生成 .windsurfrules项目规则文件在你的项目根目录执行下面的命令把选定的技能拼接成.windsurfrules。注意命令中的/path/to/agent-skills需要替换成你自己克隆的 agent-skills 仓库的本地路径docs/windsurf-setup.md 原文如此以下按示例组合演示# 在项目根目录执行/path/to/agent-skills 替换为你本地克隆的路径 cat /path/to/agent-skills/skills/test-driven-development/SKILL.md .windsurfrules echo \n---\n .windsurfrules cat /path/to/agent-skills/skills/incremental-implementation/SKILL.md .windsurfrules echo \n---\n .windsurfrules cat /path/to/agent-skills/skills/code-review-and-quality/SKILL.md .windsurfrules每条cat负责一个技能的完整内容echo \n---\n在技能之间插入分隔线。生成后的文件结构对应文档中的示例布局其中方括号行是占位说明实际文件里应是对应SKILL.md的完整内容# .windsurules 示例布局来自 docs/windsurf-setup.md方括号行需替换为真实技能内容 # Essential agent-skills for this project [Paste test-driven-development SKILL.md] --- [Paste incremental-implementation SKILL.md] --- [Paste code-review-and-quality SKILL.md]如果按 docs/getting-started.md 的 Minimal 组合只需把第一条cat换成skills/spec-driven-development/SKILL.md其余不变。全局规则Settings → AI → Global Rules可选分支对希望跨项目生效的技能走全局路径docs/windsurfrules 文档 原文步骤打开 Windsurf → Settings → AI → Global Rules把最常用的技能内容粘贴进去。这一步是可选分支只做单项目接入时仅完成上一节的.windsurfrules即可不必配置全局规则。验证接入效果会话内引用与清单核对文档没有给出独立的配置成功检查命令验证落在日常使用上以下均来自 docs/windsurf-setup.md 的 Usage Tips确认规则被遵守让 Windsurf 执行一个触发已装技能的改动例如修改一段逻辑按 test-driven-development 的流程它应先写出失败测试再修复——如果你看到的是直接改代码、跳过测试说明规则没生效或未进上下文每个技能的 Verification 一节定义了应提供的证据测试通过、构建输出等。会话内引用技能在具体阶段把额外技能内容粘贴进对话如构建鉴权时粘贴security-and-hardening观察代理是否按该技能的工作流执行。用参考清单逐项核对把 references/security-checklist.md 的内容粘贴进对话要求 Windsurf 逐项验证。这类清单覆盖 pre-commit 检查、鉴权、输入校验、响应头、CORS、OWASP Top 10见 README.md 的 Reference Checklists 表格。一个与清单相关的已知限制如果你不是从克隆仓库、而是用npx skills add ... --skill name单技能安装的只会复制skills/name/仓库级references/目录不会被带上技能本身可用但补充清单的路径失效README.md 注明该可移植性缺口跟踪在 issue #361。按本文的克隆 拼接方式接入则不受影响清单文件就在你本地副本的references/下。限制与边界上下文是硬约束.windsurfrules保持 2-3 个技能Windsurf 的上下文有限超出的技能改走会话内粘贴而不是继续堆进规则文件。文档只覆盖规则文件方式本仓库的斜杠命令/spec、/build等服务于 Claude Code、Gemini CLI、Antigravity CLI 等工具见 docs/getting-started.md 的 Using Commands 一节Windsurf 文档未提供命令映射Windsurf 侧只有规则内容 会话内引用这一条路径。技能内容会随仓库更新.windsurfrules是一次性拼接的快照agent-skills 仓库更新技能后需要重新执行拼接命令刷新规则文件。【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考