「Why Claude Code」缺一个可对照的参照物:学生搭完 nano harness 后无法验证真实 Claude Code 发了什么
メンテナーはふだん 15 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 85/100
- issue の種類
- ドキュメント
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
調査の方向性
README.md、README-zh.md、README-ja.md の「Why Claude Code」セクションから始め、周辺の文言とリンクのスタイルを確認してください。3つすべてのファイルで、そのセクションの末尾に要求された参照リンクを追加してください。リンクが存在し、指定された Claude-Code アーカイブを指しており、章のコードとコース構成が変更されていなければ完了です。
索引モデルが issue の本文から書いたものです。
説明
按 CONTRIBUTING 第 1 条,先开 issue 说清楚问题,再决定要不要发 PR。
问题
README 的「Why Claude Code」把 Claude Code 剥到本质,列了一串构件(agent loop + tools + skill 按需加载 + context compaction + subagent + task system + permission governance…)。17 课就是照着这张清单一节一节搭出来的。
但学生搭完之后,没有办法把自己的 nano harness 和真实的那一个对照——课程从头到尾没有出现过真实 Claude Code 实际发到模型的那段系统提示词和工具 schema。于是「Claude Code 是这么做的」这句话,学生只能信,不能验。
具体会卡在两处:
- s03_permission:真实 harness 的权限治理有多少是写在提示词里、多少是写在工具 schema 里?学生没有参照物,只能照课程的简化版理解。
- 入口差异:真实 Claude Code 从终端进和从 SDK 进,发的提示词和工具集并不一样——同模型同日,一边约 26k 字符 35 个工具,另一边约 21k 字符 29 个工具,连开头那句身份都改写了。这件事恰好印证课程反复强调的「Agent 产品 = 模型 + harness」:模型没变,harness 的入口变了,产品行为就变了。课程里没有地方能让学生看到这个。
想提的改动
在 README 的「Why Claude Code」那节末尾加一行参考链接,指向按产品分目录、带日期、带复现命令的系统提示词与工具 schema 实抓归档,让学生能自己跑一遍 diff:
一行,三语 README 同步(README.md / README-zh.md / README-ja.md),不动任何章节代码,不扩展课程结构。
两件要先说明白的
- 利益相关:这个归档由我所在的 Continuum AI 维护。所以我没有直接发 PR,先来问你们要不要——不要的话我就不发了,也不会再提。
- AI 协助:按 CONTRIBUTING 第 5 条声明,这条 issue 是我用 Claude Code 写的。上面两处数字(26k/35、21k/29)是我们自己从线上抓下来的实测,我核对过文件再写进来的,不是模型复述的。
另外看到 CONTRIBUTING 里「会直接关掉 agent 批量跨仓库开的 PR」那条——我这个账号最近确实在不少仓库提过东西,所以这条我主动摆出来:如果你们觉得这就是那一类,直接关掉就好,不用解释。
🤖 Generated with Claude Code
- 主要言語
- Python
- スター
- 79.5k
- フォーク
- 12.7k
- 平均マージ
- 11日 19時間
- マージ済み PR(30日)
- 5
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートなし
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
shareAI-lab/learn-claude-code のほかの issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
shareAI-lab/learn-claude-code#583 ·
メンテナーはふだん 15 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
shareAI-lab/learn-claude-code#528 ·
メンテナーはふだん 15 日以内に返信
-
s17: IDLE teammates cannot resume their own in-progress tasks対応中かも @hichipli が 59 日前に担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 84/100
shareAI-lab/learn-claude-code#519 ·
メンテナーはふだん 15 日以内に返信
-
s09: select_relevant_memories 的 "recent" 拼接顺序与切片不合理,不是真正的最近 2k 上下文対応中かも @siri666942 が 77 日前に担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
shareAI-lab/learn-claude-code#517 ·
メンテナーはふだん 15 日以内に返信
-
plan_approval_response 不会唤醒 idle teammate再び着手できるかも このイシューのプルリクエストはマージされずにクローズされました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
shareAI-lab/learn-claude-code#455 ·
メンテナーはふだん 15 日以内に返信
shareAI-lab/learn-claude-code の issue をすべて見る
似ている issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
Graphify-Labs/graphify#4860 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
:bug: Bug
難易度 2/5 1〜3時間 初心者へのやさしさ 84/100
scikit-image/scikit-image#8377 ·
メンテナーはふだん 1 日以内に返信
-
Ingredient import validation accepts negative nutrient values and NaN対応中かも @LukeSekai が今日担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
wger-project/wger#2564 ·
メンテナーはふだん 2 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
apache/ponymail-foal#351 ·
-
難易度 1/5 1時間未満 初心者へのやさしさ 68/100
メンテナーはふだん 4 日以内に返信