subagent-testing
在子智能体中用TDD测试技能
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:subagent-testing。 它的用途是:在子智能体中用TDD测试技能 完整的 Skill 内容见:https://321skill.com/skills/subagent-testing-x-7/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'使用subagent-testing技能,在全新的子智能体中用TDD测试我的新技能"analyze-token-cost"的功能是否正常。' 它会自动创建一个隔离的子智能体,运行你预先编写的测试用例(如输入Token消耗数据,断言输出成本计算正确),并输出测试通过/失败的结果及错误详情。
介绍
在开发AI技能时,如何确保新技能的行为符合预期、不破坏现有功能?subagent-testing 通过测试驱动开发(TDD)的方式,在隔离的全新子智能体环境中自动运行测试用例,帮你验证技能的正确性与稳定性。它解决了“技能开发后缺乏自动化验证、回归测试困难”的问题,尤其适合技能迭代频繁、需要快速反馈的场景。
使用方式非常简单:安装该技能后,在AI对话中直接调用,例如“使用subagent-testing技能测试我刚开发的‘分析Token消耗’技能是否正常”。它会自动创建隔离的子智能体,加载你的技能代码,执行预设的测试用例,并返回详细的测试报告(通过/失败、错误信息、耗时等)。你还可以在测试用例中模拟输入、断言输出,覆盖正常流程与边界情况。
该技能主要面向智能体开发者和测试工程师。智能体开发者可以在编写新技能后立即验证,避免手动测试的遗漏;测试工程师可以将它集成到CI/CD流程中,实现技能的自动化回归测试。对于需要频繁修改技能逻辑、快速迭代的团队,它能显著提升质量保障效率。
使用建议:编写测试用例时尽量覆盖核心功能和典型边界场景,避免过度依赖外部API或网络请求(子智能体环境可能受限);测试结果仅反映子智能体隔离环境下的行为,生产环境中的表现可能因上下文差异有所不同,建议结合手动测试。同时,注意管理测试用例的版本,与技能代码同步更新。
核心特点
与同类技能测试工具相比,subagent-testing 强制在“全新子智能体”中运行测试,确保测试环境完全隔离,不会因主智能体状态残留导致误判,且天然支持TDD循环(先写测试、再写技能)。
注意事项
不适合测试需要访问外部网络、数据库或复杂运行时依赖的技能,因为子智能体环境通常无法提供这些资源。
常见问题
如何编写测试用例?
测试用例通常以JSON或YAML格式定义,包括输入(input)和期望输出(expected)字段,技能会读取这些文件并逐条验证。具体格式请参考仓库中的示例测试文件。
支持哪些测试框架?
subagent-testing 内置了轻量级断言框架,支持等于、包含、正则匹配等常见断言,无需额外安装。你也可以通过配置自定义测试脚本。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/subagent-testing-x-7/raw/index.md 读取 subagent-testing 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/subagent-testing-x-7/raw/index.md(查看排版版本)