Knowledgebase Share
Use this skill as the single operating system for multi-agent knowledge storage.
Privacy rule (critical)
This is a reusable/public skill. Never hardcode user-specific repo URLs, paths, or secrets in SKILL.md.
Always read config from references/kb-config.json (or user-provided override) before executing.
Required config
Read references/kb-config.json first.
Fields:
- -
repo_url: canonical GitHub repo URL for knowledge storage - INLINECODE3 : local clone path
- INLINECODE4 : default branch (usually
main) - INLINECODE6 : private notes root folder (default
private) - INLINECODE8 : shared notes root folder (default
shared)
Repository model
CODEBLOCK0
Branch model
- -
main: stable shared knowledge - INLINECODE11 : per-agent working branch
- Shared knowledge enters
main only via PR
Operating rules
- 1. Pull/rebase before writing: INLINECODE13
- Keep private drafts in INLINECODE14
- Promote reusable content to
shared/ via PR - Never force-push INLINECODE16
- No secrets/tokens in repository content
- Resolve conflicts by preserving both versions first, then refactor
Standard flows
A) Agent daily write (private)
- 1. checkout INLINECODE17
- write to INLINECODE18
- commit + push branch
B) Promote to shared knowledge
- 1. copy/refine note into INLINECODE19
- commit on INLINECODE20
- open PR to INLINECODE21
- merge after review
C) Consume latest shared knowledge
- 1. checkout local branch
- INLINECODE22
- rebase from latest INLINECODE23
Minimal commands (template)
CODEBLOCK1
Boundary
- - This skill governs knowledge layer operations only.
- Constitution / hard governance rules are maintained in the independent constitution system.
知识库共享
将此技能作为多智能体知识存储的单一操作系统使用。
隐私规则(关键)
这是一个可复用/公开的技能。切勿在 SKILL.md 中硬编码特定用户的仓库 URL、路径或密钥。
执行前始终从 references/kb-config.json(或用户提供的覆盖配置)读取配置。
必需配置
首先读取 references/kb-config.json。
字段:
- - repourl:用于知识存储的规范 GitHub 仓库 URL
- localpath:本地克隆路径
- branch:默认分支(通常为 main)
- privateroot:私人笔记根文件夹(默认为 private)
- sharedroot:共享笔记根文件夹(默认为 shared)
仓库模型
text
/
private//
shared/
00_rules/
10_projects/
20_research/
30_decisions/
40_playbooks/
90_archive/
meta/
templates/
分支模型
- - main:稳定的共享知识
- agent/:每个智能体的工作分支
- 共享知识仅通过 PR 进入 main
操作规则
- 1. 写入前拉取/变基:git pull --rebase origin
- 将私人草稿保留在 private// 中
- 通过 PR 将可复用内容提升至 shared/
- 切勿强制推送 main
- 仓库内容中不包含密钥/令牌
- 解决冲突时先保留两个版本,然后重构
标准流程
A) 智能体日常写入(私人)
- 1. 检出 agent/
- 写入 //...
- 提交 + 推送分支
B) 提升为共享知识
- 1. 将笔记复制/整理至 /...
- 在 agent/ 上提交
- 向 main 发起 PR
- 审核后合并
C) 获取最新共享知识
- 1. 检出本地分支
- git fetch origin
- 从最新的 main 变基
最小命令(模板)
bash
首次克隆
git clone
url> path>
创建智能体分支
cd
git checkout -b agent/
同步分支
git pull --rebase origin agent/
推送更新
git push origin agent/
边界
- - 此技能仅管理知识层操作。
- 宪法/硬性治理规则由独立的宪法系统维护。