古法编程

Claude HowTo项目的核心规划是将其从静态教程仓库转变为一个为人类和AI代理服务的“双层知识库”。这通过七大支柱实现，其中“AI Agent Index”是关键护城河，计划在2026年4月至2027年3月的六个里程碑中，完成基础设施搭建、所有模块升级、代理索引发布与系统自治，以系统性提升Claude Code的学习与自动化水平。

Claude HowTo 项目路线图与贡献指南：双层知识库愿景与模块升级计划

你是否已经掌握了 Claude HowTo 完全指南 中的基础模块，但想知道这个教程项目的未来会如何发展，以及你如何参与其中？本文将深入解读 Claude HowTo 教程指南的官方路线图，揭示其将仓库从“教程”升级为“活知识系统”的完整愿景、实施计划与贡献方式。

从静态仓库到双层知识库：项目的新愿景

当前的 Claude HowTo 已经是一个结构化的教程，覆盖了从斜杠命令到 CLI 的10大功能模块。然而，项目规划提出了一个更宏大的目标：将其转变为一个 “活的、双受众知识系统”。

这个系统服务两类受众：

  • 对人类：提供交互式、场景化、渐进难度的学习体验，包含决策树和可收藏的命名模式。
  • 对AI代理：提供结构化的元数据索引，使代理能在执行 Claude Code 任务前查询此仓库，从而将项目定位从“内容”升级为“基础设施”。

为什么这很重要？ 因为目前没有其他竞争对手将 AI 代理作为首要受众。构建面向代理的结构化索引（AI Agent Index）是项目的独特护城河。

驱动变革的七大支柱

为了实现上述愿景，路线图定义了七大核心支柱，每个支柱解决系统的一个关键层面：

支柱 核心目标 为用户带来的价值
P1: Fun Layer 为每个模块增加场景化开头和“Try It Now”动手区块。 学习不再枯燥，通过真实问题场景快速入门。
P2: AI Agent Index 生成 agent-manifest.json 和 AGENT-INDEX.md。 AI代理能自动发现并调用本仓库的最佳实践与模板，成为智能助手的“技能库”。
P3: Expert Reference 每个模块添加决策树和命名模式；跨模块创建 RECIPES.md。 高级用户能快速决策“该用哪个功能”，并找到组合多种功能的“配方”。
P4: Newcomer Onboarding 提供 quickstart.sh 和 QUICKSTART.md。 新用户能在15分钟内完成环境搭建并跑通第一个示例。
P5: Community Showcase 创建 COMMUNITY-PROJECTS.md 展示社区项目。 分享与发现他人的创意用法，激发灵感。
P6: Content Quality 补强最薄弱的模块，完善项目自身的 CLAUDE.md。 确保所有模块的学习质量一致，项目自身即是最佳实践范例。
P7: Living Curriculum 维护 WHATS-NEW.md，添加版本徽章，设置陈旧性检查CI。 确保教程内容与 Claude Code 最新版本同步，信息永不过时。

分阶段实施：六大里程碑时间线

路线图将工作分解为六个里程碑，分布在2026年4月至2027年3月之间，共计68项具体任务。

gantt
    title Claude HowTo 发展时间线 (2026.4 – 2027.3)
    dateFormat  YYYY-MM
    axisFormat  %Y-%m
    section 基础设施
        M1：基础设施上线 & 弱模块升级 :active, m1, 2026-04, 1M
    section 模块升级
        M2：完成6/10模块升级       : m2, after m1, 2M
        M3：完成全部10个模块升级    : m3, after m2, 2M
    section 代理层与社区
        M4：代理索引与社区页面上线   : m4, after m3, 1M
    section 审计与扩展
        M5：版本审计与配方扩展       : m5, after m4, 2M
    section 持续维护
        M6：系统自治               : m6, after m5, 4M
  • M1 (2026.4) — 基础设施上线：这是根基。目标是发布 quickstart.sh、WHATS-NEW.md、版本徽章、CLAUDE.md 项目配置、陈旧性检查CI脚本，以及AI代理索引的生成脚本。同时，优先升级钩子和检查点这两个最薄弱的模块。
  • M2 (2026.5-6) — 完成6/10模块：对斜杠命令、记忆、技能、CLI模块完成深度升级，加入场景、决策树和“Try It Now”。
  • M3 (2026.7-8) — 完成全部10个模块：完成子代理、MCP、插件、高级功能模块的升级，确保所有模块风格与质量统一。
  • M4 (2026.9) — 代理索引上线：生成并发布最终的 agent-manifest.json 和 AGENT-INDEX.md，创建可供代理查询的技能，并发布跨模块配方集 RECIPES.md。
  • M5 (2026.10-11) — 版本审计与扩展：全面审计所有模块内容，确保与当前 Claude Code 版本同步，并扩展配方库。
  • M6 (2026.12-2027.3) — 系统自治：建立自动化流程，确保每次 Claude Code 发布后文档都能自动同步更新，代理索引覆盖100%模块，社区页面有机增长。

如何参与贡献

本指南遵循严格的文档结构规范，贡献者需遵守 STYLE_GUIDE.md 和 CLAUDE.md 中的规定。

关键规则与命令：

  • 代码围栏（Code Block）必须声明语言标签（如 bash、python、json），否则预提交检查会失败。
  • 内部链接使用相对路径。
  • 所有提交必须通过预提交质量门，执行以下检查：
    # 运行完整的质量门检查（提交时自动运行）
pre-commit run --all-files
# 检查包含：markdown-lint, cross-references, mermaid-syntax, link-check, build-epub
  • 遵循 Conventional Commits 格式，例如 docs(hooks): 优化决策树图表。

当前可参与的具体任务：路线图已分解为68项任务（详见 TASKS-20260401.md），按阶段分布。你可以从为某个模块添加一个“Try It Now”区块或完善一个决策树开始。

FAQ

Q: Claude HowTo 和 Claude Code 官方文档是什么关系？ A: Claude HowTo 教程指南是一个独立的、基于 MIT 协议的开源项目，旨在通过系统化的教程、可复制的模板和可视化图表，帮助开发者进阶学习 Claude Code。它并非官方文档的副本或替代品。

Q: 这个为期一年的路线图是否过于乐观？ A: 路线图将总工作量拆分为68项具体任务，并设置了每两个月的检查点（里程碑），这是一种务实的分阶段交付方式。项目的持续维护（M6）也考虑了长期自动化。

Q: AI Agent Index 具体如何工作？ A: 项目将通过一个脚本（scripts/build-agent-index.py）扫描所有模块的 README，提取标题、代码示例、表格等结构化信息，生成机器可读的 agent-manifest.json。AI 代理可以读取这个文件，快速定位到最相关的模板和指南，例如查找“如何配置MCP服务器”的示例。