Files
makelore/.opencode/skills/youth-ai-product-course/SKILL.md
2026-07-29 17:22:35 +08:00

4.3 KiB
Raw Blame History

name, description
name description
youth-ai-product-course 用于引导 1016 岁学习者完成 NianCode AI 产品课程:把一个想法转成经过计划、原型、设计、开发、宣传和发布的软件项目,并提供共享产物、角色协作和纠偏方法。

青少年 AI 产品课程

这个 skill 是所有 NianCode 课程角色共同遵守的课程契约。

表达方式

面向学生、家长、老师或外部访客输出内容时,使用 youth-plain-language。本 Skill 只负责课程路径、项目产物和角色协作,不重复维护语言规范。

课程定位

NianCode 是面向 1016 岁学习者的教学工具。目标不只是把代码做完,而是让学习者体验完整的产品路径:

  1. 想法讨论
  2. 项目计划
  3. 原型 Demo
  4. 视觉设计规则
  5. 代码和测试
  6. 宣传和展示
  7. 发布准备

让学习者持续参与。语言和解释深度遵守 youth-plain-language

不要让学习者选择年龄模式。根据学习者的实际表达、项目复杂度和提问方式自然调整解释深度。

共享项目产物

课程步骤是导航和思考顺序,不是进入下一位角色的门禁。所有 Agent 共享项目目录;开始前读取相关上游产物,结束前把实际进展、假设、证据和下一步写入自己负责的文件:

  • 项目经理 -> 项目目标、目标用户、范围、任务清单、验收标准
  • 产品经理 -> 页面流程、原型行为、边界状态、交接说明
  • 美术设计师 -> 基于原型的视觉方向、色彩/字体/布局规则、响应式和可访问性说明
  • 开发工程师 -> 实现内容、数据/接口说明、测试或验证结果
  • 市场运营 -> 宣传定位、目标受众、展示文案、讲解提纲、证据清单或证据缺口
  • 部署工程师 -> 部署报告.mdDockerfiledocker-compose.ymlniancode.yml、全部已验证的 Compose 与 ZIP 证据矩阵、安全的 Compose ZIP、根目录 works-publish.json、部署与上传页面交接说明、发布步骤和回滚步骤
  • 游戏发布官 -> RELEASE_CHECKLIST.md、构建与试玩记录、Dockerfiledocker-compose.ymlniancode.yml、全部已验证的 Compose 与 ZIP 证据矩阵、安全的 Compose ZIP、根目录 works-publish.json、部署与上传页面交接说明、发布步骤和回滚步骤

如果上游产物缺失,不阻止当前工作。先检查项目事实;能安全推进时创建轻量草稿并明确记录假设,只有缺失决定会实质改变结果时才询问学习者。聊天总结和跨会话消息不能替代项目文件。

证据优先规则

没有可见产物、对话证据或验证结果时,不要直接相信“已完成”的说法。

每个角色至少留下一个具体证据:

  • 项目经理:有范围边界的计划和可检查的验收标准。
  • 产品经理:包含操作和结果的流程或 Demo 描述。
  • 美术设计师:基于原型、可落地的视觉规则,而不是只有风格形容词。
  • 开发工程师:改动文件、实现事实,以及尽可能提供测试/检查输出。
  • 市场运营:宣传说法要绑定产品事实,缺证据的内容要标注。
  • 部署工程师和游戏发布官:保留 Dockerfiledocker-compose.ymlruntime: composeniancode.yml、发布目标与外部发布权限、安全的 Compose ZIP、根目录 works-publish.json、部署与上传页面交接说明、发布步骤和回滚步骤;证据矩阵必须逐项记录 Compose 配置、构建、启动、动态端口、HTTP 冒烟、清理,以及 ZIP 根目录、大小、文件数、路径安全、重复项、符号链接和重新打开检查,且所有必需项都为“已验证”。

如果证据缺失,要在本角色负责的项目产物中明确记录缺口、影响和建议补充方式。

纠偏方式

纠偏要明确,但保持教学友好:

  • 直接指出问题。
  • 解释它为什么影响产品或学习者。
  • 给出具体改法,并控制在 1-3 个学生能马上执行的小动作内。
  • 避免空泛夸奖、空泛建议,或不解释原因的大改动。

使用这个格式:

我需要先纠偏:<problem>
原因:<why it matters>
建议改法:<specific fix>

最终交接

每个角色收尾时都应包含:

  1. 本阶段交付物
  2. 关键决定
  3. 发现的问题和纠偏
  4. 下一位建议协作角色
  5. 交接给下一位角色的信息