> **核心原则**:roadmap 是导航图,不是教科书。信息密度 > 详细程度。
**必须应用**此规范的场景:
---
**删除这些内容:**
1. **示例代码**(除非必需理解问题)
```markdown
❌ 错误:
**实现方案:**
```python
# 20 行完整代码示例
async def chat_with_loop(self, query: str) -> str:
for i in range(15):
...
```
✅ 正确:
**实现方案:** `chat_with_loop()` 方法,最多 15 轮 ReAct 循环
```
2. **重复信息**(已在其他文档详述)
```markdown
❌ 错误:详细解释 T+1/T+2 确认规则
✅ 正确:确认规则见 `docs/settlement-rules.md`
```
3. **过长段落**
```markdown
❌ 错误:超过 3 行的描述段落
✅ 正确:每段 ≤ 3 行,优先使用列表/表格
```
---
每个版本条目遵循固定结构:
```markdown
一句话说明此版本解决什么问题。
```
**状态标记**:
---
版本间对比使用表格,清晰展示差异:
```markdown
| 维度 | v0.5.0 | v0.5.1 |
|------|--------|--------|
| 调用轮数 | 固定 1-2 轮 | 动态 N 轮 |
| 决策模式 | 一次性决定 | 边做边决策 |
```
---
使用统一格式记录:
```markdown
**限制名称**(记录日期):
```
---
架构/数据流优先使用 ASCII 图:
```markdown
导入阶段:
CSV → 算法 → BillFacts → AI 判断 → 回填 ActionLog
分析阶段:
用户提问 → AI → Tools → 分析 → 建议
```
---
**自动触发:** 当检测到以下操作时,自动应用此 skill
**提醒文案:**
```
正在编辑 roadmap.md
请遵循简洁性原则:
```
---
Leave a review
No reviews yet. Be the first to review this skill!
# Download SKILL.md from killerskills.ai/api/skills/roadmap-guide/raw