Testany Agent Skills

把需求、设计、评审、内容创作与测试中的工作方法，交给你的 AI Agent。

Testany 出品的开源工具集：四组按领域组织的 plugin / skills，以及管理本机 Codex 与 Claude 技能的 SkillDock 和组织本地 AI 团队的 TeamDesk 图形应用。每个插件独立安装，按你要做的事选择。

English · 选择插件 · SkillDock 界面与安装 · TeamDesk 安装 · 交流与反馈 · 了解 Testany

选择适合你的插件

研发、AI、营销与测试插件的命令和说明见下方技能目录。SkillDock 面向 macOS 上的 Codex 与 Claude，TeamDesk 面向 macOS 上的 Codex；其他插件的宿主能力与前置条件见各自 README。

在 Codex 中使用领域插件

可以让 Codex 从本仓库安装你选中的插件，以研发工具集为例：

请从 https://github.com/TestAny-io/testany-agent-skills 安装 testany-eng 插件，确认安装并启用成功。

安装后，在新任务中用 $guide 帮我判断这个项目下一步该做什么 开始。安装其他领域插件时，把请求中的插件名换成 testany-llm、testany-mrkt 或 testany-bot，然后按其 README 使用对应 skill。若 CLI 不可用，沿用下方 CLI 发现与回退说明，但安装目标仍是你选择的领域插件。

在 Claude Code 中使用

安装

在 Claude Code 对话中添加本仓库，然后安装你需要的一组插件。下面以研发工具集为例：

/plugin marketplace add TestAny-io/testany-agent-skills
/plugin install testany-eng@testany-agent-skills

把第二行中的 testany-eng 换成 testany-llm、testany-mrkt 或 testany-bot 即可分别安装。也可以打开 /plugin，在 Discover 中选择本 marketplace 的插件。添加 marketplace 只添加目录，不会自动安装所有插件。SkillDock 同样可以装在 Claude 中，见在 Claude 中使用 SkillDock；TeamDesk 仅支持 Codex。

使用

/testany-eng:guide 帮我扫一下这个项目下一步该做什么
/testany-eng:prd-writer 写一个用户登录功能的 PRD
/testany-eng:prd-reviewer ./docs/prd-login.md
/testany-eng:code-reviewer . main abc123 ./docs/LLD-login.md
/testany-llm:prompt-optimizer 帮我优化这个提示词...
/testany-mrkt:media-writer 写一篇关于 AI 的公众号文章

testany-bot 的平台操作需要先配置 Testany MCP 及访问权限。

更新

在终端中刷新 marketplace，再更新指定插件；以默认 user 安装范围的研发插件为例：

claude plugin marketplace update testany-agent-skills
claude plugin update testany-eng@testany-agent-skills

其他插件替换插件名即可；使用 project 或 local 安装范围时，为第二条命令添加对应的 --scope project 或 --scope local。回到已打开的 Claude Code 对话后运行 /reload-plugins，或新建会话加载更新。Claude Code 官方插件说明。

在 Codex 中使用 SkillDock

查看 SkillDock 产品页与界面，了解标签与重复技能筛选、同名技能管理、更新 diff 与自动更新。

安装 skilldock 只会添加一个 SkillDock 应用入口，不会安装 testany-eng 的研发 skills。 当前版本为 SkillDock 0.11.3：同一个本地实例同时管理 Codex 与 Claude 的技能、插件和 marketplace，两边都能打开（见在 Claude 中使用 SkillDock）；仍支持按真实名称查找 Miro 等 Codex 官方应用插件、预览安装，并分别核对安装与账号连接状态。自 0.2.0 起独立分发；旧版 testany-eng 2.4.0 所带的 SkillDock 0.1.0 用户请按下方迁移说明接续数据。

无需用户手动 clone。可以在 Codex 中提出：

请从 https://github.com/TestAny-io/testany-agent-skills 安装独立的 SkillDock 插件，并打开技能管理面板。

安装需要 Git 和支持 plugin 管理的 Codex CLI。打开时需要本机有 Node.js 22.12+：启动器先查找已有的（Codex 工作区自带的 Node、Homebrew、nvm 等）并保存所选路径，找不到时弹出安装引导；不会自动下载 Node，也不修改 shell 配置。首次启动需要联网安装依赖。

0.8.0 支持从 More / Explore 点击 SkillDock，再用 Pin to sidebar 固定；打开时自动启动后台，沿用已保存项目。原生入口已在桌面版 26.924.22138 验证；未显示入口时，新建 Codex 任务输入 $skill-manager 打开技能管理面板，使用右侧浏览器。确认“当前项目”后再开始管理。

从旧版 testany-eng 迁移

