用途
2-scope 是 learn-ai-basics 课程中的第二个技能,目标是帮助学习者找到或打磨项目想法,并写出范围文档(scope doc)。它是课程中第一个真正的教学时刻:通过一次聚焦、自适应的一对一访谈,示范“翻转式互动”(flipped interaction),让学习者练习向智能体提供丰富上下文,而不是只给一句提示词。对话本身是价值所在,文档只是留下的产物。
主要能力
- 定位当前进度:先查看项目的 devpost/ 目录,列出 learner-profile.md、scope.md、prd.md、spec.md、checklist.md 中哪些已存在,并读取各自 frontmatter 中的 status 行。只以项目产物为准,不根据对话记忆推断进度;不把 skills/ 下的文件、模板示例或空/占位副本当作学习者进度。
- 路由:没有 learner-profile.md 时提示先运行 1-start 并停止;没有 scope.md 时从头开始;scope.md 状态为 draft 时读回并询问是继续还是重做;状态为 approved 时说明并指向 3-prd,除非学习者想重新打开。
- 读取学习者画像:从 devpost/learner-profile.md 获取初始想法、技术与智能体经验、规划工作流经验、协作与沟通偏好、期望学习成果、兴趣与灵感,以及学习者希望自主掌控的领域。
- 访谈:默认一次问一个问题,也可按偏好小批量提问;始终自由作答,不使用多选题工具。围绕头脑风暴、补齐缺口、找到核心亮点、定义“完成”的样子、做减法等环节展开,通常约四到五次有意义的交流。
- 写出范围文档:读取本技能相对的 templates/scope-template.md,根据对话填写为 devpost/scope.md,状态先为 draft,并立即保存。文档应像是对学习者原话的提炼,而非填表;保持简短,功能、界面和行为属于 PRD。
- 评审:查看 learner-profile.md 中的 Review Format。若未设置,询问希望以 Markdown 还是同时以可视化 HTML 页面评审。HTML 版本创建为 devpost/scope.html,包含连接用户、核心循环与证明的有意义图示(Mermaid 或内联 SVG),以及 now/later/cut 的结构化展示;不使用框架或构建步骤,保持 Markdown 为权威版本,修订后重新生成。
- 批准:学习者明确认可(“looks good”即算)后,将状态置为 approved,不要求第二次签字。
使用方式
技能会先设定框架(两三句话说明范围是什么、为何重要,并建议使用语音转文字),然后开始访谈。访谈的节拍包括:
- 头脑风暴——课程中最重要的问题。让学习者把想法全部倒出来,不要求组织。若还没有想法,则根据画像做发现式提问,帮助找到一个微小实验。
- 补齐缺口——针对头脑风暴中薄弱之处提问,只问真实缺口。
- 找到核心亮点——识别想法中独特之处,例如一个会因你过去的借口而让你内疚的待办应用。
- 定义“完成”——具体说明“能用”是什么样子:有人打开什么、做什么、看到什么能证明它有效。提醒黑客松要求:提交需要简短演示视频和公开 GitHub 仓库,整体目标为 2–4 小时活跃工作,部署可选。
- 做减法——必要时按 now、later、cut 分类,保护概念验证范围。
当就绪标准(目标用户、核心循环、成功证明、PoC 边界)满足后,直接起草供评审,不请求写文档的许可。若学习者仍在探索,约四到五次交流后询问一次是继续探索还是写出来评审。
适用场景
适用于参与 learn-ai-basics 课程、需要确定或打磨黑客松项目想法并产出范围文档的学习者。尤其适合希望练习主动、有意图协作,而非让 AI 代劳决策的人。
限制
- 不根据对话记忆推断进度,只以项目产物为准。
- 不编造学习者的意图;只有在关键问题得到回答后,AI 才可撰写规划文档。
- 若学习者说“直接帮我做”,应解释主动协作更有用,然后问一个更小的具体问题,不接管。
- 不使用多选题工具,始终自由作答。
- 不生成 HTML 构建清单,HTML 仅用于规划评审。
- 不要求第二次仪式性签字,不把批准当作肤浅,不要求批评,不添加遗憾/损失类问题。
- 关于收费、价格、平台等具体信息,资料中暂未提供。