kira

Kira

让你的 Agent 不再重复犯错。

每次重试失败、每个异常、每一句 “等等——上周我们不是刚碰到过这个问题吗”，都是会话结束时被 Agent 丢掉的知识。Kira 会把它们留下来。只需安装一个 MCP，你的 Agent 就能记录让它栽跟头的事（一道 伤疤），在再次工作前查看已有的伤疤，不再为同一个错误重复付出代价。

隐私保护始于设计。 个人伤疤和未命中查询日志仅保存在本地——任何套餐都不会上传。社区遥测为自愿启用，并且会在本地写入前以及服务器端存储前对密钥、路径和标识符进行脱敏。运行 npm run demo:privacy，即可确切查看哪些数据会离开你的设备。完整的传输格式和退出方式见 PRIVACY.md。

---

安装（10 秒）

将以下代码片段添加到你的 MCP 主机配置中：

{
  "mcpServers": {
    "kira": {
      "command": "npx",
      "args": ["-y", "kira-mcp@latest"]
    }
  }
}

就这么简单。你的 Agent 现在可以使用 Kira 了。

各客户端的配置路径（点击）

客户端	配置文件
Claude Code	~/.claude/settings.json（全局）或 .claude/settings.json（每个项目）
Claude Desktop	macOS：~/Library/Application Support/Claude/claude_desktop_config.json · Windows：%APPDATA%\Claude\claude_desktop_config.json
Cursor	~/.cursor/mcp.json（全局）或 .cursor/mcp.json（每个项目）
Cline / Continue	扩展设置 → MCP 服务
Windsurf	~/.codeium/windsurf/mcp_config.json
VS Code (MCP preview)	.vscode/mcp.json
Goose	~/.config/goose/profiles.yaml（位于 extensions: 下）
Zed	~/.config/zed/settings.json（context_servers）

上面的代码片段在所有这些客户端中都可以直接使用——只需将它粘贴到 mcpServers（或客户端对应的键）下。

---

30 秒了解工作循环

Monday    agent gates a merge on:  npm run build 2>&1 | tail -1
          exit code comes from tail, not the compiler → broken code reaches main
          └─ kira_record_failure(
               title:   "build gate bypassed: exit code swallowed by pipe to tail",
               instead: "never gate on a piped command without pipefail")

Tuesday   new session, same machine
          └─ session brief: "⚠ You have been burned by this before:
             never gate on a piped command without set -o pipefail"
          agent writes the gate correctly. Zero repeats. Zero wasted tokens.

这不是假设——这是数据库中的第一道真实伤疤，由构建此功能的 Agent 记录，记录的是它在构建过程中犯下的错误。接下来的三道伤疤也在同一天产生。这个循环从第一天起就能运行，单个用户即可使用，无需任何网络效应。FLYWHEEL.md 记录了完整的改进循环。

---

工具（10）

	工具	功能
个人记忆	kira_record_failure	将一次重试／异常记录为个人伤痕（仅限本地）
	kira_personal_brief	在会话开始时概览你最近的伤痕——开始工作前，就知道自己曾在哪里栽过跟头
	kira_premortem	在开始之前，为目标生成失败热力图——“这类任务过去让你栽过跟头的地方”
目录	kira_lookup	关键词 → 已验证的说明 + 失败警告。未命中时，会返回经过评分的 near_skills / near_scars，而不是只给你一个耸肩
	kira_get	按 ID 获取完整的分步说明
	kira_route	目标 → 按顺序排列的计划，每一步配有一项技能
社区	kira_share_scar	将个人伤痕升级为社区投稿（经过净化；未经你点击，任何内容都不会上传）——获得贡献者身份
反馈	kira_report	报告成功／重试／失败 → 为质量循环提供数据
	kira_consent / kira_status	遥测同意设置 + 单次调用检查

**自动触发：**你无需调用 Kira——Kira 的 MCP 说明会告诉你的 Agent 何时调用。日语查询也受到优先支持（采用 CJK 二元组匹配）。

没有匹配结果时

查询未命中并非死胡同——它是需求数据。Kira 会返回评分最接近的匹配项，在本地记录未命中（包括几乎匹配的内容），每周的飞轮摘要会将重复的未命中转化为别名修复和新技能候选项。目录会逐渐了解人们的实际提问。

---

目录层（社区技能与伤痕）

38 项社区技能涵盖部署／数据库／身份验证／支付／UI／测试／CI／基础设施／移动端／CMS，还有 45 项社区伤痕——真实的失败模式，例如 “Vercel 部署成功，但应用崩溃：缺少环境变量” 或 “Auth.js v5 的 signIn 从错误的一侧导入”。kira_route 会将目标（“构建一个 Web 应用”）转化为按顺序排列的计划，并为每一步配上合适的技能和伤痕。

**社区伤痕是个人伤痕进阶的去处——整个流程已经上线。**让你的 Agent 运行 kira_share_scar(scar_id)：它会重新净化你的个人伤痕，将其泛化，并提供一个预填好的投稿链接（点击之前不会上传任何内容）。接收机器人会验证 JSON；人工会审核内容；合并后，内容会推送给所有 Kira 用户。更喜欢使用表单？直接提交伤痕。