详见 SkillDock 使用说明。本次采用 Git 仓库分发，官方目录上架留待后续。

在 Claude 中使用 SkillDock

自 0.11.0 起，SkillDock 也可以装在 Claude Code 或 Claude 桌面应用中。两边打开的是同一个本地实例、同一份数据；只装在一边，也能在界面中看到并管理另一边。

在 Claude 桌面应用中安装（全程不用终端）：

1. 打开插件页：左侧栏 Customize → Plugins（在对话框输入 /plugin 也会打开这一页）。
2. 点右上的 + Add ▾ → Add marketplace，在 URL 中填 TestAny-io/testany-agent-skills，点 Sync。
3. 在 Discover 中找到 Skilldock（插件页按插件名显示），点 Add，装在用户范围。

装好后当前会话就能用：输入 /skilldock:skill-manager，或直接说“打开 SkillDock”。Claude 会把界面打开在内置浏览器面板中，没有浏览器工具时给出链接；Claude 中没有 Codex 那样的原生侧栏入口。

在 Claude Code 中也可以用命令添加并安装（已打开的会话中若没有出现，运行 /reload-plugins）：

/plugin marketplace add TestAny-io/testany-agent-skills
/plugin install skilldock@testany-agent-skills

• 要求：macOS、Git 和 Node.js 22.12+（查找与安装引导同上）。
• 管理状态：SkillDock 首次见到某个 Agent 时，装有 SkillDock 的一侧默认“已启用管理”，另一侧只读。只读的一侧只看不改；在“Agent 环境”页启用后，SkillDock 才会改动它，启用前会列出可能写入的位置。对 Claude 的改动都经 Claude 自己的命令行执行并读回。
• 更新：在 SkillDock 的“更新”页找到 Claude 中的 skilldock，点 检查更新，有更新时按预览确认。检查时 SkillDock 会先刷新本仓库的 marketplace，再经 Claude 自己的命令行更新并读回，全程不用终端；两边版本不同时，“Agent 环境”页也提供一键更新。自 0.11.1 起，SkillDock 在 Claude 一侧也声明版本号（与 Codex 一侧相同），Claude 命令行按它识别新版本。0.11.0 在 Claude 一侧以提交摘要作版本，测试中桌面应用插件页的 Update 没有识别出它之后的提交；声明版本后，0.11.0 到 0.11.1 这一次更新在一台机器上实测可用（2026-10-13）：刷新 marketplace 之后 Update 可以点击，点击后更新到 0.11.1。桌面应用刷新 marketplace 的入口是 + Add ▾ → Manage marketplaces → ⋮ → Check for updates。在 Claude Code 中也可以运行 /plugin，在 Marketplaces 中选中 testany-agent-skills 后选 Update marketplace，或在终端运行 claude plugin marketplace update testany-agent-skills 与 claude plugin update skilldock@testany-agent-skills。更新在新会话生效，已打开的会话运行 /reload-plugins。
• 两边都装了 SkillDock：0.11 首次打开旧数据时会确认两边都不低于 0.10.3，否则停下并说明处理办法（可经你确认一键更新），不改动任何数据。
• 回退：需要回到 0.10.x 时，请用独立的数据目录（设置 SKILLDOCK_STATE_DIR），或保留 0.11.x。0.10.3 遇到 0.11 的数据不会接管，并提示更新；0.10.2 及更早版本会拒绝启动或启动失败，不改动计划、绑定、历史与偏好（可能删除启动记录，0.11 下次打开时补写）。独立数据目录只对从技能或命令行启动的 SkillDock 生效，见 SKILL.md。

包含的 Skills

testany-eng（研发流程）

插件说明与工作流 · 24 个研发与协作 skills

testany-eng 默认跟随用户输入语言输出；用户显式指定语言时以用户指定为准；TRACEABILITY-METADATA 的字段名、枚举值与稳定 ID 保持英文。

正式新功能按完整流程推进；存量系统有限修复按问题层级进入 HLD/LLD/Code，不强制重做全链文档。四个相关 skill 共用 评审边界规则：技术合理性、设计授权与执行许可分离，技术理由不能自授权，旧 review comment 不能循环变成批准基线。P2 在 HLD/LLD/Code Review 中均不阻断。

code-reviewer 的机器证据默认完整落盘、仅返回有上限的摘要，并提供可复用的证据校验工具；调用方式及旧版全量 stdout 的 --full-json 选项见机器证据工具约定。

testany-eng 2.8.0 新增 ui-designer：从口述需求或 PRD 判读视觉方向、组件和交互，方向开放时把两个方向做成页面供选择，产出设计语言与高保真界面；有前端仓库时写进隔离沙箱，可直接交给 prototype-designer 补全流程与状态。两者共用 设计指南 与 前端仓库与原型沙箱 规则。使用新版需要更新完整插件。

