vs-fix 是一个自主的缺陷修复流水线技能,输入缺陷、输出修复好的分支。其流程为:分类输入 → 理解代码 → 提出假设 → 复现 → 修复 → 验证 → 审查 → 交接。它支持四类输入:缺陷描述(默认)、GitHub issue(URL 或 #123,用 gh issue view 获取)、错误栈跟踪(提取文件路径与行号作为线索)、失败测试(直接跳到复现阶段)。设置阶段会读取 CLAUDE.md 获取测试、构建、lint 命令,运行 git status/diff,校验护栏命令(如 [test command] 2>&1 | head -5),创建形如 {user-prefix}/fix-{bug-topic} 的分支,并按阶段加载 debug-mode、tdd、qa、octocode-research、roast-my-code 等技能。
复现阶段要求先写失败测试并单独提交(git commit -m "test: add failing test for <bug description>"),修复阶段写最小实现并通过测试,验证阶段跑全量测试、类型检查与构建,审查阶段可选加载 roast-my-code,最后以固定格式交接,包含分支、根因、证据、改动文件、流水线结果、决策日志与护栏结果。
它有四个熔断器:三轮调查后仍无法定位根因、三次尝试仍无法复现、修复引入的测试失败多于解决的、缺陷位于外部依赖或基础设施(本仓库无法修复);触发即停止并呈现发现。规则强调:未理解不得修复、不打补丁掩盖症状、证据优先于直觉、最小化影响范围、TDD 默认、原子提交、记录每个决策、不扩大范围。适用场景为希望自动化定位与修复本仓库内缺陷的开发工作流;限制是缺陷须能复现且位于当前仓库,跨版本兼容性、具体平台或环境支持资料暂未提供。