
通过CLI、Git钩子和MCP,保持手动QA文档与源代码保持一致。
概览
让手动质量保证场景与你的代码保持一致。 是一个CLI和本地MCP服务器,将源文件与手动质量保证场景链接,采用版本化 test-truth.md 合同。当开发者或AI代理更改跟踪文件时,TestWeave会检查受影响模块的测试内容是否也发生变化。在编码时运行该文件,在Git推送前强制执行,或将其添加到拉取请求检查中。 例如,更改 src/auth/login.ts 应该会提示对登录场景的审查。如果该文件属于认证模块且其合同内容未变,TestWeave 报告为过时模块。更新相关操作和预期结果,然后将合同与代码一同提交。 - : 标记跟踪缺乏模块覆盖或随附合同更新的源代码变更。- : 当阻挡策略激活时,阻挡过时或未覆盖的推送。- : 自动在(.agents/skills)和(.claude/skills, .windsurf/skills等)中提供标准化的 SKILL.md 代理技能和IDE规则。
概述(AI 翻译)
让手动质量保证场景与你的代码保持一致。
概述
TestWeave 是一个 CLI 和本地 MCP 服务器,通过版本化 test-truth.md 合同将源文件与手动 QA 场景关联。当开发者或 AI 代理更改跟踪文件时,TestWeave 会检查受影响模块的测试内容是否也发生变化。在编码时运行,或在 Git 推送前强制执行,或将其添加到拉取请求检查中。
例如,更改 src/auth/login.ts 应会提示对登录场景进行复审。如果该文件属于 authentication 模块且其合同内容未变,TestWeave 报告 stale-module。更新相关动作和预期结果,然后将合同与代码一同提交。
- QA 漂移检测:标记追踪源代码变更,缺乏模块覆盖或合同更新。
- Git 预推执行:当阻挡策略活跃时,阻止过时或未覆盖的推送。
- 79+ AI 编码代理支持:自动在23个通用代理(
.agents/skills)和56个专用代理(.claude/skills、.windsurf/skills等)中提供标准化的SKILL.md代理技能和IDE规则)。
本页由 AI 翻译,技术细节请以原文为准。
README
以下为原文 README 节选,完整内容请查看原文。
Keep manual QA scenarios in step with your code.
Overview
TestWeave is a CLI and local MCP server that links source files to manual QA scenarios in a versioned test-truth.md contract. When a developer or AI agent changes a tracked file, TestWeave checks whether the affected module’s test content changed too. Run it while coding, enforce it before a Git push, or add it to pull request checks.
For example, changing src/auth/login.ts should prompt a review of login scenarios. If that file belongs to the authentication module and its contract content is unchanged, TestWeave reports stale-module. Update the relevant actions and expected results, then commit the contract alongside the code.
- QA Drift Detection: Flags tracked source changes that lack module coverage or accompanying contract updates.
- Git Pre-Push Enforcement: Blocks pushes with stale or uncovered changes when blocking policy is active.
- 79+ AI Coding Agent Support: Automatically provisions standardized
SKILL.mdagent skills and IDE rules across 23 Universal agents (.agents/skills) and 56 Dedicated agents (.claude/skills,.windsurf/skills, etc.). - Native Model Context Protocol (MCP): Local stdio MCP server enabling AI agents (Cursor, Claude, Copilot, Antigravity, etc.) to inspect contracts, detect drift, and upsert test cases safely.
- Enterprise QA Exports: One-command export to Jira, Xray, and Zephyr Scale (in both CSV and JSON formats).
- Universal Package Manager Support: Works seamlessly across npm, pnpm, Yarn Classic, modern Yarn (PnP), and Bun.
安装
npx --no-install testweave --cwd /absolute/path/to/project mcp配置
{
"mcpServers": {
"testweave": {
"command": "npx",
"args": ["--no-install", "testweave", "--cwd", "/absolute/path/to/project", "mcp"]
}
}
}