testany-eng 2.7.1 修复 code-writer 与 Reviewer 的恢复读取：核心字段按总预算一次取全，超长字段返回固定来源的精确续读参数，已知任务直接从稳定入口恢复，减少目录探索和参数重试。配置与宿主边界见持久入口。使用新版需要更新完整插件；发布不表示本机已安装或在线线程已采用，真实工程 Token 节省仍须观察。

testany-eng 2.6.0 新增 delivery-secretary，持续跟踪多轮、多角色工作：维护目标拆解、共享依赖、原始承诺与剩余工作，在授权内主动补问状态；code-reviewer 提供可选协作接口，复用已有结论回答进度，不新增评审门禁。

testany-llm（AI/LLM 工具）

插件说明

testany-mrkt（营销内容）

插件说明

testany-bot（测试平台 - 通用版）

插件说明与连接要求 · Testany MCP

通用版，适用于 VS Code Copilot、GitHub Copilot、Claude Code 等 AI 平台。Skill 格式与 MCP workflow 跨平台复用；结构化问答与 slash command 会按宿主能力自动适配。需要配置 Testany MCP Server。

交流与反馈

中文和 English 都欢迎。不必写完整报告：告诉我们你想完成什么、卡在哪一步，就能开始交流。

• 使用疑问、安装求助 → Discussions · Q&A
• 功能建议、试用感受 → Discussions · Ideas
• 分享工作流与成果 → Discussions · Show and tell
• 可复现的故障 → 提交 Bug

试用 SkillDock 后，我们尤其想知道：是否顺利安装并打开、哪项管理功能最有用、哪一步最困惑。其他 plugin / skills 的体验同样欢迎。需要附哪些信息，见反馈指南。

认识 Testany

Testany 面向人类测试人员与 AI 测试 Agent，围绕测试编排、执行与结果反馈构建协作平台。这些开源工具来自我们自己的研发与使用场景。

如果你希望把测试工作接到平台上，可以继续了解 Testany 产品、使用文档 和 testany-bot；也可以通过 [email protected] 联系团队。

关于本仓库

Skills 是包含指令、脚本和资源的文件夹，Agent 可以按需加载它们来完成特定任务。本仓库任何内容合并到远程 main 就是发布；合并前必须完成受影响插件的版本递增、变更记录和验证，插件内文档或资源改动也不例外。具体规则见开发与发布约定。仅本地或功能分支编辑不自动触发合并、安装或缓存刷新。

创建自定义 Skill

本轮模型适配的已测范围、已知限制与本地测试入口见 GPT-6 适配验证摘要。源码合入不等于所有模型或宿主已通过验收，也不自动刷新已安装插件缓存。

Skill 的创建很简单 - 只需一个包含 SKILL.md 文件的文件夹。SKILL.md 包含 YAML frontmatter 和 Markdown 指令：

---
name: my-skill-name
description: 清晰描述这个 skill 做什么，以及什么时候应该使用它
---

# My Skill Name

[在这里添加 Agent 执行此 skill 时需要遵循的指令]

Frontmatter 必须包含两个基础字段（不表示只允许这两个字段）：

• name - skill 的唯一标识符（小写，用连字符分隔）
• description - 完整描述 skill 的功能和使用场景

可选字段及宿主扩展使用分层 frontmatter 检查：python3 plugins/testany-eng/scripts/validate_codex_compat.py --profile repository --format json。公共字段与 Claude 参数提示/Stop hook 分开验证和报告；严格公共字段检查使用 --profile portable。不要把通用 quick validator 的窄白名单当成所有宿主的 schema，也不要把静态通过当成已安装运行。

本仓库当前不再内置 skill-creator scaffolding/打包工具。新增或维护 skill 时，请直接创建或编辑对应 plugin 下的 SKILL.md 与配套 references/、assets/、scripts/，并同步更新 README、marketplace.json、plugin plugin.json 和 CHANGELOG.md。

了解 Skills：Agent Skills 规范 · 在 Claude 中使用 Skills · 创建自定义 Skills。

许可证

本仓库默认采用 MIT License。例外：plugins/skilldock/ 下的 SkillDock 自有软件、启动器、测试和文档采用 GNU AGPL v3，仅第 3 版（AGPL-3.0-only）；第三方依赖保留各自的许可证和版权声明，详见 SkillDock 许可与第三方声明。其他现有 skills 的 MIT 许可不变，已按 MIT 合法取得的历史版本授权不追溯撤销。

联系方式

• 社区：GitHub Discussions
• Email：[email protected]
• Website：testany.io