1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | think-aloud-script-generator-garethmanning-education-agent-skills |
| 作者/维护者 | Gareth Manning（个人开发者、教育从业者，X: @worldteacherman） |
| 来源链接 | https://github.com/GarethManning/education-agent-skills/tree/main/skills/explicit-instruction/think-aloud-script-generator |
| 许可证 | CC BY-SA 4.0（Creative Commons 署名-相同方式共享，数据来自仓库 LICENSE 原文） |
| GitHub Stars | 546（数据来自 GitHub API，为所属合集仓库整体数字，不代表本技能个体热度） |
| Forks | 91（同上，合集整体数字） |
| 最新版本 | SKILL.md 内声明 version 1.0 |
| 安装方式 | 多渠道：Claude 插件一条命令安装、手动复制技能目录、Codex 本地插件市场或单技能复制、Hermes Agent 一条命令安装（详见第 10 章） |
| 项目自述名称 | 仓库标题为「Education Agent Skills Library」，本技能在库内条目名为 “Think-Aloud Script Generator” |
数据来源标注：Stars/Forks/License/最近推送时间来自 GitHub API；功能描述、安装方式来自 SKILL.md 与仓库 README。
2. 功能介绍与亮点
该技能为教师生成一份完整的“出声思考”（think-aloud）课堂脚本，把专家完成某项任务（解题、写作、阅读理解、史料分析等）时高度自动化、难以言说的思维过程，转化为可直接照读、结构化的教学语言。
核心设计基于认知学徒制（Cognitive Apprenticeship）与“专家盲点”（expert blind spot）研究：专家的思维已高度内化，往往说不清中间步骤，而新手恰恰需要看到这些步骤。技能的证据基础包含五篇具名学术引用——Bereiter & Scardamalia（1987，写作认知过程）、Wilhelm（2001，阅读理解出声思考）、Ericsson & Simon（1993，有声思维报告的理论基础）、Collins et al.（1989，认知学徒制）、Rosenshine（2012，有效教学十原则之“示范”）。
主要亮点：
- 产出即成品：输出是可直接照读的完整脚本（含开场设定、正文、暂停检查点、授课注意事项），而非仅供参考的设计说明，教师无需二次加工即可使用。
- 附完整实操示例：以雪莱《奥兹曼迪亚斯》一诗的完整分析过程为例，展示脚本从“读第一遍的整体印象”到“发现反讽主旨”的真实思维轨迹，含刻意保留的困惑与自我修正。
- 附“已知局限”章节：坦承脚本非提词器（需教师内化后用自己的语言表达）、需保持简短（8–12 分钟内）并配合后续引导练习、“专家盲点”仍可能残留等局限，而非只讲优点。
- 与库内其他技能声明联动：SKILL.md 的
chains_well_with字段列出可组合使用的相邻技能（如 explicit-instruction-sequence-builder、metacognitive-prompt-library），体现该合集内部方法论的整体设计。
3. 适用场景
所属固定分类：内容创作与知识管理。
适用于任何需要向学生显式示范专家思维过程的学科教学场景：阅读理解策略示范、多步骤数学解题、历史证据评估、议论文写作过程建模等。受益人群为 K12 至高等教育阶段的一线教师、教学设计师与师训人员——尤其是需要在课堂上“让学生看见我是怎么想的”而非“直接给出答案”的教学环节。
4. 跨 Agent 兼容性
- Claude Code：原生支持。仓库提供
claude plugin install <仓库地址>一条命令安装整个技能库，也可手动将该技能目录复制进 Claude 的 skills 目录单独使用。 - Codex：原生支持。README 提供本地插件市场安装（
codex plugin marketplace add）与单技能复制两种路径，复制命令为cp -r skills/explicit-instruction/think-aloud-script-generator ~/.codex/skills/。 - Hermes Agent：原生支持。
hermes skills tap add GarethManning/education-agent-skills后，用hermes skills install GarethManning/education-agent-skills/skills/explicit-instruction/think-aloud-script-generator --category education --yes单独安装本技能。 - OpenClaw：未验证——已抓取的 README 与 SKILL.md 均未提及 OpenClaw，未见对应安装路径。
5. 推荐理由
它把认知科学中公认有效、但教师日常备课很难独立设计好的“出声思考示范”教学法，转化为一份可直接照读的完整脚本，显著降低了这项技术的准备门槛。五篇学术引用与“strong”证据强度标注保证了方法论的可靠性，而“产出即成品、无需教师二次制作”的设计，让它比同类只给设计建议的技能更容易在课堂上立刻用起来。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 5 | 所属合集仓库整体 546 stars；该数字属整个合集，不代表本技能自身热度。该子技能本身未见独立第三方评价、引用或讨论 |
| 可用性 | 9 | 无需安装依赖或 API key，复制 SKILL.md 或一条命令即可安装；文档完整，含结构化输入输出定义、完整实操示例与已知局限说明；所属仓库最近一次推送在近日内，维护活跃；产出为可直接使用的完整脚本，无需教师二次制作 |
| 安全性 | 10 | 纯提示词模板类技能，不含可执行脚本，无网络外发，无需任何凭据；开源可审计（CC BY-SA 4.0）；作者身份公开可查，无造假迹象；第三方平台 SkillsLLM 对所属仓库的自动化安全扫描（2026-05-30）未发现高危问题 |
| 综合 | 8.0 | 三项均值 |
安全检查清单：
- Shell 命令及权限：无，纯文本提示词，不含可执行脚本
- 联网外发：无，内容完全在对话上下文内生成
- API key/凭据：无需
- 可疑指令：未见 prompt injection 或隐蔽指令迹象
- 作者/组织信誉：个人开发者身份公开可查，无造假迹象
- License：明确（CC BY-SA 4.0）
- 最近维护：所属仓库近日仍有提交，非弃置项目
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| dual-coding-designer（同合集姊妹技能） | 为一段口头讲解设计配套视觉呈现方案 | 产出是一份“设计说明”，教师仍需自行用白板、PPT 或 Canva 等工具把说明变成实际图像；本技能产出的是可直接照读的完整脚本，中间不再需要额外制作步骤 |
| anthropics/k12-teacher-skills（k12-lesson-planning / k12-lesson-differentiation） | Anthropic 官方出品的 K12 教师工具，聚焦课程规划与差异化教学 | 覆盖的教学环节不同——官方产品线服务备课与教学调整，不含课堂讲授中的专家思维显式示范；两者服务不同教学阶段，互补而非直接竞争 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；所属合集在 SkillsLLM 收录页的评论区同样显示暂无评论。所属合集通过了 SkillsLLM 的自动化安全扫描（2026-05-30），未发现高危问题。
9. 其他补充
SKILL.md 采用 Agent Skills 标准 v2 的统一字段格式（disable-model-invocation、user-invocable、input_schema、output_schema 等），与所属合集内其余 164 个技能共享同一结构，便于跨技能组合调用。仓库文档另提供中文之外的完整英文版 SKILL.md 与 README，暂未见其他语言版本。
10. 安装使用方式
- Claude Code CLI（整库安装）：
claude plugin install https://github.com/GarethManning/education-agent-skills - 手动安装（任意支持 Agent Skills 标准的工具，含 Claude Code 单技能安装）：将仓库中
skills/explicit-instruction/think-aloud-script-generator/整个目录复制进本地 agent 的 skills 目录。 - Codex：
cp -r skills/explicit-instruction/think-aloud-script-generator ~/.codex/skills/ - Hermes Agent：
hermes skills tap add GarethManning/education-agent-skills hermes skills install GarethManning/education-agent-skills/skills/explicit-instruction/think-aloud-script-generator --category education --yes - 纯手动方式：直接打开该技能的 SKILL.md，复制其中的 Prompt 代码块，粘贴进任意 AI 对话并填入任务、学生水平、学科三项必填信息即可使用。
安装后无需重启或额外配置；技能通过描述中的触发词（如“think-aloud”“modelling”“demonstrate reasoning”）自动被识别调用，也可直接手动指名使用。
11. 注意事项
- 脚本设计为教师内化后用自己的语言表达，不建议逐字照读，否则会显得生硬、失去示范效果。
- 单次出声思考建议控制在 8–12 分钟内，需配合互动暂停点与后续独立练习，否则容易变成学生被动听讲的独白。
- “专家盲点”问题无法被脚本完全消除——即便有脚本，教师仍可能无意中跳过对自己而言显而易见、但对学生而言陌生的步骤，建议示范后请学生反馈是否有跟不上的地方。
- 该技能来自个人开发者维护的开源合集，非机构或厂商第一方出品，长期维护延续性需自行关注仓库动态。