Agent Skills: GEB 路标协议

|

UncategorizedID: mmorit00/fund-portfolio-bot/geb-protocol

Install this agent skill to your local

pnpm dlx add-skill https://github.com/MMorit00/fund-portfolio-bot/tree/HEAD/.claude/skills/geb-protocol

Skill Files

Browse the full folder contents for geb-protocol.

Download Skill

Loading file tree…

.claude/skills/geb-protocol/SKILL.md

Skill Metadata

Name
geb-protocol
Description
|

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