核心用法
knowledgebase-share 是一套面向多智能体（multi-agent）的知识管理操作系统，以Git仓库为单一可信源，实现知识的协作生产与版本控制。
核心工作流：
- 私有草稿：每个Agent拥有独立分支
agent/<name>，在private/<name>/目录下自由迭代 - 共享知识：可复用内容经PR评审后合并至
main分支，按功能域分类存储于shared/（规则/项目/研究/决策/手册/归档） - 冲突解决：强制采用"先保留双版本、后重构整合"策略，避免知识丢失
关键操作：首次克隆→创建分支→日常rebase同步→本地写入→推送→提PR晋升共享层
显著优点
1. 版本化知识资产：全量变更可追溯，支持回滚与审计
2. 协作边界清晰：分支隔离避免写入冲突，PR机制引入人工/自动评审
3. 渐进式知识沉淀：私有草稿→共享标准→归档的成熟生命周期
4. GitOps原生：利用现有Git基础设施，无额外依赖
潜在缺点/局限
- Git学习成本：要求Agent具备分支管理、rebase、冲突解决能力
- 同步延迟：非实时共享，需主动fetch/rebase获取最新知识
- 单点仓库风险：所有知识集中于单一GitHub仓库，存在平台依赖
- 无权限细粒度：仅通过目录约定区分公私，无文件级ACL
适合人群
- 部署多个协作Agent、需共享上下文记忆的团队
- 追求知识可审计、可回滚的合规敏感场景
- 已采用Git工作流、希望扩展至AI知识管理的组织
常规风险
- 强制推送误操作：规则明确禁止
git push --force到main，但分支保护需仓库端配置 - 密钥泄露：明文禁止存储secrets，但需配合pre-commit扫描
- 冲突处理不当：若未遵守"先保留后重构"原则，可能导致知识片段丢失
- 分支漂移：长期未rebase的Agent分支可能产生复杂合并冲突