返回资讯中心
外部精选
软件工程
#开发者实时流

Kibi 开源需求框架发布,让 AI 编程代理遵循代码意图

来源标题:Kibi – requirements framework for AI coding agents

开源项目 Kibi 发布,它是一个面向 AI 编程代理的需求框架,可把代码背后的意图、假设和取舍记录为仓库中的需求,并关联代码与测试,让后续代理遵循。它通过 kibi-core、kibi-cli、kibi-mcp 三个开发依赖接入,需 Node.js 22+,并内置 SWI-Prolog 运行时。

Hacker News 最新Looted2026/11/19 · 今天30 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

开源 · 在你的代码仓库中运行 Kibi 是面向 AI 编码 Agent 的需求框架。它把代码背后的推理过程(你在对话中达成的意图、假设和取舍)作为需求记录在仓库里,与代码和测试建立关联,并让之后每一个 Agent 都遵守这些需求。 在本仓库中安装 Kibi(https://github.com/Looted/kibi),然后引导初始化它的知识库。

  1. 安装:确认 Node.js 22+ 可用。使用本仓库已经在用的包管理器,把 kibi-core、kibi-cli 和 kibi-mcp 添加为 dev 依赖。不要跳过可选依赖;随附的 SWI-Prolog 运行时就是其中之一。
  2. 初始化:通过包管理器的本地运行器执行每一条 kibi 命令(npm:npm exec -- kibi <command>)。运行 kibi init;如果它报告有问题,运行 kibi doctor 并修复它指出的问题。如果当前平台没有随附的 SWI-Prolog,告诉我需要安装什么,然后停止。
  3. 连接:按照 https://looted.github.io/kibi/guide/connect-an-agent.html 的说明,为你所在的 Agent 宿主注册项目本地的 kibi-mcp 服务器。优先使用项目级配置,在安装插件或更改全局设置之前先问我。在你能够看到 kb_* 工具之前,改用 Kibi 的 CLI JSON 路由。
  4. 引导:运行 kibi skills load kibi-bootstrap --format markdown 并严格遵循该技能。它会先问我产品意图在代码之外存在于哪里(issue 跟踪器、wiki、规格文档),以及哪些来源可信;通过你拥有的连接器读取这些来源,并注明出处。向我展示完整计划及其哈希值,在我批准之前不要写入任何内容。
  5. 验证:运行 kibi check 和 kibi status,修复它们报告的任何问题,并总结新增了什么。不要提交;我会审查这些更改。 每一行都是一条通往闸门的需求。只有新鲜的端到端证据才能让它通过。 在源码中,每一行看起来都同样刻意为之。一场来之不易的取舍、一条业务规则、一个临时假设、一个捷径和一处被遗忘的遗留代码,读起来全都一样。区别存在于它们被决定的那场对话里,而那场对话已经消失了。于是下一个 Agent 要么“清理掉”一个决策,要么小心翼翼地保留一个意外。 export const TRIAL_DAYS = 14; firm:更改前询问REQ-trial-length一项取舍:更短的试用期转化率更高,我们接受更高的流失率。 export function canCheckout(cart) { return cart.total > 0; firm:更改前询问REQ-checkout-total-positive一条业务规则:绝不对空购物车收费。 export const MAX_SEATS = 50; exploratoryREQ-seat-cap一个假设:在企业版定价出现之前成立。当此区域被触碰时重新审视。 export function chargeWithRetry(order) { return retry(() => charge(order), { attempts: 5 }); defaultREQ-payment-retry一个捷径:支付服务商会丢弃 webhook。后续 Agent 可以凭证据重做它。 export function legacyDiscount(user) { return user.createdAt < CUTOFF ? 0.1 : 0; 无需求归属无人记录原因。Kibi 要求 Agent 在更改之前写下它的作用。 五段代码。没有原因,其中任何一段都可能是决策,也可能是错误。有了 Kibi,原因被写下来,与代码关联,并在 Agent 编辑这些行之前展示给它。 对话里说“我们要做 X 来留住用户”。代码只说了 X,下一个 Agent 无法区分取舍和错误。 每条需求都以提出者的原话记录其存在的原因,决策则保留其取舍。当你陈述一条规则时,Agent 通过一次 kb_record 调用记录它,附上你的原因、你的原话和实现它的代码,并立即得知某次提交能否通过。它们存放在每个分支上代码旁的 .kb/ 中,Kibi 会标记出没有说明原因的需求。 Agent 重写了一条它从不知道存在的规则。 在编辑文件之前,Agent 会看到该代码实现的需求、它必须保持为真的内容、它存在的原因,以及背后的决策。 相隔一周的两个提示词互相矛盾,却没有人注意到。 与现有规则矛盾的新规则会被拒绝,并同时点名两者,由你决定哪一个胜出。 CI 变绿并不能说明这个提交上还有哪些产品行为仍然有效。 健康报告显示哪些需求有新鲜的端到端证据,哪些仅凭某人的口头保证,哪些存在缺口。 笔记文件和记忆服务器帮助 Agent 回忆事情。Kibi 把意图及其原因变成与代码关联、检查矛盾、在编辑时呈现在 Agent 面前、并有证据支撑的规则。 简化自 Kibi 在每种情况下报告的内容。 Kibi 在每一个阶段都把意图附着在工作上,而对最后一个阶段它很保守。 用平实的语言提示行为,就像你一直在做的那样。那句话就是源头。 需求、场景和类型化事实落在代码旁的 .kb/ 中,并注明它们来自哪个工单或页面。 钩子在 Agent 编辑实现某需求的代码之前点名该需求。检查会标记矛盾和未被追溯的代码。 声称满足某需求的测试会记录与该测试运行时所基于的确切代码快照绑定的证据。 过期的凭证和通过的单元测试不能通过闸门。“已证实”只保留给检查器针对所有用例都已确立的主张。 三件事,没有一件是填写需求表单。 像你一直在做的那样提示。“草稿编辑必须在有人离开页面时保存。”你不用填写需求表单。 Agent 在写入项目知识之前会先提出一个计划。你批准它,或者纠正产品判断。根据你的提示词编译出的计划要么完整落地,要么完全不落地,而记录工作由 Agent 负责。

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →