roadmap-guide
在编写、更新、维护 roadmap.md 的时候触发
npxskills add majiayu000/claude-skill-registry--skill roadmap-guideLoading…
在编写、更新、维护 roadmap.md 的时候触发
npxskills add majiayu000/claude-skill-registry--skill roadmap-guideLoading…
核心原则: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 行或删除
- 无重复信息
- 优先使用列表/表格
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).