claude-howto 双受众知识库演进路线图从静态教程仓库到 AI Agent 可查询的基础设施【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto本文基于仓库规划文档 docs/ROADMAP-20260401.md 与配套执行清单 docs/TASKS-20260401.md 展开并结合仓库当前源码与目录结构进行现状核验。规划覆盖 2026 年 4 月至 2027 年 3 月共 7 大支柱、6 个里程碑M1–M6与 68 项分解任务T-001–T-068旨在把 claude-howto 从一本静态教程仓库升级为同时服务人类学习者与 AI Agent 的活的知识系统。一、路线图的底层逻辑为什么要从单受众转向双受众claude-howto 当前定位是一套可视化、示例驱动的 Claude Code 教程仓库根目录 README.md 将其描述为10 个编号模块01-slash-commands/~10-cli/从斜杠命令到自定义 Agent 团队配合可复制粘贴的模板与 Mermaid 图解帮助用户在一个周末内掌握 Claude Code。但 docs/ROADMAP-20260401.md 提出的是一个根本性的转型命题Transform claude-howto from a static tutorial repo into aliving, dual-audience knowledge system.即从静态教程仓库进化为活的双受众知识系统面向人类For humans提供互动式、基于真实场景的学习体验内容带难度递进、决策树decision tree和可被专家收藏的具名模式named patterns面向 AI AgentFor agents建立结构化的元数据索引让 Agent 在动手执行 Claude Code 任务前先查询这份索引——使这个仓库成为基础设施infrastructure而非仅仅是内容content。路线图中有一句直白的判断No competitor targets AI agents as a primary audience. This is the moat.没有竞品把 AI Agent 当作第一受众这就是护城河。这句话属于规划文档中的战略自述其可验证性取决于后续执行作为规划输入它解释了为何要把 P2AI Agent 索引摆在支柱层的核心位置。值得强调的是这一愿景与仓库现有的架构约束高度一致根目录 CLAUDE.md 明确写着Tutorial repo. Output is markdown in numbered modules01-through10-, not an app也就是说产品的本体始终是 Markdown 文档与可复制的模板新增的索引、清单、脚本都是围绕这批 Markdown 构建的服务层而非另起炉灶的应用。二、7 大支柱The 7 Pillars总览路线图把全部工作收敛为 7 根支柱每根对应一类可交付的能力。下表为原文完整继承#PillarWhat it deliversP1Fun LayerScenario intros Try It Now blocks in every moduleP2AI Agent IndexGeneratedagent-manifest.jsonAGENT-INDEX.md lookup skillP3aExpert Reference (in-module)Decision trees named patterns per moduleP3bExpert Reference (cross-module)RECIPES.md— compound multi-feature workflowsP4Newcomer Onboardingquickstart.shQUICKSTART.md difficulty badgesP5Community ShowcaseCOMMUNITY-PROJECTS.md— curated user projectsP6Content QualityExpand weakest modules; projectCLAUDE.mdP7Living CurriculumWHATS-NEW.md version badges weekly staleness CI action把这 7 根支柱映射回仓库现有结构可以更清楚地看到它们各自长在什么地方P1/P3a 面向模块内容作用于01-slash-commands/~10-cli/十个编号模块的 README要求每个模块都具备场景式导语 Try It Now 试玩块 决策树 具名模式四件套见 M3 的验收标准P2 面向机器可读层新增agent-manifest.json结构化数据与AGENT-INDEX.md人类可读摘要并配套生成器脚本scripts/build-agent-index.py与查询技能skills/claude-howto-lookup/SKILL.mdP3b/P5 面向跨模块与社区新增RECIPES.md复合工作流菜谱与COMMUNITY-PROJECTS.md社区项目展台P4/P7 面向新人体验与时效性新增一键配置脚本、难度徽章、版本徽章与过期检查 CIP6 面向质量治理先把最薄弱的两个模块06-hooks、08-checkpoints补强再用项目自身的CLAUDE.md作为最佳实践示范。三、时间线与里程碑设计逻辑路线图给出了紧凑的 12 个月推进节奏Apr 2026 May–Jun 2026 Jul–Aug 2026 Sep 2026 Oct–Nov 2026 Dec 2026–Mar 2027 | | | | | | [M1] [M2] [M3] [M4] [M5] [M6] Infrastructure 6/10 modules 10/10 Agent layer Version audit Self-sustaining hooks/checks complete complete recipes complete system时间线的编排遵循一条清晰的依赖链先立基础设施M1再逐批补内容M2/M3内容齐备后才上线 Agent 索引M4随后做版本审计与菜谱扩充M5最终进入自维护状态M6。这种基础设施先行、内容分批补、机器层殿后的顺序避免在内容残缺时过早构建依赖内容的元数据层。四、六大里程碑逐一拆解M1–M6M1 — Infrastructure Live2026 年 4 月底目标让基础设施对所有后续阶段产生杠杆效应并优先抢救最容易流失新人访问者的两个最薄弱模块hooks 与 checkpoints。交付内容原文完整继承交付物说明scripts/quickstart.sh新用户一键配置脚本要求幂等即重复执行不产生副作用QUICKSTART.md最初 15 分钟可视化上手指南难度徽章 What youll build 预览覆盖全部 10 个模块WHATS-NEW.md 版本徽章全部模块标注所验证的 Claude Code 版本.github/workflows/staleness-check.yml每周一 09:00 UTC 触发若某模块超过 30 天未验证则开 Issue根目录CLAUDE.md项目自身配置作为最佳实践范例scripts/build-agent-index.py读取全部 10 个模块 → 生成agent-manifest.jsonAGENT-INDEX.md06-hooks 深度改造5 个完整 hook 脚本、决策树、Try It Now、具名模式08-checkpoints 深度改造行数从 311 扩至 8003 个工作流模板、决策树、具名模式为什么从这里开始原文基础设施能让每个后续阶段受益hooks 与 checkpoints 是最薄弱模块最可能流失新访客。仓库现状核验从当前仓库树看M1 的成果部分落地根目录 CLAUDE.md 已存在且内容非常完整——它定义了项目的自我约束commit 格式type(scope): subject、禁止未授权提交、代码围栏必须声明语言、Mermaid 图必须可解析等。这正是 T-007 所要求的项目自己的配置作为最佳实践示范可以作为CLAUDE.md的活样板scripts/ 目录已有一套 Markdown 校验工具check_cross_references.py、check_links.py、check_markdown_rendering.py、check_mermaid.py、build_epub.py、build_website.pypre-commit 会跑 5 项文档检查见 CLAUDE.md 的 Critical commands 与 Hard rules——说明仓库在文档质量治理上已有与路线图同方向且更细的沉淀但quickstart.sh、build-agent-index.py、WHATS-NEW.md、staleness-check.yml 等工作簿中的文件尚未出现在仓库树中06-hooksREADME 已达约 1500 行且已包含 Mermaid/决策树/模式类内容经检索命中多处T-016~T-020 的目标在很大程度上已经兑现08-checkpoints当前 README.md 约 346 行另有 checkpoint-examples.md约 348 行仓库中尚检索不到该模块的 flowchart/mermaid 决策树——对照 T-009~T-015重写场景化导语、Mermaid 决策树、3 个工作流模板、生命周期图、2 Try It Now、2 具名模式M1 中 08-checkpoints 的311 → 800 行深度改造尚未完全体现在仓库中。上述对照表明路线图是规划中的未来态仓库是逐步趋近规划的实现态二者存在时间差是规划类文档的正常属性。M2 — 6/10 模块完成2026 年 6 月底目标对 4 个较强模块各做一次深度改造让模块内容成熟度过半。交付内容01-slash-commands、02-memory、03-skills、10-cli四个模块各补场景式导语、决策树、Try It Now、具名模式CI 步骤每次 push 校验agent-manifest.jsonschema每个模块改造完成后都运行生成器确认能产出合法 manifest。仓库现状核验当前仓库中01-slash-commands/README.md约 664 行、02-memory/README.md约 1200 行、10-cli/README.md约 1040 行均已相当厚实各自包含大量可复制模板如 01-slash-commands/ 下的pr.md、optimize.md、generate-api-docs.md02-memory/ 下的project-CLAUDE.md、directory-api-CLAUDE.md、personal-CLAUDE.md为深度改造提供了扎实的内容底座。不过 T-038 要求的 CI 校验 manifest schema 依赖 manifest 生成器先落地目前尚不具备运行条件。M3 — 全部 10 模块完成2026 年 8 月底目标把剩下 4 个高级模块补齐达到每个模块四件套齐备的全覆盖验收线。交付内容04-subagents完整深度改造含 The Multi-Agent Review Pattern 多 Agent 评审模式05-mcp、07-plugins、09-advanced-features完整深度改造覆盖标准原文Every module now has: scenario intro, 2 Try It Now blocks, Mermaid decision tree, 2 named patterns——即每个模块至少要有1 个场景导语、2 个以上 Try It Now 块、1 张 Mermaid 决策树、2 个以上具名模式。仓库现状核验这些模块的内容资产已经具备良好起点——例如 04-subagents/ 已包含 9 个专业子代理定义code-reviewer.md、test-engineer.md、secure-reviewer.md、debugger.md、data-scientist.md、implementation-agent.md、documentation-writer.md、performance-optimizer.md、clean-code-reviewer.md07-plugins/ 下已有pr-review/、devops-automation/、documentation/三个完整插件每个都带 agents/commands/hooks/mcp/scripts 子结构09-advanced-features/ 有 config-examples.json 与 planning-mode-examples.md。这使 10/10 完成 更多是内容工程补强而非从零写作。M4 — Agent 层上线2026 年 9 月底目标在内容 100% 完成后把机器可读层正式点亮。路线图专门解释了为什么放在 9 月The agent index is only meaningful once all 10 modules are content-complete.——索引只有在内容齐备后才真正有意义内容残缺时生成的索引价值有限。交付内容对全部 10 个已完成的模块运行scripts/build-agent-index.py产出覆盖 100% 模块的最终agent-manifest.json生成AGENT-INDEX.md并从 README.md 增加入口链接新增skills/claude-howto-lookup/SKILL.md轻量级 Agent 技能读取 manifest 定位相关模块再用 Read 加载对应小节安装方式来自 T-056为cp -r claude-howto/skills/claude-howto-lookup ~/.claude/skills/新增RECIPES.md5 个以上复合工作流每条菜谱 schema 为name, modules-used, problem, solution, expected outcome名称 / 用到的模块 / 问题 / 解决代码块 / 预期结果示例即skill hook subagent 自动化评审流水线新增COMMUNITY-PROJECTS.md静态策展页 基于 PR 的投稿格式T-057 要求在quickstart.sh与QUICKSTART.md中把 lookup skill 作为可选功能提及。仓库现状核验全仓库含所有翻译目录检索不到agent-manifest.json、AGENT-INDEX.md、RECIPES.md、COMMUNITY-PROJECTS.md或skills/claude-howto-lookup——该阶段交付物目前仍停留在规划层面尚未落盘。M5 — 版本审计完成2026 年 11 月底目标保证内容与 Claude CodeCC当前版本严格对齐并从社区反哺内容。交付内容对全部 10 个模块做版本审计逐一对照当前 CC 版本验证全局更新cc_version_verifiedfrontmatter 与版本徽章RECIPES.md扩至 8 条依据从社区观察到的真实模式提炼置顶一条 GitHub DiscussionShare your Claude Code workflows为 Agent 真实用法收集信号指导后续菜谱扩充。对照当前根目录 README.md它标注 Last Updated: August 19, 2026 / Claude Code Version: 2.1.235说明版本徽章这一机制的精神已在首页体现version 2.1.235、Claude Code 2.1 兼容徽章但逐模块 frontmatter 版本字段 自动化审计仍是规划动作。M6 — 自维持系统2027 年 3 月底目标让系统在无人持续推动下自我更新。交付内容 / 持续运行项/docs-sync-claude-code技能在每次 CC 发版后运行自动更新WHATS-NEW.mdAgent manifest 的 CI 回归测试强制 100% 模块覆盖若某个模块缺失即 CI 失败RECIPES.md达到 10 条COMMUNITY-PROJECTS.md自然增长持续策展评估来自 GitHub Discussion 的 Agent 使用信号——若被验证成立则投入推广 lookup skill营销、asm registry 等渠道。值得注意M6 中提到的/docs-sync-claude-code属于本项目为追踪 Claude Code 发版、同步文档而设计的技能其具体名称与运行方式以路线图规划为准。五、范围外事项显式防止范围蔓延路线图用专节列出不在范围清单防止这些事项悄悄挤占主线资源规划将它们记录到TODOS.mdSkill 市场 / 可安装注册中心Skill marketplace or installable registry自定义网站或仪表盘Custom website or dashboard完成度追踪completion tracking / cc-progress社区教程 CI 校验自动生成CONTRIBUTORS.md多语言翻译Multi-language translations测验/自评基础设施Quiz/assessment infrastructure项目社区投票机制其中多语言翻译一条与仓库现实形成有趣对照——当前仓库实际上已经维护了zh/、vi/、uk/、ja/四套翻译目录以及 scripts/sync_translations.py 这类同步工具。这说明该条目指的是不把翻译工程化如 CI 校验、模板化流水线纳入本路线图主线而非否认已有翻译资产的存在两者并不矛盾。六、把路线图与仓库既有工程实践对齐路线图并非悬在空中的 PPT它与仓库已有的工程文化深度耦合。以下四点可以直接用仓库证据印证文档即产品 质量门禁已经是现役机制。根目录 CLAUDE.md 描述的 pre-commit 5 项文档检查markdown-lint、cross-references、mermaid-syntax、link-check、markdown-rendering与 scripts/tests/ 下的 pytest 用例说明仓库已经在用可验证的 CI守护 Markdown 质量。路线图 P7 的 staleness-check CI 与 T-038 的 manifest schema 校验本质是同一治理思路向时效性与结构合法性两个新维度的延伸。相对路径与锚点链接规范为 Agent 索引埋好了伏笔。CLAUDE.md 规定Internal links use relative paths… anchors use#heading-name而 scripts/README.md 提到网站构建器复用了check_cross_references.heading_to_anchor的锚点生成算法保证#anchor链接在渲染站点上同样有效。这种链接可解析的纪律正是 P2 中build-agent-index.pyValidates references point to actual filesT-008能落地的前提——机器可以信任文档内的引用。单源真值single source of truth理念与生成器策略一致。scripts/README.md 反复强调.md文件是唯一真值EPUB 与静态站点都只是渲染产物docs/ROADMAP-20260401.md 中的agent-manifest.json/AGENT-INDEX.md同样定位为从 10 个模块生成的派生物表格中明确标注(generated)。整个知识系统保持内容一份、格式多出的架构品位。弱模块的识别方式与现有行数可相互印证。路线图点名 06-hooks 与 08-checkpoints 为最薄弱模块是 M1 的起点判断截至本文核验时06-hooks 已通过改造显著增厚而 08-checkpoints 仍相对单薄说明路线图对哪个模块需要抢救的判断在时间上具有先见性。七、读图导航如何用这份路线图对不同读者这份规划文档的使用方式不同贡献者 / 维护者以 docs/TASKS-20260401.md 的 T-001~T-068 为操作清单按 Phase 1~6 认领任务每个 Phase 结尾的 checkpointM1 Checkpoint、M2 Checkpoint……是验收闸口。例如认领 T-008 前先阅读 scripts/ 目录现有的生成器与校验器风格上保持一致想要让 Agent 读懂本仓库的研究者重点跟踪 P2 相关任务T-008、T-055~T-057与最终产物agent-manifest.json/AGENT-INDEX.md/skills/claude-howto-lookup它们定义了仓库成为 Agent 基础设施的最终形态普通 Claude Code 用户直接受益于 P1/P4 的可视化改造结果——每个模块的场景导语 Try It Now 决策树 具名模式四件套能显著降低装好了但不会用的挫败感下游系统集成者留意 P7 的版本徽章与cc_version_verifiedfrontmatter——这是判断仓库内容与我当前 Claude Code 版本是否对齐的机器可读信号。八、总结一份把教程变成基础设施的执行蓝本综合来看docs/ROADMAP-20260401.md 提供的不只是一张甘特图而是一套可执行的分层演进策略结构上以内容四件套场景/Try It Now/决策树/模式统一 10 个模块的成熟度标准机制上以生成器 CI 校验 时效检查把质量从人工自觉升级为工程强制受众上以agent-manifest.json与 lookup skill 打开第二受众AI Agent让仓库既能被人类翻页阅读也能被 Agent 程序化查询节奏上通过 M1→M6 的依赖排序基础设施 → 内容 → 机器层 → 审计 → 自维持把复杂的整体转型切成了每个阶段可独立验收的增量。对希望构建知识库基础设施的开发者而言这份路线图本身就是一个高质量的范本先把内容治理干净再让内容变得机器可寻址最后用自动化让两者持续保鲜。仓库现状核验显示其中文档质量门禁、模块内容沉淀、项目自我配置CLAUDE.md等若干环节已经先行落地而 manifest 层与社区层仍在推进中——这正是路线图从静态走向活体演进过程中的真实切片。【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 claude-howto 双受众知识库演进路线图：从静态教程仓库到 AI Agent 可查询的基础设施
claude-howto 双受众知识库演进路线图从静态教程仓库到 AI Agent 可查询的基础设施【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto本文基于仓库规划文档 docs/ROADMAP-20260401.md 与配套执行清单 docs/TASKS-20260401.md 展开并结合仓库当前源码与目录结构进行现状核验。规划覆盖 2026 年 4 月至 2027 年 3 月共 7 大支柱、6 个里程碑M1–M6与 68 项分解任务T-001–T-068旨在把 claude-howto 从一本静态教程仓库升级为同时服务人类学习者与 AI Agent 的活的知识系统。一、路线图的底层逻辑为什么要从单受众转向双受众claude-howto 当前定位是一套可视化、示例驱动的 Claude Code 教程仓库根目录 README.md 将其描述为10 个编号模块01-slash-commands/~10-cli/从斜杠命令到自定义 Agent 团队配合可复制粘贴的模板与 Mermaid 图解帮助用户在一个周末内掌握 Claude Code。但 docs/ROADMAP-20260401.md 提出的是一个根本性的转型命题Transform claude-howto from a static tutorial repo into aliving, dual-audience knowledge system.即从静态教程仓库进化为活的双受众知识系统面向人类For humans提供互动式、基于真实场景的学习体验内容带难度递进、决策树decision tree和可被专家收藏的具名模式named patterns面向 AI AgentFor agents建立结构化的元数据索引让 Agent 在动手执行 Claude Code 任务前先查询这份索引——使这个仓库成为基础设施infrastructure而非仅仅是内容content。路线图中有一句直白的判断No competitor targets AI agents as a primary audience. This is the moat.没有竞品把 AI Agent 当作第一受众这就是护城河。这句话属于规划文档中的战略自述其可验证性取决于后续执行作为规划输入它解释了为何要把 P2AI Agent 索引摆在支柱层的核心位置。值得强调的是这一愿景与仓库现有的架构约束高度一致根目录 CLAUDE.md 明确写着Tutorial repo. Output is markdown in numbered modules01-through10-, not an app也就是说产品的本体始终是 Markdown 文档与可复制的模板新增的索引、清单、脚本都是围绕这批 Markdown 构建的服务层而非另起炉灶的应用。二、7 大支柱The 7 Pillars总览路线图把全部工作收敛为 7 根支柱每根对应一类可交付的能力。下表为原文完整继承#PillarWhat it deliversP1Fun LayerScenario intros Try It Now blocks in every moduleP2AI Agent IndexGeneratedagent-manifest.jsonAGENT-INDEX.md lookup skillP3aExpert Reference (in-module)Decision trees named patterns per moduleP3bExpert Reference (cross-module)RECIPES.md— compound multi-feature workflowsP4Newcomer Onboardingquickstart.shQUICKSTART.md difficulty badgesP5Community ShowcaseCOMMUNITY-PROJECTS.md— curated user projectsP6Content QualityExpand weakest modules; projectCLAUDE.mdP7Living CurriculumWHATS-NEW.md version badges weekly staleness CI action把这 7 根支柱映射回仓库现有结构可以更清楚地看到它们各自长在什么地方P1/P3a 面向模块内容作用于01-slash-commands/~10-cli/十个编号模块的 README要求每个模块都具备场景式导语 Try It Now 试玩块 决策树 具名模式四件套见 M3 的验收标准P2 面向机器可读层新增agent-manifest.json结构化数据与AGENT-INDEX.md人类可读摘要并配套生成器脚本scripts/build-agent-index.py与查询技能skills/claude-howto-lookup/SKILL.mdP3b/P5 面向跨模块与社区新增RECIPES.md复合工作流菜谱与COMMUNITY-PROJECTS.md社区项目展台P4/P7 面向新人体验与时效性新增一键配置脚本、难度徽章、版本徽章与过期检查 CIP6 面向质量治理先把最薄弱的两个模块06-hooks、08-checkpoints补强再用项目自身的CLAUDE.md作为最佳实践示范。三、时间线与里程碑设计逻辑路线图给出了紧凑的 12 个月推进节奏Apr 2026 May–Jun 2026 Jul–Aug 2026 Sep 2026 Oct–Nov 2026 Dec 2026–Mar 2027 | | | | | | [M1] [M2] [M3] [M4] [M5] [M6] Infrastructure 6/10 modules 10/10 Agent layer Version audit Self-sustaining hooks/checks complete complete recipes complete system时间线的编排遵循一条清晰的依赖链先立基础设施M1再逐批补内容M2/M3内容齐备后才上线 Agent 索引M4随后做版本审计与菜谱扩充M5最终进入自维护状态M6。这种基础设施先行、内容分批补、机器层殿后的顺序避免在内容残缺时过早构建依赖内容的元数据层。四、六大里程碑逐一拆解M1–M6M1 — Infrastructure Live2026 年 4 月底目标让基础设施对所有后续阶段产生杠杆效应并优先抢救最容易流失新人访问者的两个最薄弱模块hooks 与 checkpoints。交付内容原文完整继承交付物说明scripts/quickstart.sh新用户一键配置脚本要求幂等即重复执行不产生副作用QUICKSTART.md最初 15 分钟可视化上手指南难度徽章 What youll build 预览覆盖全部 10 个模块WHATS-NEW.md 版本徽章全部模块标注所验证的 Claude Code 版本.github/workflows/staleness-check.yml每周一 09:00 UTC 触发若某模块超过 30 天未验证则开 Issue根目录CLAUDE.md项目自身配置作为最佳实践范例scripts/build-agent-index.py读取全部 10 个模块 → 生成agent-manifest.jsonAGENT-INDEX.md06-hooks 深度改造5 个完整 hook 脚本、决策树、Try It Now、具名模式08-checkpoints 深度改造行数从 311 扩至 8003 个工作流模板、决策树、具名模式为什么从这里开始原文基础设施能让每个后续阶段受益hooks 与 checkpoints 是最薄弱模块最可能流失新访客。仓库现状核验从当前仓库树看M1 的成果部分落地根目录 CLAUDE.md 已存在且内容非常完整——它定义了项目的自我约束commit 格式type(scope): subject、禁止未授权提交、代码围栏必须声明语言、Mermaid 图必须可解析等。这正是 T-007 所要求的项目自己的配置作为最佳实践示范可以作为CLAUDE.md的活样板scripts/ 目录已有一套 Markdown 校验工具check_cross_references.py、check_links.py、check_markdown_rendering.py、check_mermaid.py、build_epub.py、build_website.pypre-commit 会跑 5 项文档检查见 CLAUDE.md 的 Critical commands 与 Hard rules——说明仓库在文档质量治理上已有与路线图同方向且更细的沉淀但quickstart.sh、build-agent-index.py、WHATS-NEW.md、staleness-check.yml 等工作簿中的文件尚未出现在仓库树中06-hooksREADME 已达约 1500 行且已包含 Mermaid/决策树/模式类内容经检索命中多处T-016~T-020 的目标在很大程度上已经兑现08-checkpoints当前 README.md 约 346 行另有 checkpoint-examples.md约 348 行仓库中尚检索不到该模块的 flowchart/mermaid 决策树——对照 T-009~T-015重写场景化导语、Mermaid 决策树、3 个工作流模板、生命周期图、2 Try It Now、2 具名模式M1 中 08-checkpoints 的311 → 800 行深度改造尚未完全体现在仓库中。上述对照表明路线图是规划中的未来态仓库是逐步趋近规划的实现态二者存在时间差是规划类文档的正常属性。M2 — 6/10 模块完成2026 年 6 月底目标对 4 个较强模块各做一次深度改造让模块内容成熟度过半。交付内容01-slash-commands、02-memory、03-skills、10-cli四个模块各补场景式导语、决策树、Try It Now、具名模式CI 步骤每次 push 校验agent-manifest.jsonschema每个模块改造完成后都运行生成器确认能产出合法 manifest。仓库现状核验当前仓库中01-slash-commands/README.md约 664 行、02-memory/README.md约 1200 行、10-cli/README.md约 1040 行均已相当厚实各自包含大量可复制模板如 01-slash-commands/ 下的pr.md、optimize.md、generate-api-docs.md02-memory/ 下的project-CLAUDE.md、directory-api-CLAUDE.md、personal-CLAUDE.md为深度改造提供了扎实的内容底座。不过 T-038 要求的 CI 校验 manifest schema 依赖 manifest 生成器先落地目前尚不具备运行条件。M3 — 全部 10 模块完成2026 年 8 月底目标把剩下 4 个高级模块补齐达到每个模块四件套齐备的全覆盖验收线。交付内容04-subagents完整深度改造含 The Multi-Agent Review Pattern 多 Agent 评审模式05-mcp、07-plugins、09-advanced-features完整深度改造覆盖标准原文Every module now has: scenario intro, 2 Try It Now blocks, Mermaid decision tree, 2 named patterns——即每个模块至少要有1 个场景导语、2 个以上 Try It Now 块、1 张 Mermaid 决策树、2 个以上具名模式。仓库现状核验这些模块的内容资产已经具备良好起点——例如 04-subagents/ 已包含 9 个专业子代理定义code-reviewer.md、test-engineer.md、secure-reviewer.md、debugger.md、data-scientist.md、implementation-agent.md、documentation-writer.md、performance-optimizer.md、clean-code-reviewer.md07-plugins/ 下已有pr-review/、devops-automation/、documentation/三个完整插件每个都带 agents/commands/hooks/mcp/scripts 子结构09-advanced-features/ 有 config-examples.json 与 planning-mode-examples.md。这使 10/10 完成 更多是内容工程补强而非从零写作。M4 — Agent 层上线2026 年 9 月底目标在内容 100% 完成后把机器可读层正式点亮。路线图专门解释了为什么放在 9 月The agent index is only meaningful once all 10 modules are content-complete.——索引只有在内容齐备后才真正有意义内容残缺时生成的索引价值有限。交付内容对全部 10 个已完成的模块运行scripts/build-agent-index.py产出覆盖 100% 模块的最终agent-manifest.json生成AGENT-INDEX.md并从 README.md 增加入口链接新增skills/claude-howto-lookup/SKILL.md轻量级 Agent 技能读取 manifest 定位相关模块再用 Read 加载对应小节安装方式来自 T-056为cp -r claude-howto/skills/claude-howto-lookup ~/.claude/skills/新增RECIPES.md5 个以上复合工作流每条菜谱 schema 为name, modules-used, problem, solution, expected outcome名称 / 用到的模块 / 问题 / 解决代码块 / 预期结果示例即skill hook subagent 自动化评审流水线新增COMMUNITY-PROJECTS.md静态策展页 基于 PR 的投稿格式T-057 要求在quickstart.sh与QUICKSTART.md中把 lookup skill 作为可选功能提及。仓库现状核验全仓库含所有翻译目录检索不到agent-manifest.json、AGENT-INDEX.md、RECIPES.md、COMMUNITY-PROJECTS.md或skills/claude-howto-lookup——该阶段交付物目前仍停留在规划层面尚未落盘。M5 — 版本审计完成2026 年 11 月底目标保证内容与 Claude CodeCC当前版本严格对齐并从社区反哺内容。交付内容对全部 10 个模块做版本审计逐一对照当前 CC 版本验证全局更新cc_version_verifiedfrontmatter 与版本徽章RECIPES.md扩至 8 条依据从社区观察到的真实模式提炼置顶一条 GitHub DiscussionShare your Claude Code workflows为 Agent 真实用法收集信号指导后续菜谱扩充。对照当前根目录 README.md它标注 Last Updated: August 19, 2026 / Claude Code Version: 2.1.235说明版本徽章这一机制的精神已在首页体现version 2.1.235、Claude Code 2.1 兼容徽章但逐模块 frontmatter 版本字段 自动化审计仍是规划动作。M6 — 自维持系统2027 年 3 月底目标让系统在无人持续推动下自我更新。交付内容 / 持续运行项/docs-sync-claude-code技能在每次 CC 发版后运行自动更新WHATS-NEW.mdAgent manifest 的 CI 回归测试强制 100% 模块覆盖若某个模块缺失即 CI 失败RECIPES.md达到 10 条COMMUNITY-PROJECTS.md自然增长持续策展评估来自 GitHub Discussion 的 Agent 使用信号——若被验证成立则投入推广 lookup skill营销、asm registry 等渠道。值得注意M6 中提到的/docs-sync-claude-code属于本项目为追踪 Claude Code 发版、同步文档而设计的技能其具体名称与运行方式以路线图规划为准。五、范围外事项显式防止范围蔓延路线图用专节列出不在范围清单防止这些事项悄悄挤占主线资源规划将它们记录到TODOS.mdSkill 市场 / 可安装注册中心Skill marketplace or installable registry自定义网站或仪表盘Custom website or dashboard完成度追踪completion tracking / cc-progress社区教程 CI 校验自动生成CONTRIBUTORS.md多语言翻译Multi-language translations测验/自评基础设施Quiz/assessment infrastructure项目社区投票机制其中多语言翻译一条与仓库现实形成有趣对照——当前仓库实际上已经维护了zh/、vi/、uk/、ja/四套翻译目录以及 scripts/sync_translations.py 这类同步工具。这说明该条目指的是不把翻译工程化如 CI 校验、模板化流水线纳入本路线图主线而非否认已有翻译资产的存在两者并不矛盾。六、把路线图与仓库既有工程实践对齐路线图并非悬在空中的 PPT它与仓库已有的工程文化深度耦合。以下四点可以直接用仓库证据印证文档即产品 质量门禁已经是现役机制。根目录 CLAUDE.md 描述的 pre-commit 5 项文档检查markdown-lint、cross-references、mermaid-syntax、link-check、markdown-rendering与 scripts/tests/ 下的 pytest 用例说明仓库已经在用可验证的 CI守护 Markdown 质量。路线图 P7 的 staleness-check CI 与 T-038 的 manifest schema 校验本质是同一治理思路向时效性与结构合法性两个新维度的延伸。相对路径与锚点链接规范为 Agent 索引埋好了伏笔。CLAUDE.md 规定Internal links use relative paths… anchors use#heading-name而 scripts/README.md 提到网站构建器复用了check_cross_references.heading_to_anchor的锚点生成算法保证#anchor链接在渲染站点上同样有效。这种链接可解析的纪律正是 P2 中build-agent-index.pyValidates references point to actual filesT-008能落地的前提——机器可以信任文档内的引用。单源真值single source of truth理念与生成器策略一致。scripts/README.md 反复强调.md文件是唯一真值EPUB 与静态站点都只是渲染产物docs/ROADMAP-20260401.md 中的agent-manifest.json/AGENT-INDEX.md同样定位为从 10 个模块生成的派生物表格中明确标注(generated)。整个知识系统保持内容一份、格式多出的架构品位。弱模块的识别方式与现有行数可相互印证。路线图点名 06-hooks 与 08-checkpoints 为最薄弱模块是 M1 的起点判断截至本文核验时06-hooks 已通过改造显著增厚而 08-checkpoints 仍相对单薄说明路线图对哪个模块需要抢救的判断在时间上具有先见性。七、读图导航如何用这份路线图对不同读者这份规划文档的使用方式不同贡献者 / 维护者以 docs/TASKS-20260401.md 的 T-001~T-068 为操作清单按 Phase 1~6 认领任务每个 Phase 结尾的 checkpointM1 Checkpoint、M2 Checkpoint……是验收闸口。例如认领 T-008 前先阅读 scripts/ 目录现有的生成器与校验器风格上保持一致想要让 Agent 读懂本仓库的研究者重点跟踪 P2 相关任务T-008、T-055~T-057与最终产物agent-manifest.json/AGENT-INDEX.md/skills/claude-howto-lookup它们定义了仓库成为 Agent 基础设施的最终形态普通 Claude Code 用户直接受益于 P1/P4 的可视化改造结果——每个模块的场景导语 Try It Now 决策树 具名模式四件套能显著降低装好了但不会用的挫败感下游系统集成者留意 P7 的版本徽章与cc_version_verifiedfrontmatter——这是判断仓库内容与我当前 Claude Code 版本是否对齐的机器可读信号。八、总结一份把教程变成基础设施的执行蓝本综合来看docs/ROADMAP-20260401.md 提供的不只是一张甘特图而是一套可执行的分层演进策略结构上以内容四件套场景/Try It Now/决策树/模式统一 10 个模块的成熟度标准机制上以生成器 CI 校验 时效检查把质量从人工自觉升级为工程强制受众上以agent-manifest.json与 lookup skill 打开第二受众AI Agent让仓库既能被人类翻页阅读也能被 Agent 程序化查询节奏上通过 M1→M6 的依赖排序基础设施 → 内容 → 机器层 → 审计 → 自维持把复杂的整体转型切成了每个阶段可独立验收的增量。对希望构建知识库基础设施的开发者而言这份路线图本身就是一个高质量的范本先把内容治理干净再让内容变得机器可寻址最后用自动化让两者持续保鲜。仓库现状核验显示其中文档质量门禁、模块内容沉淀、项目自我配置CLAUDE.md等若干环节已经先行落地而 manifest 层与社区层仍在推进中——这正是路线图从静态走向活体演进过程中的真实切片。【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考