github-code/claude-howto
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
main
claude-howto/zh/docs/TASKS-20260401.md
Luong NGUYEN 89e89d4aa3 feat(zh): add Chinese translations in zh/ directory 
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.
2026-04-06 23:08:54 +02:00

12 KiB
Raw Permalink Blame History

任务：双层知识库 - claude-howto

创建于：2026-04-01

里程碑

# 里程碑 目标时间 描述
M1 基础设施上线 2026 年 4 月底 quickstart.sh、CLAUDE.md、staleness action、代理索引生成器上线；升级 2 个最薄弱模块
M2 6/10 个模块完成 2026 年 6 月底 Slash commands、memory、skills、CLI 模块完全升级；生成器输出有效 manifest
M3 10/10 个模块完成 2026 年 8 月底 每个模块都具备场景导语、Try It Now 模块、决策树、命名模式
M4 代理层上线 2026 年 9 月底 生成 agent-manifest.json + AGENT-INDEX.md；仓库内有 lookup skill；RECIPES.md + COMMUNITY-PROJECTS.md 上线
M5 版本审计完成 2026 年 11 月底 所有 10 个模块都验证过当前 CC 版本；RECIPES.md 达到 8+ recipes
M6 自我维持系统 2027 年 3 月底 Agent manifest 覆盖 100% 模块（通过 CI 校验）；RECIPES.md 达到 10+；社区页面自然增长

第 1 阶段 - 基础设施与薄弱模块（2026 年 4 月）

目标里程碑：M1

支柱 4：新手上手

  • T-001 - 编写 scripts/quickstart.sh

    • 检测 ~/.claude/ 目录（如缺失，则在用户确认后创建）
    • 将第一个 slash command + CLAUDE.md + skill 复制到用户配置中
    • 在 CLAUDE.md 末尾追加 agent-discovery 行，链接到 AGENT-INDEX.md
    • 幂等：跳过已有文件并给出警告，绝不覆盖
    • 完成后打印下一步

  • T-002 - 创建 QUICKSTART.md（前 15 分钟可视化指南）

    • 使用代码块记录带注释的终端步骤（尽量避免 PNG 截图；优先 ASCII 或 Mermaid）
    • 记录每条命令对应哪个视觉结果，方便后续重新采集

  • T-003 - 为所有 10 个模块的 README 添加难度徽章

    • 格式：> 🟢 **Beginner** | ⏱ 30 minutes，放在每个模块 README 顶部
    • 在徽章下方添加 "What you'll build" 的要点预览

支柱 7：活课程体系

  • T-004 - 创建 WHATS-NEW.md

    • 格式：## CC vX.X — DATE，每个功能变更使用项目符号
    • 至少添加一条当前 CC 版本的记录

  • T-005 - 为所有 10 个模块的 README 添加版本徽章

    • 格式：> ✅ Verified against Claude Code **vX.X.X** · Last verified: YYYY-MM-DD
    • 在每个模块的 frontmatter 中加入 cc_version_verified

  • T-006 - 创建 .github/workflows/staleness-check.yml

    • 调度：每周一 09:00 UTC
    • 从 frontmatter 读取每个模块的 last_verified 日期（使用 yq 或 10 行 Python 脚本）
    • 对 30 天以上未验证的模块创建 GitHub Issue
    • 如果已有同名 open issue，则跳过

支柱 6：内容质量（CLAUDE.md）

  • T-007 - 为项目创建根目录 CLAUDE.md
    • 作为项目自身配置，展示最佳实践
    • 记录贡献规范、模块结构和维护流程

支柱 2：AI 代理索引（生成器）

  • T-008 - 编写 scripts/build-agent-index.py
    • 读取全部 10 个模块 README
    • 提取：标题（→ topics）、代码块（→ 带语言标签的示例）、表格（→ 参考数据）
    • 输出 agent-manifest.json，schema 按 CEO 计划定义
    • 输出 AGENT-INDEX.md（人类可读摘要）
    • 校验引用是否指向真实文件

