create 技能包

把一句人话需求（「我想做一个能记录读书笔记的应用」）变成具体要写的文件。 AIC 的扩展落在三个端上，每端有自己的持久化机制和交互协议——按端选内容物，别自造形态。

0. 三端速查

多数需求横跨多端（"带数据的应用" = 云端包 ＋ 界面页 ＋ 可选设备命令）。别只做一端就交。

1. 六步流程

① 拆需求 → 三端各要什么

先写一行清单并在回复里写出来：云端：… / 界面：… / 设备：…。 写不出来的那端 = 不做（最小交付）。判断归属：

• 关掉浏览器还在的 → 云端
• 用户看得见、点得到的 → 界面
• 要动用户自己电脑/手机的 → 设备
• 定时/周期执行 → 云端（平台的任务调度）

② 选内容物与落位

③ 动手前读对应分篇

只读你要动的那几端。字段名、约束、寻址方式都在分篇里，照抄比猜准。 需要向用户解释方案、或判断归属拿不准时，读 references/model.md。

④ 建容器（需要包时才做）

私有包目录默认只读。建行、授权、写文件是三件事，顺序不能反：

1. 建行：exec _host=page → curl /api/skills -X POST -H 'Content-Type: application/json' -d '{"name":"example"}' → 返回 skill_id 与 url_prefix，并落一份 SKILL.md 骨架
2. 授权：grant fs /skills/{skill_id}
3. 写文件：fs 工具写 /skills/{skill_id}/...（fs 路径，与页面 URL 不同段）
4. 写包根 manifest.json（schema 1）：页面清单进 ui.pages（页面 id → 包内 ui/<id>.html）；组件贡献进 ui.components，打开规则进 ui.openers；设备命令进 host。可复制 templates/skill/manifest.json。没有 ui.pages 的包不出 UI 徽标、 不进 launcher 子页面树；frontmatter 不承担这些声明。

⑤ 按该端的协议实现

• 云端：包内 API 一律相对地址（api/xxx，前缀自动补）；不写死 id。
• 界面：完整 HTML 文档（片段会静默不挂载）；页面清单同步写进包根 manifest.json 的 ui.pages；颜色字号一律用平台 token； 窗口宽度用 @container（不是 @media）；要让 AI 操作页面就声明 pageDesc.commands。
• 设备：参数走 stdin；只入库源码，构建产物与二进制不进包。

⑥ 验收

按 §4 的清单逐条验。没验证不算做完——尤其档案规则要看 profile inspect 的生效表与被拒清单。

2. 红线（违反会被平台拒绝或静默失效）

1. 档案规则的目标只能指向平台自带目录（/ai/ /os/ /page/ /layout/ /shared/ /widgets/ /assets/）； 档内禁 .. 段（不静默改写，直接报错）。
2. 外壳与管理页不可被替换（/os/ /layout/ /vb /page/admin——键和目标都算）。
3. 插槽片段必须纯结构：禁脚本、禁数据绑定、禁 iframe/内联 on*，且只放本人空间。
4. 只入库源码：二进制、构建产物、zip、密钥、用户数据一律不进容器。
5. 不硬编码平台地址：用相对路径与运行时前缀（$mod.scoped、url_prefix）。
6. 接口按用户隔离：每张表带 user_id，查询必须 user_id = :user_id。
7. 最小交付：不需要的界面/接口/数据/服务一律不加；只要一个界面就别建包。
8. 五个动作分开：建行、写文件、发布、装软件、授权，不能用一个代替另一个。

3. 平台动作速查

4. 验收清单

• 界面：能打开；资源无 404；亮/暗主题都正常；声明的页面命令能被 AI 调通。
• 数据：接口通；换账号看不到别人的数据；包内无真实用户数据。
• 档案：profile inspect 里 aliases/slots 在生效表；被拒项在 rejected 里可查；改 aliases/slots 后 reload 生效。
• 包：SKILL.md 可执行、引用完整；包内无二进制/密钥/用户数据；发布前自查过。
• 设备：源码在包内、产物不在；正文写全安装/依赖/路径/调用；设备上跑得通。

5. 分篇索引

模板在 templates/（技能包骨架、组件页、档案、服务声明），可复制参考的成品在 examples/。