用途
repo-architecture 是一个归档决策技能,用于确定 gbrain 知识库中新建文件应当放置的位置。它的核心原则是按页面的主要主题归档,而不是按格式或来源归档。该技能面向所有负责撰写 gbrain 页面的技能,作为统一的归档规则参考。
主要能力
该技能提供以下保证(契约):
- 每个新页面都按主要主题归档(不是按格式,也不是按来源)
- 对含糊情况遵循决策协议
- 能捕捉常见的错误归档模式
使用方式
资料中给出的流程分为若干阶段:
- 识别主要主题。判断你会用什么关键词来搜索以找到这个页面。
- 走决策树:
- 关于某个人 → 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 的 notability gate。
输出格式为建议式表述:"File this at {type}/{slug}.md because the primary subject is {reason}."
适用场景
适用于在 gbrain 中创建或归档任何新页面的场景,尤其是需要判断页面应归入人物、公司、概念、原创想法、会议、媒体还是原始数据目录时。也适用于处理归档位置存在歧义的情况,以及需要统一归档规范、减少错误归档的写作流程。
限制与失败处理
资料中说明,当该技能失败时应遵循 agent operator protocol 处理任何 gbrain 错误码、退出码、[AGENT] 块或 notice 块。针对本技能的具体情况:
- 如果 list_pages / search 找不到匹配目录,或 brain 不可达:回退到 skills/_brain-filing-rules.md,并说明该放置来自规则而非实时 brain。
- 如果 get_page 对所归档页面返回 page_not_found:在选择目录前先与用户确认 slug。
应避免的反模式包括:
- 按格式归档(例如"这是 PDF 所以放到 sources/")
- 按来源归档(例如"它来自邮件所以放到 sources/")
- 创建页面时不检查是否已存在同名页面
- 将 sources/ 用于除原始数据转储之外的任何用途
完整归档规则参见 skills/_brain-filing-rules.md。