一个配置文件,把团队所有 AI 编程 Agent 的规则同步了——knowhub 体验
你们团队里用 Cursor 的、用 Windsurf 的、用 Claude Code 的,AGENTS.md 各写各的,规范完全对不上——这个问题有解了。
今天挖到一个超实用的 CLI 工具,叫 knowhub。名字直译就是「知识中枢」,功能也完全对得起这个名字:它把你的 AI 编程规则文件统一管理,然后一键同步到项目里所有 Agent 的对应位置。
举个工作里的真实场景你就懂了。
你有一套代码规范文档 `common-style.md`,想让它同时出现在这几个地方:
- `.cursor/rules/common-style.md`(Cursor 用户读它)
- `.github/copilot-instructions.md`(Copilot 用户读它)
- `.windsurfrules`(Windsurf 用户读它)
以前怎么做?手动复制黏贴,改一处得改三遍,偶尔漏了哪个,AI 就开始放飞自我。
用 knowhub,一个配置文件搞定:
# .knowhubrc.yaml
resources:
- plugin: "local"
pluginConfig:
path: './shared-rules/common-style.md'
symlink: true
overwrite: true
outputs:
- '.cursor/rules/common-style.md'
- '.github/copilot-instructions.md'
- '.windsurfrules'
然后一行命令:npx knowhub,全部搞定。支持本地文件、远程 URL(HTTP)、还支持 symlink 模式——改一处源文件,所有 Agent 自动读到最新版本。
remote URL 那条也超实用。你可以从内部 Wiki、GitHub raw 文件、甚至带 auth 的私有地址拉取规范文档,配置里直接写 headers,Token 什么的都能塞进去(用 JS/TS 配置文件)。
支持三种安装方式:
npm install --save-dev knowhub
# 或者
yarn add --dev knowhub
# 或者
bun add --dev knowhub
配置文件位置也考虑得很周到,按优先级搜 `.knowhubrc` → `.knowhubrc.json` → `.knowhubrc.yaml` → `package.json` 里的 `knowhub` 字段,不会跟现有项目打架。
说实话,这个工具解决的痛点特别实在。大厂里 AI Agent 普及之后,规则文件散落在各处、不同人维护不同 Agent 的规范,是越来越常见的麻烦了。knowhub 把这个手动同步的过程自动化了,而且做得足够轻量——没有服务端,不需要注册账号,就是个纯 CLI。
GitHub:https://github.com/yujiosaka/knowhub
评论区
登录后可评论。