「Why Claude Code」缺一个可对照的参照物：学生搭完 nano harness 后无法验证真实 Claude Code 发了什么

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#591 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 8 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
85/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Lĩnh vực
documentation

Hướng nghiên cứu

Bắt đầu từ phần “Why Claude Code” trong README.md, README-zh.md và README-ja.md, đồng thời xem xét cách diễn đạt và kiểu liên kết ở phần nội dung xung quanh. Thêm liên kết tham chiếu được yêu cầu vào cuối phần đó trong cả ba tệp; được coi là hoàn tất khi các liên kết đã có, trỏ đến kho lưu trữ Claude-Code được chỉ định, và mã chương cũng như cấu trúc khóa học không thay đổi.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

按 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 是这么做的」这句话，学生只能信，不能验。

具体会卡在两处：

  1. s03_permission：真实 harness 的权限治理有多少是写在提示词里、多少是写在工具 schema 里？学生没有参照物，只能照课程的简化版理解。
  2. 入口差异：真实 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

Ngôn ngữ chính
Python
Star
79.5k
Fork
12.7k
Merge trung bình
7 ngày 17 giờ
Pull request đã merge (30 ngày)
4

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của shareAI-lab/learn-claude-code

Tất cả issue của shareAI-lab/learn-claude-code

Issue tương tự

Thêm issue về Python

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.