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