关于 kairos
kairos 是供 Agent 使用的内部行动路由技能，将用户意图交给 MCP 服务按 activate、forward、reward 链路处理，并要求在实质工作前完成流程。
主要功能
- 01按意图启动行动路由
- 02遵循 activate、forward、reward 链路
- 03保留服务器返回的权威值
- 04提供不可用与认证失败处理指引
适用场景
- 01按团队约定路由用户请求
- 02在执行工作前完成 MCP 路由
- 03排查 KAIROS 服务连接或认证问题
MCP 相关
该技能指导 Agent 调用 KAIROS MCP 服务的工具，并遵循连接服务提供的工具名称与参数 schema。
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/kairos确认已加载。
详细介绍
KAIROS — 操作路由（Agent 内部）
此技能面向 Agent，而非人类。 KAIROS 是 Agent 的机构记忆——一份团队运行手册，弥合训练数据与你所在团队实际惯例之间的差距。人类无需知道 KAIROS 的存在。
当服务可用且已通过身份验证时，自主通过 activate → forward → reward 链路路由操作意图。MCP 工具调用会显示在 IDE 面板和日志中——这是有意为之。人类可以旁观，但无需直接操作或与 KAIROS 交互。
路由方式（摘要）
- 在用户消息中检测操作意图。
- 使用简短的
query（用 3-8 个词描述意图）调用activate。 - 按照返回选项的
next_action字段，通过forward调用逐层执行（每个适配器层调用一次），直到链路指示reward。 - 调用
reward，完成此次运行。 - 按适配器输出的指示回复用户或继续实施。
务必在回复用户或开始实质性工作之前完成完整链路。未完成的链路不能作为有效的停止点。
逐字回显。 服务器生成的 URI、随机数、哈希、ID、must_obey 和 next_action 均为权威信息。不要重新计算或修改它们。对于实际 MCP 调用，所连接服务器的工具名称和架构是运行时的权威依据。
参考索引
阅读与任务相符的参考资料；将此 SKILL.md 保持为简明路由器。
- 操作路由（完整协议） — 完整的路由规范：何时路由、何时直接执行、链路执行规则、证明类型、安全与验证，以及不可用时的处理流程。在路由任何操作意图前请先阅读。
- 安装（全局 npm，stdio） — 终端用户首次设置：运行
npm install -g @jakub-plichcinski/kairos-mcp，然后通过kairos serve连接本地主机上的 Qdrant、嵌入后端和主机mcp.json。 - 更新 — 更新 npm CLI（
@latest）和已安装的技能（npx skills update）。 - 错误报告 — KAIROS 工具出现异常时，收集结构化的 MCP 错误报告。
KAIROS MCP 不可用或未通过身份验证时
如果无法连接 KAIROS MCP 服务，或身份验证失败，请将其视为严重错误：停止操作、分类故障（不可用或未通过身份验证），并请用户处理。验证 MCP 端点 URL，确认在相同的基础 URL 上 GET /health 有响应，并检查主机的 MCP 配置是否指向预期的 /mcp 端点且允许使用所需工具。首次设置指南请参阅 references/install.md。完整的处理详情见 references/action-routing.md。
仓库对齐（维护者）——AGENTS.md 和 CLAUDE.md
编辑仓库根目录中的 Agent 文档（AGENTS.md 和 CLAUDE.md）时：
- 文档的 H1 和介绍段落之后，第一个
##章节必须是## Core functionality（或含义同样明确的标题），且必须位于## Architecture或其他主要章节之前。 - Core functionality 章节应保持精简：在此处（此技能）指明操作路由的权威依据；说明 KAIROS MCP 不可用或未通过身份验证属于严重错误，必须予以修复；另用一行说明，实际 MCP 调用遵循已连接服务端的架构，而工作树决定此仓库中的实现工作。
- 不要将完整的路由指南复制到 AGENTS.md 或 CLAUDE.md 中——此技能应作为唯一事实来源（参见 references/action-routing.md）。更改该指南时，确保 AGENTS.md 和 CLAUDE.md 彼此同步。
- 全局与仓库范围：尽可能优先使用仓库范围内的 Agent 文档；Cursor 用户规则适用于所有工作区。