使用 hTest (htest.dev) 编写或修改测试时使用 - JS 优先或 HTML 优先。 Use when a project has htest.dev in devDependencies or uses `npx htest` to run tests.在将声明性测试编写为嵌套对象文字或 HTML 中的引用测试表时使用。
针对实时 LGTM 堆栈对 Grafana Lens 代理工具进行端到端集成测试。检测本地代码更改并对受影响的工具运行有针对性的测试。
持续测试驱动的开发循环——每次代码更改后，构建项目，启动服务器，并运行单元测试、集成测试和系统测试。适用于微配置文件服务器技能。当您希望在每次更改后进行全面验证时，请在开发期间使用。触发“连续测试”、“连续测试”、“测试循环”、“st-loop”，或请求在每次更改后运行所有测试。
运行 ArduPilot SITL 自动测试（集成/行为测试）。当用户要求运行自动测试、车辆测试或特定测试方法时使用。
在完成复古功能工作、实施和测试通过后、创建 PR 之前使用。关键词：场景测试、全新安装、复古文档更新。
检查并改进用 Kotlin 编写的 Kensa BDD 测试。每当用户共享 Kensa 测试文件、要求您查看或改进 Kensa 测试或提及 Kensa 项目中的 Give-When-Then 测试时，请使用此技能。 Kensa 测试使用 KensaTest 接口和给定()/whenever()/then() DSL、@RenderedValue、@ExpandableSentence、Fixtures，并生成带有序列图的 HTML 报告。
在大型重构或广泛的代码更改后执行单元测试对齐。当用户明确使用命令“--校准测试--”或要求在大量修改后对齐/修复测试时触发。运行相关的单元测试，分析失败的测试用例，更新测试和/或实现，并迭代直至稳定。
为此 WordPress 插件编写、扩展或调试 PHPUnit 应用程序测试。每当涉及测试时，请使用此技能 - 为新功能添加测试、测试挂钩或过滤器行为、使用工厂测试 WordPress 数据操作，或者当被要求“添加测试”、“编写测试”、“测试此功能”或“通过测试验证此行为”时。该技能与项目基于 wp-env 的设置有关，并取代任何通用的 PHPUnit 指南。 --- # 应用程序测试 测试专门在 `wp-env` 测试容器内运行。 bootstrap 和 PHPUnit 配置是预先连接的。不要修改 `tests/bootstrap.php` 或 `phpunit.xml.dist`。测试运行时该插件已加载 - 无需手动操作。如需完整参考，包括常见模式、插件依赖项和 CI 详细信息，请阅读“references/testing.mdx”。 ## 运行测试套件
使用 Playwright 生成并运行端到端测试。创建测试旅程、运行测试、捕获屏幕截图/视频/跟踪以及上传工件。
审查现有测试套件的覆盖范围差距、质量和严格性；识别薄弱或缺失的测试并指导修复以达到目标覆盖阈值。当被要求“审查单元测试”、“修复单元测试”、“检查测试覆盖率”、“审核测试”、“改进测试套件”或确保计划结束时或维护期间的覆盖率时使用。当用户要求从头开始为新的、未经测试的代码编写测试时，请勿使用。
在为后端代码（Express 路由、MongoDB 模型、节点服务）生成测试时使用 - 分析文件类型，从 package.json 检测测试框架，生成具有安装/拆卸和边缘案例覆盖的全面测试
向 AgentSync 的同步引擎添加对新 AI 编码工具的支持。在添加新工具、集成新的 AI 助手或要求支持新的 IDE/编辑器时使用。 --- # 添加新工具支持 向 AgentSync 添加新的 AI 编码工具，以便 `agentsyncsync` 向其分发指令。 ## 步骤 1. **研究现有工具配置** — 阅读 `.ai/src/tools/claude.yaml` 或 `.ai/src/tools/cursor.yaml` 以了解模式。 2. **创建工具 YAML** — 将 `.ai/src/tools/_TEMPLATE.yaml` 复制到 `.ai/src/tools/<tool>.yaml`。 3. **配置目标** — 定义每个内容类型的位置： - `agents` → 主指令文件 - `rules` → 规则目录或合并文件 - `skills` → 技能目录（如果支持） - `commands` → 命令目录（如果支持） - `subagents` → 代理目录（如果支持） - `settings` / `mcp` → 特定于工具的配置文件 4. **处理格式差异** — 检查工具是否需要： - `.mdc` 扩展名而不是 `.md`（光标） - Frontmatter 换行（光标规则为 `alwaysApply: true`） - 内联技能/规则合并到代理文件中 (`inline_into_agents: true`) - 规则目录中 AGENTS.md 内容的 `00-context.md` 模式 - 代理的 TOML 格式 (Codex) 5. **添加同步逻辑** - 如果工具需要自定义转换，请在“lib/sync.sh”中添加处理程序（查找“sync_tool”函数和现有的特定于工具的块）。 6. **添加到 `lib/templates/tools/`** — 创建默认的 YAML 配置。 7. **编写测试** — 在以下位置添加断言： - `tests/sync.bats` — 验证输出文件是否存在 - `tests/sync_options.bats` — 验证 `--only`/`--skip` 过滤 - `tests/check.bats` — 验证 `agentsync check` 检测到偏差 8. **在所有平台上进行测试** — 在本地运行 `bats tests/sync.bats`，验证 CI 通过。 ## 陷阱 - 每个工具都有其怪癖。阅读该工具的文档以了解其需要说明文件的位置。 - 某些工具共享输出路径（例如，Copilot 使用 `.github/`）。检查与现有工具的碰撞。 - 自定义 YAML 解析器不支持数组或多行 YAML 块 — 也保留
skill-sample/ ├─ SKILL.md ⭐ 必备：技能说明入口：用途 / 安装 / 用法 / 示例 / 依赖 ├─ manifest.sample.json ⭐ 推荐：机器可读元信息：用于索引 / 校验 / 自动填表 ├─ LICENSE.sample ⭐ 推荐：授权与使用范围：开源 / 限制 / 商用说明 ├─ scripts/ │ └─ example-run.py ✅ 可运行示例脚本：让用户导入后立刻验证“能用” ├─ assets/ │ ├─ example-formatting-guide.md 🧩 输出规范：统一排版 / 结构 / 风格 │ └─ example-template.tex 🧩 模板资源：报告/文档模板，快速生成标准产物 └─ references/ 🧩 参考资料库：方法论 / 结构指南 / 最佳实践 ├─ example-ref-structure.md 🧩 结构参考：章节框架 / 目录组织 ├─ example-ref-analysis.md 🧩 分析参考：常用套路 / 指标口径 └─ example-ref-visuals.md 🧩 视觉参考：图表规范 / 可视化建议
更多 Agent Skills 规范 详见Anthropic官方文档：https://agentskills.io/home
├─ ⭐ 必备：YAML Frontmatter（必须存在，放在文件最顶部） │ ├─ ⭐ name ：技能唯一名；须符合命名规则，并建议与目录名一致 │ └─ ⭐ description ：技能描述；建议包含触发关键词（便于检索/匹配） │ ├─ ✅ 可选：Frontmatter 扩展字段（规范允许，但非强制） │ ├─ ✅ license ：许可证标识（也可配合单独 LICENSE 文件） │ ├─ ✅ compatibility ：兼容性/运行环境要求（仅在确实有限制时写） │ ├─ ✅ metadata ：任意键值对（如 author/version/source_url 等） │ └─ 🧩 allowed-tools ：允许工具白名单（规范标注为 experimental） │ └─ ✅ 推荐：Markdown 正文（自由格式，但建议按“渐进式披露”组织） ├─ ✅ Overview / Purpose ：一句话说明目标 + 不做什么（边界） ├─ ✅ When to use ：触发条件/适用场景（让模型/用户知道何时调用） ├─ ✅ Step-by-step ：步骤化流程（最好 3–6 步，保证可复现） ├─ ✅ Inputs / Outputs ：输入格式、输出格式、产物位置（文件/文本/JSON等） ├─ ✅ Examples ：至少 1 个可复制示例（越“能跑”越好） ├─ 🧩 Files & References ：引用assets/、references/、scripts/（相对路径） ├─ 🧩 Edge cases ：边界情况/限制（大文件、速率限制、失败回退） ├─ 🧩 Troubleshooting ：常见错误与解决（依赖缺失、路径不对、权限问题） └─ 🧩 Safety notes ：涉及联网/写文件/执行命令时给出提醒（建议写）
在 GitHub 和各类社区里，技能文件分散、难检索、也难判断是否可靠。SkillWink 把开源技能集中整理成可搜索、可筛选、可直接下载使用的技能库，让你更快找到“正好能用”的那一个。并且支持在SkillWink上直接上传skills。
我们提供 AI 语义搜索 + 关键字检索，支持 版本更新与多维排序（下载/点赞/评论/更新），并为每个技能提供 SKILL.md 开放标准与来源信息。你还可以在详情页直接 评论讨论、交流用法与改进建议。
快速上手：
支持下载与导入 skills（.zip/.skill），本地放置后即可生效：
~/.claude/skills/（Claude Code）
~/.codex/skills/（Codex CLI）
~/.gemini/skills/（Gemini CLI）
同一份 SKILL.md 跨平台通用。
你需要了解的：技能是什么、怎么运行的、怎么找、怎么导入、怎么判断可信、怎么参与共建。
这里的“skills（技能）”是一种可复用的任务能力包，通常包含 SKILL.md 说明（用途、输入输出、使用方法）以及可选的脚本/模板/示例文件。
你可以把它理解为：给 AI 助手或工具链用的“插件说明书 + 资源包”，可被反复安装与分享。
技能系统采用“渐进式披露”策略，高效管理上下文信息，具体流程如下：
发现阶段：系统启动时，智能体仅加载各技能的名称与简要描述——信息精简，足以判断其适用场景，避免冗余加载。
激活阶段：当任务需求与某技能描述匹配时，智能体才将对应的完整 SKILL.md 说明文档动态载入上下文。
执行阶段：智能体严格遵循文档指引执行操作，并按需调用关联文件或运行内置代码模块。
核心优势：该设计使智能体始终保持轻量高效，同时具备“按需扩展上下文”的能力，既保障响应速度，又确保复杂任务拥有充分执行依据。
推荐 3 种方式组合使用：
注：以上导入方式文件大小控制在10M之内。
常见路径如下（不同系统略有差异，以你本机为准）：
同一份 SKILL.md 通常可以跨工具复用。你在 SkillWink 导入后，也可以查看“放置指引/安装说明”。
可以。很多技能本质是标准化说明 + 资源，只要目标工具支持读取该格式，就能共享使用。
比如：检索类技能 + 写作类技能 + 自动化脚本，形成“发现 → 处理 → 输出”的工作流。
一部分skills来源于公开的 GitHub 仓库。我们会筛掉低质量仓库（至少 2 星），并扫描基本质量指标，还有一部分是SkillWink平台的创作者独立上传的。作为使用者，在安装前应始终审查代码，对安全问题负责。
最常见原因是这几类：
我们会尽量避免。你可以用 排序 + 评论 让“好用的”更靠前：