模块 08-checkpoints：完整深度处理（311 → 800+ 行）

  • T-009 - 用真实场景重写模块导语

    • 示例："你的重构把 3 个东西弄坏了。checkpoint 如何帮你恢复..."

  • T-010 - 添加 checkpoint 策略决策树（Mermaid flowchart）

    • "我想做 X" → 顺着箭头走 → 到达对应 checkpoint 模式

  • T-011 - 添加 3 个工作流模板

    • 安全重构工作流
    • 使用 checkpoints 做 A/B 测试
    • 灾难恢复工作流

  • T-012 - 添加与 planning mode 的整合部分

  • T-013 - 添加 checkpoint 生命周期的 Mermaid 图

  • T-014 - 添加 2 个以上 "Try It Now" 模块，并提供可验证命令

    • 每个模块：上下文句、要运行的命令、预期输出说明

  • T-015 - 添加 "Patterns & Recipes" 部分，包含 2 个以上命名模式

    • 每个模式：问题、解决方案代码、适用场景、不适用场景

模块 06-hooks：完整深度处理

  • T-016 - 用真实场景重写模块导语

    • 示例："你的 CI 在 20 分钟后才发现 lint 错误。hooks 2 秒内就能抓住..."

  • T-017 - 添加 hooks 决策树（Mermaid flowchart）

    • "我想在 Y 发生时触发 X" → 顺着箭头走 → 到达对应 hook 类型

  • T-018 - 添加 5 个完整 hook 示例，带完整脚本（每个约 80 行）

    1. 写入时自动格式化（prettier/black）
    2. 提交时安全扫描（trufflehog/bandit）
    3. 文件变更时运行测试
    4. 会话结束时发送通知
    5. 提示词校验（阻止危险模式）

  • T-019 - 添加 2 个以上 "Try It Now" 模块，并提供可验证命令

  • T-020 - 添加 "Patterns & Recipes" 部分，包含 2 个以上命名模式

M1 检查点：基础设施上线，2 个最薄弱模块完成深度升级

第 2 阶段 - 深度处理：强模块第一批（2026 年 5 月 - 6 月）

目标里程碑：M2

模块 01-slash-commands：完整深度处理

  • T-021 - 用场景重写导语（"你的队友刚推了 47 个文件..."）
  • T-022 - 添加决策树（Mermaid）
  • T-023 - 添加 2 个以上 "Try It Now" 模块
  • T-024 - 添加 "Patterns & Recipes" 部分，包含 2 个以上命名模式

模块 02-memory：完整深度处理

  • T-025 - 用真实场景重写导语
  • T-026 - 添加决策树（Mermaid）
  • T-027 - 添加 2 个以上 "Try It Now" 模块
  • T-028 - 添加 "Patterns & Recipes" 部分，包含 2 个以上命名模式

模块 03-skills：完整深度处理

  • T-029 - 用真实场景重写导语
  • T-030 - 添加决策树（Mermaid）
  • T-031 - 添加 2 个以上 "Try It Now" 模块
  • T-032 - 添加 "Patterns & Recipes" 部分，包含 2 个以上命名模式

模块 10-cli：完整深度处理

  • T-033 - 用真实场景重写导语
  • T-034 - 添加决策树（Mermaid）
  • T-035 - 添加 2 个以上 "Try It Now" 模块
  • T-036 - 添加 "Patterns & Recipes" 部分，包含 2 个以上命名模式

生成器校验

  • T-037 - 每次模块升级后运行 scripts/build-agent-index.py；确认 manifest 输出有效
  • T-038 - 在每次 push 时添加 CI 步骤：校验 agent-manifest.json schema

M2 检查点：6/10 个模块完成，生成器输出有效 manifest

第 3 阶段 - 深度处理：强模块第二批（2026 年 7 月 - 8 月）

目标里程碑：M3

模块 04-subagents：完整深度处理

  • T-039 - 用真实场景重写导语
  • T-040 - 添加决策树（Mermaid）
  • T-041 - 添加 2 个以上 "Try It Now" 模块
  • T-042 - 添加 "Patterns & Recipes" 部分（例如："The Multi-Agent Review Pattern"）

模块 05-mcp：完整深度处理

  • T-043 - 用真实场景重写导语
  • T-044 - 添加决策树（Mermaid）
  • T-045 - 添加 2 个以上 "Try It Now" 模块
  • T-046 - 添加 "Patterns & Recipes" 部分，包含 2 个以上命名模式

模块 07-plugins：完整深度处理

  • T-047 - 用真实场景重写导语
  • T-048 - 添加决策树（Mermaid）
  • T-049 - 添加 2 个以上 "Try It Now" 模块
  • T-050 - 添加 "Patterns & Recipes" 部分，包含 2 个以上命名模式

模块 09-advanced-features：完整深度处理

  • T-051 - 用真实场景重写导语
  • T-052 - 添加决策树（Mermaid）
  • T-053 - 添加 2 个以上 "Try It Now" 模块
  • T-054 - 添加 "Patterns & Recipes" 部分，包含 2 个以上命名模式

