feat: 19-chapter docs quality overhaul — CC source-verified, beginner-friendly#265
Open
Bill-Billion wants to merge 7 commits intoshareAI-lab:mainfrom
Open
feat: 19-chapter docs quality overhaul — CC source-verified, beginner-friendly#265Bill-Billion wants to merge 7 commits intoshareAI-lab:mainfrom
Bill-Billion wants to merge 7 commits intoshareAI-lab:mainfrom
Conversation
…-friendly 全面重写 19 章教学文档，基于 CC 源码逐项验证，统一叙事骨架。 核心变更： - 19 章从 s01 Agent Loop 到 s19 MCP Plugin，5 阶段递进 - 每章统一骨架：痛点 → 核心思路 → 机制展开 → 速查 → 试一下 → 接下来 - 30 个 Explore Agent 调用，覆盖 80+ CC 源码文件，行号精确定位 - 10 张 SVG 流程图（s01/s02/s03/s08×4/s09/s15/s19） - 复杂章用 <details> 折叠 CC 源码对照，主线保持 100-280 行 - 17 岁友好：术语就地定义，无内部工程术语，叙事驱动 - README 总入口含 19 章地图和 5 阶段划分 Co-Authored-By: Claude Opus 4.7 <[email protected]>
|
@Bill-Billion is attempting to deploy a commit to the crazyboym's projects Team on Vercel. A member of the Team first needs to authorize it. |
Rename h3 headings from 痛→修法→还剩什么 to 问题→解法→然后呢 for more natural, conversational flow matching s01's narrative voice. Apply the layered h3 structure to s03 (3 gates), s09 (3 subsystems), and s11 (3 recovery paths) — previously only s08 used this pattern. Co-Authored-By: Claude Opus 4.7 <[email protected]>
Previously only s01 and s08 had links; now all s01-s19 are clickable. Co-Authored-By: Claude Opus 4.7 <[email protected]>
Update chapter count (12→19), motto list, stage table, chapter links, project structure, and quick start paths in both README-zh.md and README-ja.md to match the new 19-chapter format. Co-Authored-By: Claude Opus 4.7 <[email protected]>
…vious Rewrite all 19 code.py files to show explicit "在 sXX 基础上新增" lineage: - Docstring states which chapter this builds on and what was added - Visual markers (═══ FROM sXX / NEW in sYY ═══) separate inherited from new code - agent_loop comments show exact line changes from previous chapter - Print message at startup tells reader which chapter they're extending This restores the "incremental optimization" soul that made the original agents/s01-s12 version feel like a coherent step-by-step build, rather than 19 disconnected standalone chapters. s01-s04: Full cumulative code with markers s05-s08: Cumulative code with markers (compact for later chapters) s09-s19: Incremental docstrings + agent_loop with change annotations Co-Authored-By: Claude Opus 4.7 <[email protected]>
Each chapter (s02-s19) now has a "相对 sXX 的变更" table showing exactly what was added compared to the previous chapter — new tools, new functions, new data structures, and agent_loop changes. This restores the incremental "diff" feel from the original docs/ version, where readers could see at a glance "what did this chapter add?" without comparing code files. Co-Authored-By: Claude Opus 4.7 <[email protected]>
- Add "相对 s07 的变更" table - Remove duplicate paragraph in "接下来" section Co-Authored-By: Claude Opus 4.7 <[email protected]>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
全面重写 19 章教学文档，基于 CC 源码逐项验证，统一叙事骨架：
<details>折叠中有精确函数名、行号和常量值Key design decisions
<details>，不污染教学主线Test plan
🤖 Generated with Claude Code