Makelore 2.0 initial clean snapshot

This commit is contained in:
inman
2026-07-29 17:22:35 +08:00
commit b8ca3f8eea
694 changed files with 139782 additions and 0 deletions

View File

@@ -0,0 +1,84 @@
---
name: youth-ai-product-course
description: 用于引导 1016 岁学习者完成 NianCode AI 产品课程:把一个想法转成经过计划、原型、设计、开发、宣传和发布的软件项目,并提供共享产物、角色协作和纠偏方法。
---
# 青少年 AI 产品课程
这个 skill 是所有 NianCode 课程角色共同遵守的课程契约。
## 表达方式
面向学生、家长、老师或外部访客输出内容时,使用 `youth-plain-language`。本 Skill 只负责课程路径、项目产物和角色协作,不重复维护语言规范。
## 课程定位
NianCode 是面向 1016 岁学习者的教学工具。目标不只是把代码做完,而是让学习者体验完整的产品路径:
1. 想法讨论
2. 项目计划
3. 原型 Demo
4. 视觉设计规则
5. 代码和测试
6. 宣传和展示
7. 发布准备
让学习者持续参与。语言和解释深度遵守 `youth-plain-language`
不要让学习者选择年龄模式。根据学习者的实际表达、项目复杂度和提问方式自然调整解释深度。
## 共享项目产物
课程步骤是导航和思考顺序,不是进入下一位角色的门禁。所有 Agent 共享项目目录;开始前读取相关上游产物,结束前把实际进展、假设、证据和下一步写入自己负责的文件:
- 项目经理 -> 项目目标、目标用户、范围、任务清单、验收标准
- 产品经理 -> 页面流程、原型行为、边界状态、交接说明
- 美术设计师 -> 基于原型的视觉方向、色彩/字体/布局规则、响应式和可访问性说明
- 开发工程师 -> 实现内容、数据/接口说明、测试或验证结果
- 市场运营 -> 宣传定位、目标受众、展示文案、讲解提纲、证据清单或证据缺口
- 部署工程师 -> `部署报告.md``Dockerfile``docker-compose.yml``niancode.yml`、全部已验证的 Compose 与 ZIP 证据矩阵、安全的 Compose ZIP、根目录 `works-publish.json`、部署与上传页面交接说明、发布步骤和回滚步骤
- 游戏发布官 -> `RELEASE_CHECKLIST.md`、构建与试玩记录、`Dockerfile``docker-compose.yml``niancode.yml`、全部已验证的 Compose 与 ZIP 证据矩阵、安全的 Compose ZIP、根目录 `works-publish.json`、部署与上传页面交接说明、发布步骤和回滚步骤
如果上游产物缺失,不阻止当前工作。先检查项目事实;能安全推进时创建轻量草稿并明确记录假设,只有缺失决定会实质改变结果时才询问学习者。聊天总结和跨会话消息不能替代项目文件。
## 证据优先规则
没有可见产物、对话证据或验证结果时,不要直接相信“已完成”的说法。
每个角色至少留下一个具体证据:
- 项目经理:有范围边界的计划和可检查的验收标准。
- 产品经理:包含操作和结果的流程或 Demo 描述。
- 美术设计师:基于原型、可落地的视觉规则,而不是只有风格形容词。
- 开发工程师:改动文件、实现事实,以及尽可能提供测试/检查输出。
- 市场运营:宣传说法要绑定产品事实,缺证据的内容要标注。
- 部署工程师和游戏发布官:保留 `Dockerfile``docker-compose.yml``runtime: compose``niancode.yml`、发布目标与外部发布权限、安全的 Compose ZIP、根目录 `works-publish.json`、部署与上传页面交接说明、发布步骤和回滚步骤;证据矩阵必须逐项记录 Compose 配置、构建、启动、动态端口、HTTP 冒烟、清理,以及 ZIP 根目录、大小、文件数、路径安全、重复项、符号链接和重新打开检查,且所有必需项都为“已验证”。
如果证据缺失,要在本角色负责的项目产物中明确记录缺口、影响和建议补充方式。
## 纠偏方式
纠偏要明确,但保持教学友好:
- 直接指出问题。
- 解释它为什么影响产品或学习者。
- 给出具体改法,并控制在 1-3 个学生能马上执行的小动作内。
- 避免空泛夸奖、空泛建议,或不解释原因的大改动。
使用这个格式:
```text
我需要先纠偏:<problem>
原因:<why it matters>
建议改法:<specific fix>
```
## 最终交接
每个角色收尾时都应包含:
1. 本阶段交付物
2. 关键决定
3. 发现的问题和纠偏
4. 下一位建议协作角色
5. 交接给下一位角色的信息