mcpField
R
repo-architecture

repo-architecture

github.com/garrytan生产力31.3k248 次安装今天更新
代码仓库

关于 repo-architecture

为整理知识库页面的 Agent 提供归档指导,按主要主题分类,并用决策流程处理模糊情况、识别常见错放问题。

主要功能

  1. 01按主题归档
  2. 02页面类型决策树
  3. 03交叉链接指导
  4. 04重要性检查
  5. 05识别常见错放

适用场景

  1. 01确定新页面的目录
  2. 02处理模糊的归档位置
  3. 03检查页面是否值得创建

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/garrytan/gbrain --skill repo-architecture

安装后在 Claude Code 中输入/repo-architecture确认已加载。

详细介绍

仓库架构 — 归档规则

完整归档规则: 参见 skills/_brain-filing-rules.md

约定

此技能保证:

  • 每个新页面都按主题归档(不按格式,不按来源)
  • 对于有歧义的情况遵循决策流程
  • 能够发现常见的错误归档模式

阶段

  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 中的显著性门槛。

输出格式

建议性提示:"将此页面归档到 {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