// 项目架构约定：通过 Root/Folder/File 三层极简元数据（_dir.md + I/O/Pos 注释） 让 AI 在任意位置自定位。 **AI 创建文件夹时自动触发**：hook 会生成 _dir.md 模板，AI 填写 Input/Output/Pos。
在编写、更新、维护 roadmap.md 的时候触发
多模型协作 — 调用 gemini-agent 和 codex-agent 辅助分析 **触发场景**（主动使用）： - 深度代码分析：算法理解、性能瓶颈、架构梳理 - 大范围探索：5+ 文件、模块依赖、调用链追踪 - 复杂推理：方案评估、逻辑验证、并发安全分析 - 多视角决策：需要不同角度分析再综合判断 **不触发**： - 简单修改（1-2 文件的明确改动） - 文件查找（用 Explore 或 Glob/Grep） - 已知路径的读写操作 **核心原则**：你是决策者和执行者，外部模型是顾问。
代码风格规范 / Code style conventions。在编写、编辑、评审 Python 代码时使用。包括类型注解、Decimal 精度、Docstring、模块组织等规范。Use when writing, editing, or reviewing Python code. Enforces type hints, Decimal precision, docstrings, and module organization.
分层架构规范 / Architecture and layering rules (v0.3.1)。在设计新组件、修改导入、检查分层时使用。核心约束：cli → flows → data，core 向内不向外。Use when designing components, changing imports, or reviewing layering decisions. Enforces cli/flows/core/data separation.
命名规范 / Naming conventions。在创建类、函数、变量，或重命名、检查命名时使用。核心原则：简洁优先，上下文消歧义，类型提示已提供足够信息。Use when naming classes/functions/variables, renaming code, or reviewing names. Prioritizes brevity over self-documentation.
用于梳理和可视化代码流程，生成清晰的 ASCII 流程图、数据流图和表格分析。适用于已有代码的梳理、新功能设计的说明、以及技术文档的编写。
| name | geb-protocol |
| description | 项目架构约定：通过 Root/Folder/File 三层极简元数据（_dir.md + I/O/Pos 注释） 让 AI 在任意位置自定位。 **AI 创建文件夹时自动触发**：hook 会生成 _dir.md 模板，AI 填写 Input/Output/Pos。 |
分形式项目导航。让 AI 在任意位置都能自定位。
Root → 项目是什么、模块有哪些（5行）
Folder → 这个文件夹负责什么（3-4行 _dir.md）
File → Input/Output/Pos（3行头部注释）
不是文档，是坐标系统。
# 项目名
一句话描述。
模块：A(职责) → B(职责) → C(职责)
分层：cli → flows → core → data
深度文档：docs/architecture.md
模块名称（一句话职责）
Input: 依赖什么
Output: 提供什么
Pos: 在分层中的位置
# Input: 依赖的类型/协议
# Output: 对外暴露的类/函数
# Pos: 层级定位（如 core/rules）
from decimal import Decimal
# ... 代码 ...
在工作流程中强制：
修改后检查：
- 更新文件头 I/O/Pos（依赖变了）
- 更新 _dir.md（模块职责变了）
- 更新 architecture.md（结构变了）
| 项目规模 | 建议 |
|---|---|
| < 10 文件 | 不需要 |
| 10-50 文件 | Root + 核心文件头部 |
| 50+ 文件 | 完整三层路标 |