一、④段整套同步(用户选候选 A)
- 新增 `references/stage-proto-doc/assets/产品文档模板.html`(16 KB/247 行,从备份拷、转 LF)。
- ④段 SKILL.md 换成备份 15:28 那版,并按模板口径改齐:
· 「产品文档框架」从「四块+一附录」改成**六节** —— 页面结构/功能清单/使用场景/操作流程/
跨页与界面状态/待确认与偏离;与模板同构,⛔ 不从空白页重写结构。
· 编号从 R/S/F 改成 **P 页面/S 场景/F 功能/J 二级功能**,各自唯一、按展示顺序通排。
· 保留旧版有价值的要求:每项功能补齐 做什么/入口在哪/输入边界/异常与恢复;重点功能三处标红;
横向流程图每步写清页面/功能/操作/完成判据。
· 完成标准「七节」→「六节」,自查清单同步换掉「需求」那批条目,补模板与配图两条。
· 路径 `designs/<项目>/` → `docs/pm/<项目>/ui/`(2 处)。
· 补回本机那条「每份产出文档开头都要有一张图」的引用(指向主 skill,段内不复述)。
- 主 skill 同步:四段结构表④行、④段沿革、画图小节(④段画页面结构图 + 用户路径)。
二、open-design 移到技能根(用户选候选 A)
- `git mv product-planning/references/stage-delivery/assets/open-design → open-design/`(4178 文件)。
- `.gitignore` 白名单加 `!/open-design/` —— 否则移出去就不再纳入版本控制。
- 引用改 11 处:路径形态 `assets/open-design/...` → `<技能根>/open-design/...`;
「随段携带的自带件」改称「同根技能」;「路径怎么找」那条改成自带件(段内相对路径)与
同根技能(`<技能根>/<技能名>/`)两类分开写。
- open-design 自己的 ATTRIBUTION.md 两处同步(它现在与 oil-ui-pro 同层)。
- 副作用(有益):命名闸门读数由 2063 降到 225 —— 此前它把 open-design 里 919 个第三方 md
当成规则一起扫了;现在只扫本包 23 个 md。已确认④段的 H1 与 4a/4b/4c 子步仍在检查范围内。
三、验收
- check_naming.py --ws E:/ProgramData/AIProject/contentm_agent = 通过 225 / 失败 0 / 提示 27。
- 活文件里 `assets/open-design` 残留 0;工作区 CRLF 文件 0。
35 lines
1.7 KiB
Markdown
35 lines
1.7 KiB
Markdown
# 署名与来源 · open-design(同根技能,可选使用)
|
||
|
||
本目录是第三方技能 `open-design` 的**本地裁剪副本**,2026-10-15 起装在**技能根**下的 `open-design/`,与 `oil-ui-pro` 同层、按 `<技能根>/open-design/` 引用(此前随 `stage-delivery`(③段)携带)。它属可选件 —— 不选它,③段照样能走完。
|
||
|
||
## 来源
|
||
|
||
1、上游仓库:`nexu-io/open-design`
|
||
2、上游版本:`0.23.1`
|
||
3、本副本版本标记:`0.23.1-crop1`(见本目录 `SKILL.md` 的 `metadata.version`)
|
||
4、收录方式:本地裁剪后逐个文件搬入,不改写已搬入文件的内容
|
||
|
||
## 许可
|
||
|
||
1、许可类型:Apache-2.0
|
||
2、署名要求:Apache-2.0 要求保留许可与版权声明
|
||
3、🔴 现存缺口:本目录**未随附 Apache-2.0 的 LICENSE 全文**,也没有上游的 NOTICE 文件(2026-10-08 记账)
|
||
|
||
## 与外部技能仓库的关系
|
||
|
||
1、本副本放在**技能根**下的 `open-design/`,按**同根技能**引用(`<技能根>/open-design/...`)
|
||
2、它与 `oil-ui-pro` 同层,可选使用;③段不选它时走默认主线
|
||
3、③段另有自带件 `assets/design-systems/design-system-tiaoyue`(本段自带样式库)
|
||
|
||
## 提供什么
|
||
|
||
1、`design-systems/`:153 套设计系统,给「定调与令牌」
|
||
2、`craft/`:13 份工艺判据(字体 / 配色 / 动效 / 状态 / 无障碍 / 反 AI 味)
|
||
3、`design-templates/`:35 个版式骨架模板
|
||
|
||
## 使用口径
|
||
|
||
1、③段的**默认主线是 `oil-ui-pro`** 加本段自带样式库,不是本件
|
||
2、本件只作补强:多一路定调候选、多一套工艺数值判据
|
||
3、⛔ 每次设计只选一套定调来源,不许与 `assets/design-systems/` 混用
|