一、④段整套同步(用户选候选 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。
98 lines
5.2 KiB
Plaintext
98 lines
5.2 KiB
Plaintext
# ══════════════════════════════════════════════════════════════════════════
|
||
# 🔴🔴 白名单:本仓**只收录对外发布的那几个技能**(用户 2026-10-09 令:「肯定要收回」)
|
||
# 写法=先把根下一律挡掉(`/*`),再逐个放行。⛔ 这样"新冒出来的技能目录"
|
||
# 不会被任何 `git add -A` 顺手捎进仓库 —— 2026-10-08 那 9 个就是这么混进来的。
|
||
# 本轮从索引撤出(**本地文件一律保留**):AI HOT、draw-ui、dsh-diagnose、dsh-knowledge、
|
||
# dsh-local-env、dsh-opensource-release、dsh-workflow、oil-motion、skills-security-check
|
||
# ⚠️ 保留 oil-ui-pro:它是 product-planning 第③段的**功能依赖**(撤了两边都会悬空)。
|
||
# ══════════════════════════════════════════════════════════════════════════
|
||
/*
|
||
!/.gitignore
|
||
# 🔴 2026-10-14 加:行尾符策略文件。它跟 `.gitignore` 一样是**仓级规则**,必须入库 ——
|
||
# ⛔ 不入库的话别的机器取仓后仍按各自 `core.autocrlf` 各行其是,本仓的行尾符约定形同虚设。
|
||
!/.gitattributes
|
||
!/改包纪律.md
|
||
!/browser-harness/
|
||
!/humanizer/
|
||
!/oil-ui-pro/
|
||
!/open-design/
|
||
!/product-planning/
|
||
!/session-mechanism/
|
||
# 🔴 2026-10-12 加(用户当轮令「可以加入」):新建的全局技能 `video-capture`(取视频 + 抽帧)要入库。
|
||
# 判据=product-planning 第③段已把它当**依赖**引用(交接说明指向它)⇒ 仓里有引用、仓里就该有实体;
|
||
# ⛔ 否则别的机器从本仓还原会拿到一个「指向装不出来的技能」的悬空引用。
|
||
# ⚠️ 它目录内的 `env/`、`logs/` 仍被下面那几条本机配置规则挡着 —— 那部分照旧各机器自建。
|
||
!/video-capture/
|
||
|
||
# 🔴 不入库:运行期产物与备份
|
||
# 判据(记忆铁律):技能包=**可复制的资产**;⛔ 运行日志/缓存/备份/本机部署副本一律不入库。
|
||
|
||
# 运行日志(install.py 每次跑都写)
|
||
*.log
|
||
install.log
|
||
*_collabd.log
|
||
# 缓存
|
||
__pycache__/
|
||
*.pyc
|
||
*.pyo
|
||
# 备份(⛔ 备份不是资产,是历史)
|
||
*.bak-*
|
||
*.bak
|
||
*.orig
|
||
*.rej
|
||
*.mutbak
|
||
# 编辑器
|
||
.DS_Store
|
||
Thumbs.db
|
||
*.swp
|
||
*~
|
||
|
||
# 🔴 2026-10-09 改(用户令:「A 肯定要收回」+「别的电脑取仓时不要影响已有文件」):
|
||
# 下面两份是 **install.py 在本机生成**的 ⇒ ⛔ 撤出仓库、改为本机各自生成。
|
||
# 为什么必须撤(实测):别的电脑取仓时「同名覆盖」会把它们换成**我们这台机器**的路径
|
||
# ⇒ 那台机器的机制脚本会去找不存在的目录(`roots.env` 里就是本机绝对路径)。
|
||
session-mechanism/references/manifest.md
|
||
|
||
# 🔴🔴 2026-10-11 加(用户令:「脚本是脚本 配置是配置」⇒「**每个技能 需要环境配置的 都有自己的 env文件夹**」):
|
||
# **每台机器各不同**的配置一律放**该技能包自己的 `env/`**;`scripts/` 只留通用代码。
|
||
# 本仓收录的每个技能 —— 其 `env/` 下**只入库 `*.example` 样例**,真配置一律本机生成、不入库
|
||
# (理由同上面那条:入库 ⇒ 别的电脑取仓时被本机路径覆盖 ⇒ 机制去找不存在的目录)。
|
||
# ⚠️ 三行三种层级都写,避免"某个深度漏挡"(`**/env/*` 覆盖任意层,另两行是它的保守冗余)。
|
||
env/*
|
||
!env/*.example
|
||
*/env/*
|
||
!*/env/*.example
|
||
**/env/*
|
||
!**/env/*.example
|
||
# 兼容旧位置(2026-10-11 之前的布局):包根那份 `roots.env` 也是本机真身 ⇒ 同样不许入库。
|
||
# ⚠️ `roots.env` 不带斜杠 ⇒ 按**文件名**匹配任意层级,正好把「包根旧位置」一并兜住。
|
||
roots.env
|
||
|
||
# 📌 刻意**入库**的(⛔ 别误删):
|
||
# assets/*.png —— 文档配图,是内容不是产物
|
||
|
||
# 🔴 凭据类一律不入库(2026-10-06 发现「当前版本仍跟踪」)
|
||
.neodata_token
|
||
|
||
# 🔴 2026-10-07 补(本目录改成 git 工作区后新增,按实测盘点)
|
||
# 运行期目录(session-mechanism/logs 里是钩子日志,不是资产)
|
||
logs/
|
||
tmp/
|
||
# 机制运行时写的**域锁目录**(handoff-guard 的 `.locks`)—— 运行时产物,⛔ 不入库
|
||
# ⚠️ 用 `**/` 兜两种落点:脚本在 `<技能包>/scripts/` 时 ROOT 算成 `<技能包>` ⇒ 是
|
||
# `<技能包>/05-交接单/`;脚本被整体拷到别处时也可能落成 `<技能包>/scripts/05-交接单/`。
|
||
# ⚠️ 与**文档库仓**的同名目录不冲突:那边的 `05-交接单/` 是锁根、**要**入库,本规则只在本仓生效。
|
||
**/05-交接单/
|
||
# 宿主写的技能库迁移标记(每次启动可能重写,⛔ 不是内容)
|
||
.disable_to_model_invocation_migration.json
|
||
.model_invocation_to_override_migration.json
|
||
.user_invocable_only_to_off_migration.json
|
||
_bm_skillid_migration.json
|
||
# 本机虚拟环境与构建产物(browser-harness 等)
|
||
.venv/
|
||
*.egg-info/
|
||
uv.lock
|
||
node_modules/
|
||
# 本机部署副本与状态(`.workbuddy/` 是**工作区**的东西,⛔ 不该出现在技能库)
|
||
.workbuddy/
|