项目架构约定：通过 Root/Folder/File 三层极简元数据（_dir.md + I/O/Pos 注释） 让 AI 在任意位置自定位。 **AI 创建文件夹时自动触发**：hook 会生成 _dir.md 模板，AI 填写 Input/Output/Pos。
多模型协作 — 调用 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 | roadmap-guide |
| description | 在编写、更新、维护 roadmap.md 的时候触发 |
核心原则：roadmap 是导航图，不是教科书。信息密度 > 详细程度。
必须应用此规范的场景：
docs/roadmap.md 添加新版本/功能删除这些内容：
示例代码（除非必需理解问题）
❌ 错误：
**实现方案：**
```python
# 20 行完整代码示例
async def chat_with_loop(self, query: str) -> str:
for i in range(15):
...
✅ 正确：
实现方案： chat_with_loop() 方法，最多 15 轮 ReAct 循环
重复信息（已在其他文档详述）
❌ 错误：详细解释 T+1/T+2 确认规则
✅ 正确：确认规则见 `docs/settlement-rules.md`
过长段落
❌ 错误：超过 3 行的描述段落
✅ 正确：每段 ≤ 3 行，优先使用列表/表格
每个版本条目遵循固定结构：
## vX.Y.Z 版本标题（状态标记）
### 核心目标
一句话说明此版本解决什么问题。
### 实现范围
- [x] 已完成项
- [ ] 待完成项
### 不做
- ❌ 明确排除的功能（防止范围蔓延）
状态标记：
✅ 已完成🚧 进行中🔮 规划中版本间对比使用表格，清晰展示差异：
| 维度 | v0.5.0 | v0.5.1 |
|------|--------|--------|
| 调用轮数 | 固定 1-2 轮 | 动态 N 轮 |
| 决策模式 | 一次性决定 | 边做边决策 |
使用统一格式记录：
## 禁止事项
- ❌ AI 执行交易操作（只给建议）
- ❌ 修改数据库 Schema
## 已知限制
**限制名称**（记录日期）：
- 问题描述（1-2 行）
- 未来方案（可选）
架构/数据流优先使用 ASCII 图：
导入阶段：
CSV → 算法 → BillFacts → AI 判断 → 回填 ActionLog
分析阶段：
用户提问 → AI → Tools → 分析 → 建议
自动触发： 当检测到以下操作时，自动应用此 skill
roadmap.md提醒文案：
正在编辑 roadmap.md
请遵循简洁性原则：
- 每段 ≤ 3 行
- 代码示例 ≤ 5 行或删除
- 无重复信息
- 优先使用列表/表格