用途:对 KAIROS MCP 工具在本地开发环境(KAIROS-DEVELOPMENT,配置于 .cursor/mcp.json)进行结构化端到端验证,通过严格分阶段避免在预期之前读取实现源码。该技能不通过 npx skills add 分发(skills/ 下的技能才通过该方式分发)。
主要能力与阶段: 第一阶段(仅 MCP):只允许 call_mcp_tool、list_mcp_resources、fetch_mcp_resource 等 MCP 发现手段;适配器运行按 activate → forward(依 next_action 循环)→ reward,遵循 skills/kairos/SKILL.md 的零漂移规则。禁止对仓库使用 Read、Write、Grep、SemanticSearch、Glob,也禁止以检查或修改仓库文件为目的的 Shell。宿主把工具 schema 以 JSON 暴露在 MCP 缓存路径下时,仅可用于构造合法调用参数。 第二阶段(只读仓库 + 报告):第一阶段结束后开始。可只读使用 src/embed-docs/、tests、CONTRIBUTING.md 等;写入仅限 .local/(gitignored),报告放 .local/mcp-qa-reports/,文件名 mcp-qa-<short-description>-<YYYY-MM-DD>.md。报告沿用 kairos-bug-report 的六段式:Summary、Calls and responses(逐次原始 JSON 请求与响应,含重试)、Reasoning、Environment/context、Reproduction、保存前检查清单。有开发 HTTP API 基址时,GET <KAIROS_API_URL>/health 记录版本与依赖,不要臆造 URL。 第三阶段(回归测试,先红后绿):按 .agents/skills/kmcp-dev-build-test/SKILL.md,先 npm run dev:deploy,再 npm run dev:test -- tests/integration/<file>.test.ts;在未修复生产代码前确认测试失败。硬性要求:不要以临时 npx jest / 裸 jest 作为默认路径。 第四阶段(计划与修复):切换到 Plan 模式商定修复范围与风险,实施后 npm run dev:deploy、重跑聚焦测试,再 npm run dev:test;若为需完整发布流程的线上缺陷,另按 .agents/skills/kmcp-dev-bugfix-ship/SKILL.md。
环境说明:KAIROS 为 Live,视为权威;KAIROS-DEVELOPMENT 为本地开发服务器,用于验证本地代码改动,不作为适配器权威;KAIROS-HELM-INTEGRATION 为基于 helm/ 的 Kubernetes 实例。call_mcp_tool 的 server 参数常与宿主可见 id 不同,需从错误中的 Available servers 列表或宿主 MCP 面板解析,常见形式 project-0-kairos-mcp-KAIROS-DEVELOPMENT 不可移植。认证或服务器缺失见 .agents/skills/mcp-host-bridge/SKILL.md。运行时以已连接服务器为工具名、schema 与描述的权威;本分支应有行为以 src/embed-docs/tools/、源码与测试为准(第一阶段之后)。
限制:本技能面向本地开发环境;CI 中 npm run lint:skills 仅通过 scripts/lint-agent-skills.py 校验 skills/,本 .agents/skills/ 文件不在该 lint 路径内。公开可合并报告按 kairos-bug-report 放 reports/,本工作流 QA 产物仅留在 .local/。其他收费、平台与效果信息暂未提供。