SuperAPI AI 工具集

kmcp-dev-bugfix-ship

编程与开发

查看项目

更新于 10-15 22:40

技能介绍

用途:把 kairos-mcp 的缺陷从报告推进到可合并状态,覆盖复现、测试、修复、验证、PR 与 CI 监控。仓库为 kairos-mcp,代理契约见 AGENTS.md,构建/测试契约见 kmcp-dev-build-test,技能索引见 .agents/skills/README.md。

输入:reports/ 下的缺陷报告(如 reports/mcp-bug-<slug>.md)或粘贴内容;若没有,先用 skills/.system/kairos-bug-report/SKILL.md 或宿主等价物生成报告。

环境:KAIROS 为线上权威环境,使用时按 skills/kairos/SKILL.md 以用户身份运行工作流;KAIROS-DEVELOPMENT 为开发/QA 实例,用于验证本地改动和复现缺陷。

流程(顺序重要,可循环):1) 在 KAIROS-DEVELOPMENT 确认:读报告中的工具、参数、预期与实际、步骤,调用前先从宿主 MCP 描述读取工具 schema;能复现则继续,不能则停止,不为未确认症状改代码。2) 写失败测试:在 tests/(通常 tests/integration/)新增或扩展测试,使其在当前行为下失败并最小化编码缺陷,按 kmcp-dev-build-test 运行最窄命令直到失败正确。3) 实现修复:针对根因做最小改动,不做顺手重构。4) 本地验证:npm run dev:deploy && npm run dev:test;范围需要时用 npm run handoff 或更广门禁(见 CONTRIBUTING.md)。5) 提交推送 PR:分支 fix/<topic> 或团队约定,提交信息清晰,推送并向 main 开 PR。6) 监控 CI:查看必需检查(gh pr checks <n> --watch、Actions UI)。7) CI 红则回到第 3 步,直到变绿或用户停止。8) 合并就绪总结:缺陷一行说明与 KAIROS-DEVELOPMENT 确认、新增测试路径与断言意图、修复文件/行为、运行过的命令、PR URL 与检查状态。

必须:MCP 相关缺陷在编码前做线上 MCP 复现;修复同时或之前加入回归自动化;日志与 PR 正文中脱敏密钥。禁止:未经过 dev:deploy 与自动化测试信号就宣称已修复;自行计算或猜测 KAIROS 的 proof_hash、nonce 或 run ID,应按 AGENTS.md / skills/kairos 回显服务器值。相关:kmcp-dev-mcp-qa-e2e 用于提交可合并报告前的严格分阶段 MCP QA;reports/mcp-bug-*.md 为公开缺陷报告命名。