# 路线图：claude-howto 2026–2027

> 2026 年 4 月 – 2027 年 3 月 · 双层知识库 | 完整计划：`TASKS-20260401.md`

---

## 愿景

把 claude-howto 从一个静态教程仓库，转变为一个**活的、双受众知识系统**：

- **面向人类** - 通过场景化学习、渐进式难度、决策树和专家会收藏的命名模式，提供互动式学习体验
- **面向 AI 代理** - 提供结构化元数据索引，让代理在执行 Claude Code 任务前先查询这里，使这个仓库成为基础设施，而不只是内容

没有竞争者把 AI 代理视为主要受众。这就是我们的护城河。

---

## 7 大支柱

| # | 支柱 | 交付内容 |
|---|--------|-----------------|
| P1 | 趣味层 | 每个模块都有场景导语和 "Try It Now" 模块 |
| P2 | AI 代理索引 | 生成 `agent-manifest.json` + `AGENT-INDEX.md` + 查询技能 |
| P3a | 专家参考（模块内） | 每个模块的决策树 + 命名模式 |
| P3b | 专家参考（跨模块） | `RECIPES.md` - 组合型多功能工作流 |
| P4 | 新手上手 | `quickstart.sh` + `QUICKSTART.md` + 难度徽章 |
| P5 | 社区展示 | `COMMUNITY-PROJECTS.md` - 精选用户项目 |
| P6 | 内容质量 | 扩展最薄弱的模块；完善项目 `CLAUDE.md` |
| P7 | 活课程体系 | `WHATS-NEW.md` + 版本徽章 + 每周过期检查 CI action |

---

## 时间线总览

```
2026 年 4 月   5–6 月 2026   7–8 月 2026   2026 年 9 月   10–11 月 2026   2026 年 12 月–2027 年 3 月
     |               |               |              |               |                    |
   [M1]            [M2]            [M3]           [M4]           [M5]                 [M6]
基础设施         6/10 个模块      10/10 完成     代理层          版本审计          自我维持系统
+ hooks/checks   完成             完成          + recipes       完成
```

---

## 里程碑

### M1 - 基础设施上线 · 2026 年 4 月底

**交付内容：**
- `scripts/quickstart.sh` - 为新用户提供一条命令式安装（幂等）
- `QUICKSTART.md` - “前 15 分钟”可视化指南
- 所有 10 个模块都加入难度徽章和 "What you'll build" 预览
- 所有模块都加入 `WHATS-NEW.md` 和版本徽章
- `.github/workflows/staleness-check.yml` - 每周一检查，若模块 30 天以上未验证则创建 issue
- 根目录 `CLAUDE.md` - 作为最佳实践示例的项目配置
- `scripts/build-agent-index.py` - 读取 10 个模块并输出 `agent-manifest.json` + `AGENT-INDEX.md` 的生成器
- **06-hooks** - 完整深度处理：5 个完整 hook 脚本、决策树、Try It Now、模式
- **08-checkpoints** - 完整深度处理：311 行扩展到 800+ 行，3 个工作流模板、决策树、模式

**为什么从这里开始：** 基础设施能惠及后续所有阶段。hooks 和 checkpoints 是最薄弱的模块，也最容易流失新访客。

---

### M2 - 6/10 个模块完成 · 2026 年 6 月底

**交付内容（每个模块一次深度处理）：**
- **01-slash-commands** - 场景导语、决策树、Try It Now、命名模式
- **02-memory** - 场景导语、决策树、Try It Now、命名模式
- **03-skills** - 场景导语、决策树、Try It Now、命名模式
- **10-cli** - 场景导语、决策树、Try It Now、命名模式
- CI 步骤：在每次 push 时校验 `agent-manifest.json` 的 schema

每个模块的处理都要运行生成器，确认 manifest 输出有效。

---

### M3 - 10/10 个模块完成 · 2026 年 8 月底

**交付内容：**
- **04-subagents** - 完整深度处理（包括 "The Multi-Agent Review Pattern"）
- **05-mcp** - 完整深度处理
- **07-plugins** - 完整深度处理
- **09-advanced-features** - 完整深度处理

现在每个模块都具备：场景导语、2 个以上 Try It Now 模块、Mermaid 决策树、2 个以上命名模式。

---

### M4 - 代理层上线 · 2026 年 9 月底

**交付内容：**
- 最终版 `agent-manifest.json`，覆盖 100% 模块（由已完成内容生成）
- `AGENT-INDEX.md`，从 `README.md` 链接
- `skills/claude-howto-lookup/SKILL.md` - 轻量级 agent skill，通过 manifest 查询相关模块
- `RECIPES.md` - 5 个以上组合工作流（schema：name、modules-used、problem、solution、expected outcome）
- `COMMUNITY-PROJECTS.md` - 静态精选列表，采用 PR 提交格式

**为什么是 9 月：** 只有等 10 个模块全部内容完备后，代理索引才真正有意义。

---

### M5 - 版本审计完成 · 2026 年 11 月底

**交付内容：**
- 完整版本审计：所有 10 个模块都根据当前 CC 版本完成验证
- 更新所有模块的 `cc_version_verified` frontmatter 和版本徽章
- `RECIPES.md` 扩展到 8 个以上 recipes，基于社区模式总结
- GitHub 固定讨论串：“分享你的 Claude Code 工作流” - 收集 agent 使用信号

---

### M6 - 自我维持系统 · 2027 年 3 月底

**持续交付 / 持续运行：**
- `/docs-sync-claude-code` skill 在每次 CC 发布后运行 → 更新 `WHATS-NEW.md`
- Agent manifest CI 回归测试：强制 100% 模块覆盖
- `RECIPES.md` 增加到 10 个以上 recipes
- `COMMUNITY-PROJECTS.md` 自然增长
- 对 agent 使用信号进行评估 - 若验证有效，则推动 lookup skill 的推广（营销、asm registry）

---

## 交付摘要

| 交付物 | 类型 | 阶段 |
|-------------|------|-------|
| `scripts/quickstart.sh` | 脚本 | P1 |
| `QUICKSTART.md` | 文档 | P1 |
| 根目录 `CLAUDE.md` | 配置 | P1 |
| `WHATS-NEW.md` | 文档 | P1 |
| `.github/workflows/staleness-check.yml` | CI | P1 |
| `scripts/build-agent-index.py` | 脚本 | P1 |
| 10 个模块深度处理（场景 + Try It Now + 决策树 + 模式） | 内容 | P1–P3 |
| `agent-manifest.json`（生成） | 数据 | P4 |
| `AGENT-INDEX.md`（生成） | 文档 | P4 |
| `skills/claude-howto-lookup/SKILL.md` | Skill | P4 |
| `RECIPES.md`（5 → 8 → 10+ recipes） | 文档 | P4–P6 |
| `COMMUNITY-PROJECTS.md` | 文档 | P4 |

---

## 不在范围内的内容

这些内容延期到 `TODOS.md`，不要让它们跑进来：

- Skill marketplace 或可安装 registry
- 自定义网站或仪表盘
- 完成度追踪（cc-progress）
- 社区教程 CI 校验
- 自动生成的 CONTRIBUTORS.md
- 多语言翻译
- 测验 / 评估基础设施
- 社区项目投票
