Back to skills
extension
Category: Development & EngineeringNo API key required

geb-protocol

Project architecture convention: By using a three-layer minimal metadata (Root/Folder/File) with (_dir.md + I/O/Pos annotations), it allows the AI to self-locate at any position. **Automatically triggered when AI creates a folder**: The hook generates a _dir.md template, and the AI fills in the Input/Output/Pos.

personAuthor: jakexiaohubgithub

GEB 路标协议

分形式项目导航。让 AI 在任意位置都能自定位。

核心结构

Root   → 项目是什么、模块有哪些(5行)
Folder → 这个文件夹负责什么(3-4行 _dir.md)
File   → Input/Output/Pos(3行头部注释)

不是文档,是坐标系统。


实施

Root(CLAUDE.md)

# 项目名

一句话描述。

模块:A(职责) → B(职责) → C(职责)
分层:cli → flows → core → data

深度文档:docs/architecture.md

Folder(_dir.md)

模块名称(一句话职责)
Input: 依赖什么
Output: 提供什么
Pos: 在分层中的位置

File(头部注释 - Python)

# Input: 依赖的类型/协议
# Output: 对外暴露的类/函数
# Pos: 层级定位(如 core/rules)

from decimal import Decimal
# ... 代码 ...

自愈机制

在工作流程中强制:

修改后检查:
- 更新文件头 I/O/Pos(依赖变了)
- 更新 _dir.md(模块职责变了)
- 更新 architecture.md(结构变了)

适用规模

| 项目规模 | 建议 | |---------|------| | < 10 文件 | 不需要 | | 10-50 文件 | Root + 核心文件头部 | | 50+ 文件 | 完整三层路标 |


详细示例

references/examples.md