Community写作与编辑github.com

steffen74/draft-unit

根据课程大纲起草单个单元的教学资源(讲师授课计划、学员页面、模板或代码变更),先规划学习者路径再填充内容。在命令后指定单元。

draft-unit 是什么?

该技能用于基于现有课程文档起草单个教学单元的全部资源。它首先要求用户明确单元编号,然后读取`COURSE-CANVAS.md`、`PLAN.md`、`PERSONAS.md`、`RESOURCES.md`、`DECISIONS.md`以及前一单元的资料,以确保与课程现有结构和风格保持一致。核心工作流分为三步:1) 先编写学习者路径(learner path)——这是学员从打开页面到提交成果的步骤清单,每个步骤需明确所需资源及其来源,并检查知识缺口;2) 根据`RESOURCES.md`的要求起草讲师授课计划、学员页面、模板或代码等资源,其中计算示例答案时必须实际运行代码而非凭记忆;3) 展示草稿并列出关键决策点和不确定之处,供讲师修改批准。所有影响其他单元的决策需记录在`DECISIONS.md`中。完成的标准是讲师批准草稿且`RESOURCES.md`将该单元标记为*draft*。该技能主要适用于Claude Code等支持skill机制的AI编码助手,尤其适合具有结构化课程开发流程的技术培训或编码课程项目。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steffen74/agentic-course-creation/tree/HEAD/skills/draft-unit

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

起草一个单元

起草单个单元的资源。读取 COURSE-CANVAS.md、PLAN.md、PERSONAS.md、RESOURCES.md、DECISIONS.md 以及前一单元的资料。使用课程文件现有的结构(标题、表格、语气);如果课程尚无结构,则提出一个并等待确认。

1. 先编写路径

在任何内容之前,在会话文件的讲师笔记中为单元编写 学习者路径,作为编号列表:学员从打开学员页面到提交成果的每一步,每一步需包含

  • 他们需要什么(概念、工具、文件、链接、账户)以及该需求来自何处(边界、前一单元、本页面),
  • 他们可以看到的预期结果。

加载 assumed-knowledge。如果某步的需求没有来源,则存在缺口:立即通过添加步骤、链接或解释来解决,或者将其交给讲师。展示路径并等待确认;这是检查材料所依据的规格。

2. 起草

根据 RESOURCES.md 起草单元所需的内容,每个部分放在各自位置:

  • 讲师:包含时间安排、输入、小组作业、示例答案和讨论要点的授课计划。将输入块写为内容(主张、数字、示例),并考虑讲师笔记;幻灯片之后由 /to-slides 据此构建。
  • 学员:目标、任务、交付物、附带长度的材料。加载 learner-instructions。
  • 模板或代码:任务所依赖的笔记本、数据、配置。

通过运行课程数据上的代码来计算示例答案,绝不能凭记忆。引用数字时应说明其计算方式。

3. 停止点

展示草稿,并附上你做出的选择(任务措辞、使用哪个视频、有多少是可选的)以及你感到不确定的内容。讲师编辑或批准。将影响其他单元的选择记录在 DECISIONS.md 中。

当讲师批准草稿且 RESOURCES.md 将该单元列为 draft 时完成。如果会话包含输入块,建议使用 /to-slides <unit>,然后使用 /walk-through <unit>;在此技能中,永远不要将单元标记为 released。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相关技能