# 路线图：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 - 多语言翻译 - 测验 / 评估基础设施 - 社区项目投票