关于 repo-architecture
为整理知识库页面的 Agent 提供归档指导,按主要主题分类,并用决策流程处理模糊情况、识别常见错放问题。
主要功能
- 01按主题归档
- 02页面类型决策树
- 03交叉链接指导
- 04重要性检查
- 05识别常见错放
适用场景
- 01确定新页面的目录
- 02处理模糊的归档位置
- 03检查页面是否值得创建
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ garrytan/ gbrain --skill repo-architecture安装后在 Claude Code 中输入/repo-architecture确认已加载。
详细介绍
仓库架构 — 归档规则
完整归档规则: 参见
skills/_brain-filing-rules.md
约定
此技能保证:
- 每个新页面都按主题归档(不按格式,不按来源)
- 对于有歧义的情况遵循决策流程
- 能够发现常见的错误归档模式
阶段
- 确定主题。 如果要搜索这个页面,你会搜索什么?
- 遍历决策树:
- 关于某个人 →
people/{name-slug}.md - 关于某家公司 →
companies/{name-slug}.md - 可复用的概念/框架 →
concepts/{slug}.md - 原创想法 →
originals/{slug}.md - 会议 →
meetings/{slug}.md - 媒体内容 →
media/{type}/{slug}.md - 原始数据导入 →
sources/{slug}.md
- 关于某个人 →
- 交叉链接。 从相关目录建立链接。
- 检查显著性。 参见
skills/conventions/quality.md中的显著性门槛。
输出格式
建议性提示:"将此页面归档到 {type}/{slug}.md,因为其主题是 {reason}。"
失败时的处理
对于任何 gbrain 错误 code、退出码、[AGENT] 块或通知块,请遵循 Agent 操作员协议。此技能的具体规定:
list_pages/search找不到匹配的目录,或无法连接到知识库:回退到skills/_brain-filing-rules.md,并说明该归档位置来自规则,而非实时知识库。get_page对正在归档的页面返回page_not_found:在选择目录之前,先与用户确认 slug。
反模式
- 按格式归档("它是 PDF,所以放进 sources/")
- 按来源归档("它来自邮件,所以放进 sources/")
- 创建页面前不检查是否已存在
- 将
sources/用于原始数据转储以外的任何内容
评论
支持 Markdown