每项被接受的伤痕都会带来贡献者身份——分享是免费获取最新内容流的方式（见下文“贡献”）。

---

工作原理

Your agent hits a wall            Your agent gets a task
    ↓                                 ↓
kira_record_failure()             kira_premortem(goal) / kira_lookup(keyword)
    ↓                                 ↓
~/.kira/personal-scars/           scars first, then instructions
    ↓                                 ↓
next session: brief surfaces      agent announces → executes → kira_report()
your scars before work starts         ↓
    ↓                             misses + failure notes feed the flywheel
never the same mistake twice      → digest → catalog improvements

技能是自然语言 Markdown——没有可执行代码，也没有注入风险。

---

为什么不直接用 CLAUDE.md？

	CLAUDE.md / .cursorrules	Kira
设置	每个项目都要复制	只需安装一次
失败记忆	如果你还记得，就手动写下来	kira_record_failure——在失败发生时记录
回忆	如果你还记得，就重新阅读	在会话开始／任务开始时自动呈现
选择	由你选择	Agent 评分并选择
更新	手动	自动（飞轮）
跨 AI 工具使用	特定于某种工具	任何 MCP 客户端

不是又一个“记忆 MCP”？

优秀的记忆服务并不少见（知识图谱、会话回忆、上下文交接）。Kira 有意聚焦于更窄的范围：

• 以失败为先，而非面面俱到。 通用记忆会存储发生过的事；Kira 存储的是绝不能重蹈的覆辙，并采用专为规避问题设计的结构：mistake → instead、严重程度和复发次数。只有因为数据记录的都是失败，才会有任务前热力图（kira_premortem）。
• 衡量复发，而非想当然。 再次记录类似失败时，会归并到同一条伤痕记录并增加 hit_count——语料库由此学会哪些墙真的有人撞，而审核会确保计数真实。
• 共享库会不断累积价值。 你的伤痕记录经过脱敏和人工审核后，会发送给每个安装实例——你也因此能获取最新内容源（RECIPROCITY.md）。记忆服务让一个 Agent 更聪明；伤痕语料库让每个 Agent 都能免于重蹈覆辙。
• 信任是精心设计的，而非不言自明的。 语料库文本会注入 Agent 的上下文，因此每条内容都必须通过 CI 中的净化稳定性检查、仅限自然语言的规则和人工审核（SECURITY.md）。

如果你需要通用的情节记忆，可以在 Kira 旁边运行其中一个服务——它们承担的任务并不相同。

---

遥测

个人伤痕记录（~/.kira/personal-scars/）和失误日志（~/.kira/misses.log）仅保存在本地，绝不会上传。社区遥测独立运行，并须获得同意：

模式（KIRA_TELEMETRY 环境变量，或 kira_consent MCP 工具）	哪些数据会离开你的设备
off	无。仅保留本地日志。
basic （默认）	匿名核心数据：技能 ID、状态、匿名 UUID、Kira 版本、操作系统系列、Node 主版本、免费/专业版级别。不含自由文本。
full	与 basic 相同，另含经过脱敏的 note / context（会删除机密信息、路径和标识符）。

完整架构、脱敏规则、保留期限和退出说明：PRIVACY.md。

环境变量	默认值	用途
KIRA_TELEMETRY	（未设置 → basic）	覆盖此进程的同意级别：off、basic、full。
KIRA_TELEMETRY_URL	https://kira-telemetry.workers.dev/v1/reports	批量上传的端点。
KIRA_HOME	~/.kira	同意状态、个人伤痕记录、失误日志和飞轮输出的存放位置。
KIRA_KEY	（未设置 → 免费版）	贡献者 / 支持者密钥——解锁最新社区内容源。
KIRA_REMOTE_URL	（未设置 → 不联网）	免费版的自愿订阅语料库内容源 URL（延迟 90 天的共享库）。

---

分享伤痕记录、订阅，或等待

语料库采用 MIT 许可证，其中的所有内容最终都会免费开放。新鲜度是唯一的高级权益——随着模型重新训练，失败经验会逐渐过时，因此最新的伤痕记录最有价值：

	最新社区内容源	方式
贡献者	✅ 免费	一条获接纳的伤痕记录 = 12 个月（kira_share_scar → 合并 → 获取密钥）。前 1,000 名贡献者：永久有效。
支持者	✅ 付费	赞助项目 → 获取支持者密钥。资金用于人工审核每份投稿。
免费用户	90 天后提供	基础语料库随 npm 一同发布；可自愿订阅延迟开放的共享库内容源。本地功能和隐私保障在所有级别永久免费。

目前处于宽限模式：在语料库达到 100 条社区伤痕记录之前，所有人都能访问最新内容源。完整政策：RECIPROCITY.md。

---

贡献

前 1,000 名贡献者可永久免费使用 Kira 的所有功能（包括最新内容源）——详见上方的互惠表格。

如何添加 Skills 和 Scars，请参阅 CONTRIBUTING.md。

---

链接

• npm
• 飞轮 — 改进循环的运行方式
• 设计理念
• 商业计划
• 使用指南
• 故障排除

---

Agent 因记住曾在哪里吃过亏，才能大显身手。

一个 B Button Corporation 项目。