核心用法
Knowledgebase Share 是一套面向多智能体系统的知识层操作系统，以单一 GitHub 仓库为后端，规范知识的生产、流转与归档全生命周期。核心操作涵盖三大标准流程：
1. 私有知识沉淀（Agent Daily Write）：智能体在专属分支 agent/<name> 上维护个人知识草稿，存放于 private/<agent>/ 目录，支持快速迭代无需审批
2. 知识资产化（Promote to Shared）：通过 PR 流程将成熟知识迁移至 shared/ 下的分类目录（规则/项目/研究/决策/手册/归档），经评审后合并至 main 分支
3. 知识消费（Consume Latest）：通过 rebase 机制同步最新共享知识，确保各智能体基于统一上下文工作
显著优点
- 工作流标准化：强制分支隔离+PR评审，避免知识污染主线，天然支持多智能体并行协作
- 隐私分级设计：私有/共享双轨存储，兼顾个人思考空间与组织知识沉淀
- 冲突解决策略：明确"先保留双版本再重构"原则，降低合并冲突的认知负担
- 模板化执行：提供最小命令集模板，降低 Git 操作门槛
潜在局限
- Git 能力门槛：要求使用者理解分支、rebase、冲突解决等概念，对非技术背景用户存在学习成本
- 延迟性问题：PR 评审流程可能拖慢知识流转速度，高频协作场景下可能成为瓶颈
- 单仓库风险：所有知识集中于单一仓库，存在容量上限与单点故障隐患
- 配置外置依赖：必须依赖
references/kb-config.json读取仓库地址，配置缺失将导致流程中断
适合人群
多智能体研发团队、AI 助手集群运维者、需要建立可审计知识资产的组织，以及追求"代码化知识管理"的技术驱动型团队。
常规风险
- 配置外泄：仓库 URL 若被硬编码可能暴露内部基础设施
- 分支污染：误操作 force-push 至
main将破坏共享知识基线 - 密钥泄露：虽明令禁止，但自动化写入场景下仍存在 secrets 误入提交的风险