M3 检查点：全部 10 个模块完成且风格一致

第 4 阶段 - 代理层与跨模块（2026 年 9 月）

目标里程碑：M4

支柱 2：最终完成 AI 代理索引

  • T-055 - 使用所有 10 个完成的模块运行 scripts/build-agent-index.py

    • 生成最终版 agent-manifest.json，覆盖率达到 100%
    • 生成 AGENT-INDEX.md 并从 README.md 链接

  • T-056 - 创建 skills/claude-howto-lookup/SKILL.md

    • 读取 agent-manifest.json 以查找相关模块
    • 使用 Read 加载对应章节
    • 安装方式：cp -r claude-howto/skills/claude-howto-lookup ~/.claude/skills/

  • T-057 - 在 quickstart.sh 和 QUICKSTART.md 中把 lookup skill 作为可选功能提到

支柱 3b：跨模块 RECIPES.md

  • T-058 - 创建带有 5 个以上组合工作流的 RECIPES.md
    • 每个 recipe 的 schema：name、modules-used、problem、solution 代码块、expected outcome
    • 示例：skill + hook + subagent = 自动审查流水线
    • 确保所有主要标题都有 HTML 锚点，便于深链

支柱 5：社区展示

  • T-059 - 创建 COMMUNITY-PROJECTS.md
    • 静态 Markdown 页面，提交格式包括：name、description、link、features used
    • 包含模板条目
    • 提供基于 PR 的提交说明

M4 检查点：代理索引上线，recipes 上线，社区页面上线

第 5 阶段 - 版本审计与 recipe 扩展（2026 年 10 月 - 11 月）

目标里程碑：M5

  • T-060 - 进行完整版本审计：验证所有 10 个模块是否与当前 CC 版本匹配

    • 更新每个模块的 cc_version_verified frontmatter
    • 更新版本徽章

  • T-061 - 将 RECIPES.md 扩展到 8 个以上 recipes，基于社区实践模式

  • T-062 - 如果完成的模块中出现新的模式，则迭代 agent manifest schema

  • T-063 - 开一个置顶 GitHub Discussion："分享你的 Claude Code 工作流"

    • 收集真实 agent 使用信号，为后续 recipe 扩展提供依据

M5 检查点：所有模块都已验证当前版本，recipes 持续增长

第 6 阶段 - 组合与持续运行（2026 年 12 月 - 2027 年 3 月）

目标里程碑：M6

  • T-064 - 每次 CC 发布后运行 /docs-sync-claude-code skill；更新 WHATS-NEW.md

  • T-065 - 确保 agent manifest 覆盖 100% 模块（CI 回归测试）

  • T-066 - 将 RECIPES.md 扩展到 10 个以上 recipes

  • T-067 - 监控 COMMUNITY-PROJECTS.md 的自然增长；筛选新增条目

  • T-068 - 评估来自 GitHub Discussions 的 agent 使用信号；如果验证有效，就投入资源推广 lookup skill（营销、asm registry）

M6 检查点：系统已经可以自我维持

延后项（TODOS.md）

这些内容不在本计划范围内。请记录在这里，避免范围蔓延：

  • Skill marketplace / 可安装 registry
  • 自定义网站或仪表盘
  • 完成度追踪基础设施（cc-progress）
  • 带 CI 校验的社区教程模板
  • 自动生成的 CONTRIBUTORS.md
  • 多语言翻译
  • 测验 / 评估基础设施升级
  • COMMUNITY-PROJECTS.md 的社区投票 / 审核机制

按阶段划分的任务摘要

阶段 任务 时间段 涉及模块
1 - 基础设施与薄弱模块 T-001 到 T-020 2026 年 4 月 06-hooks、08-checkpoints + 基础设施
2 - 第一批深度处理 T-021 到 T-038 2026 年 5 月 - 6 月 01、02、03、10
3 - 第二批深度处理 T-039 到 T-054 2026 年 7 月 - 8 月 04、05、07、09
4 - 代理层与跨模块 T-055 到 T-059 2026 年 9 月 全部（manifest）+ 新文件
5 - 版本审计与 recipes T-060 到 T-063 2026 年 10 月 - 11 月 全部（审计）
6 - 持续运行 T-064 到 T-068 2026 年 12 月 - 2027 年 3 月 持续进行
Reference in New Issue View Git Blame Copy Permalink