SuperAPI AI 工具集

repo-architecture

通用与其它

查看项目

更新于 10-15 18:08

技能介绍

用途

repo-architecture 是一个归档决策技能,用于确定 gbrain 知识库中新建文件应当放置的位置。它的核心原则是按页面的主要主题归档,而不是按格式或来源归档。该技能面向所有负责撰写 gbrain 页面的技能,作为统一的归档规则参考。

主要能力

该技能提供以下保证(契约):

  • 每个新页面都按主要主题归档(不是按格式,也不是按来源)
  • 对含糊情况遵循决策协议
  • 能捕捉常见的错误归档模式

使用方式

资料中给出的流程分为若干阶段:

  1. 识别主要主题。判断你会用什么关键词来搜索以找到这个页面。
  2. 走决策树:
    • 关于某个人 → people/{name-slug}.md
    • 关于某家公司 → companies/{name-slug}.md
    • 可复用的概念/框架 → concepts/{slug}.md
    • 原创想法 → originals/{slug}.md
    • 一次会议 → meetings/{slug}.md
    • 媒体内容 → media/{type}/{slug}.md
    • 原始数据导入 → sources/{slug}.md
  3. 交叉链接。从相关目录建立链接。
  4. 检查显著性。参见 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。