89e89d4aa3
Add Chinese (Simplified) translations for all documentation, organized under a dedicated zh/ directory that mirrors the English folder structure. Co-authored-by: tanqingkuang <tanqingkuang@users.noreply.github.com> Translations originally contributed by @tanqingkuang in #45. Restructured from *-CN.md suffix pattern into zh/ directory to prevent the EPUB builder (scripts/build_epub.py collect_folder_files) from picking up Chinese files via glob("*.md") inside module folders.
6.2 KiB
6.2 KiB
路线图：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_verifiedfrontmatter 和版本徽章 RECIPES.md扩展到 8 个以上 recipes，基于社区模式总结- GitHub 固定讨论串：“分享你的 Claude Code 工作流” - 收集 agent 使用信号
M6 - 自我维持系统 · 2027 年 3 月底
持续交付 / 持续运行：
/docs-sync-claude-codeskill 在每次 CC 发布后运行 → 更新WHATS-NEW.md- Agent manifest CI 回归测试：强制 100% 模块覆盖
RECIPES.md增加到 10 个以上 recipesCOMMUNITY-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
- 多语言翻译
- 测验 / 评估基础设施
- 社区项目投票