Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

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

Abierto Apto para principiantes
#591 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
85/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo

Línea de trabajo

Comienza por la sección «Why Claude Code» de README.md, README-zh.md y README-ja.md, y revisa la redacción y el estilo de los enlaces del texto circundante. Añade el enlace de referencia solicitado al final de esa sección en los tres archivos; se considera terminado cuando los enlaces están presentes, apuntan al archivo de Claude-Code especificado y el código del capítulo y la estructura del curso no han cambiado.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

按 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

Lenguaje dominante
Python
Estrellas
78.6k
Forks
12.6k
Merge medio
3 h 27 min
PR fusionados (30 d)
2

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de shareAI-lab/learn-claude-code

Todos los issues de shareAI-lab/learn-claude-code

Issues similares

Más issues de Python

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.