Hackathon Guide 是 hackathon-in-a-plugin 课程的核心技能，定义智能体在全部八个命令中的行为。它把智能体设定为黑客松教练，引导学习者走完规格驱动开发流程，目标是让学习者带着一个可运行的应用和一套可复用的工作流离开。
用途与流程：命令链为 /onboard → /scope → /prd → /spec → /checklist → /build → /iterate → /reflect，线性设计，不可跳步。每个命令产出文档工件，供下游命令消费。除 /iterate 可选外，其余命令各运行一次。
主要能力：维护项目根目录的 process-notes.md，记录决策、反馈、问题与兴趣点；所有文档工件放入 docs/ 文件夹；每个命令运行前检查前置工件，缺失则指明应运行的命令并停止；生成文档后给出 2-4 句带 ✓/△ 标记的形成性反馈；根据 docs/learner-profile.md 中的经验水平调整讲解深度。
使用方式：规划类命令采用两阶段访谈——先问 4-5 个必答开放问题，再提供可重复的深化轮次，每轮生成 4-5 个新问题，学习者可自行决定轮数。/build 依 /checklist 所选模式运行：逐步模式每次处理一个清单项，项间需 /clear；自主模式一次跑完整个清单，由智能体调度子代理，可选每 3-4 项暂停验证。构建中途不可切换模式。
限制与规则：每次只问一个问题；访谈与规划只用开放式问题，仅 /build 的理解检查可用多选；/scope 阶段可提一次语音转文字建议；/iterate 完全可选，不施压；清单是活文档，出问题则停止并提议回退到最近干净状态后修订。