42 lines
6.2 KiB
Markdown
42 lines
6.2 KiB
Markdown
|
# 2026-09-14
|
|||
|
|
|
|||
|
|
## 按《技能审计检查清单》审计 V1.0（链路层优先，只审不改）
|
|||
|
|
|
|||
|
|
- **范围确认（先问后做）**：工作区里真正的「技能」只有 `project/短视频脚本创作/` 下的 V1.0 与 Lite1.0（另两个项目目录无 SKILL.md）。用户选定 **V1.0 全量（含 6 子技能）+ 链路层优先** 深度。
|
|||
|
|
- **方法**：① 机械化交叉验证（自建只读脚本 `tools/_audit_scan.py` → `tools/_audit_scan.txt`：md 相对链接断链校验 / 6 类硬编码扫描 / 术语与编号分布）② 权威源精读（SKILL.md、创作流程规范.md、规则/概念分层与源头表述规范.md、索引_知识素材库.md、创作流程 5/6/7/10、子技能 SKILL.md 与 mcn-work-shop 契约文档）。
|
|||
|
|
- **产出**：`技能审计报告_V1.0_20260914.md`（仓库根）。结论 **P0=0 / P1=8 / P2=7**。
|
|||
|
|
|
|||
|
|
### ★本次新发现（可复用线索）
|
|||
|
|
1. **S6→S7 断链（P1）**：`7_生成短视频大纲.md:31` 说"从 S6 场次结构表取模板骨架（模板A/B）"，但 `6_生成短视频框架.md:280` 明文"模板A/B 仅供知识参考，非执行指令，S6 不选模板" → 下游假设的上游字段不存在。
|
|||
|
|
2. **工作台入口契约表漏 2 入口（P1）**：契约表只登记 CREATE/EXTRACT/STORYBOARD/REVIEW（L127），实际 `data-pages.js` 还有 `SKILL_HINT_ANALYZE`（L1307 功能四账号数据分析）与 `SKILL_HINT_VIDEO_PARSE`（L1728 功能五视频解析/刷新）→ SKILL.md 第 7 条 P0 的"入口必守契约"护栏本身有漏。
|
|||
|
|
3. **交付门禁口径相反（P1）**：`创作流程规范.md:97`「八类35项自检 = 交付前强制、一票否决」vs `SKILL.md:296-298`「S11 为可选质检、由用户决定」——承载清单的就是 S11。
|
|||
|
|
4. **钩子家族术语未覆盖改名（P1）**：09-07 概念分层规范要求统一总称「开场钩子」，但仍有 `开篇钩子`(S5 L187)、`钩子预设`(SKILL.md L223)、`钩子策略`(S5 L229/255/294/411)。
|
|||
|
|
5. **`创作流程规范.md:406` 旧技能名「脚本创作技能/」残留 + L408 单字符乱码**。
|
|||
|
|
6. **dou-analysis 侧 dsh 死分支未随 09-10 下线（P1，4 处活规则）**：SKILL.md:160、feature/05_解析视频.md:55、接口调用/本地接口调用规范.md（整份）、铁律避坑规则/账号设定执行避坑.md:25。→ 09-10 只清了主技能与路径判定层。
|
|||
|
|
7. **「dsh 已下线」历史叙述清理不彻底（P1）**：SKILL.md:78、dou-analysis SKILL.md:42、references/路径配置.md:15+28、浏览器搜索抖音账号操作规范.md:175（同文件其它位置已清）。
|
|||
|
|
8. **`douyin-rise-ranking/references/core_workflow.md` 相对链接差一级**：`../../SKILL.md` 应为 `../../../`（同级 SKILL.md 是对的，此文件深一层没跟着改）；`scripts/…`、`references/…` 链接缺 `../`。
|
|||
|
|
9. **索引表文件名与实际不符（P2）**：`索引_知识素材库.md:65,67` 写 `星爷+沈腾` / `本山+憨豆`，实际文件名带空格 `星爷 + 沈腾` / `本山 + 憨豆`。
|
|||
|
|
|
|||
|
|
### 工具层踩坑（重要）
|
|||
|
|
- **本会话 Bash 工具不可用**：`head`/`dirname` 等 coreutils 报 `command not found`（PATH 未注入），POSIX 命令全部失败。
|
|||
|
|
- **PowerShell 工具 stdout 被吞**：`Write-Output` / 管道输出一律不返回（只回 "Command completed with exit code 0"）。**解法：把结果 `Out-File` 到 `tools/` 下的临时文件，再用 Read 工具读**（本次全程用此法）。
|
|||
|
|
- Python 走 managed 路径 `C:\Users\maidou\.workbuddy\binaries\python\versions\3.13.12\python.exe`，脚本自带 UTF-8 写盘，无编码问题。
|
|||
|
|
- Grep 工具对超长行会返回 `[Omitted long matching line]`，需用 Read 定点读原文件补全。
|
|||
|
|
|
|||
|
|
### 状态
|
|||
|
|
- 报告为**只审不改**交付；三批修复方案（A 口径统一 / B dsh 残留清理 / C 细节对齐）已列在报告第四节，**等用户授权**。
|
|||
|
|
- 未执行项：`失误与规避记录.md` 新增条目、`references-add/变更日志.md` 记录、SKILL.md frontmatter `last_change` —— 待修复落地时一并做。
|
|||
|
|
|
|||
|
|
## P1 修复方案设计（只出方案，未动技能文件）
|
|||
|
|
|
|||
|
|
- **产出**：`P1修复方案_V1.0_20260914.md`（仓库根）。覆盖 8 条 P1 → 去重后 **15 文件 / 36 处**，分 3 批（A 口径统一 → B dsh 收尾 → C 契约补登记，C 可并行）。
|
|||
|
|
- **设计原则固化**：改源头不打补丁 / 单源化（同一规则只留一个权威定义处，其余只指向）/ 删历史叙述 / **不动白名单**（工作台 `/api/dsh/*` API 命名空间 + 第三方原样分发包 + 各文件「变更记录」区）。
|
|||
|
|
- **取证要点（逐处已读原文，方案给到"文件:行 现状→改为"粒度）**：
|
|||
|
|
- P1-1 S7:31 断链**重新定性为"措辞导错主语"**：模板A/B 确实是 S6 文件末尾的 8 列骨架（知识库 03/01 是方法论描述，**不是同一层**），故**只改措辞、不搬迁**，避免制造新的重复定义。
|
|||
|
|
- P1-2 补登记：功能四「账号数据分析」=`SKILL_HINT_ANALYZE`（data-pages.js:1303-1312，skills `['mcn-dou-analysis']`）；功能五「视频解析/刷新」=`SKILL_HINT_VIDEO_PARSE`（:1719-1733，刷新追加 `VIDEO_REFRESH_OVERRIDE`）。契约表 L127 常量清单 + 检查清单第 1 项 + SKILL.md L81 三处同步。
|
|||
|
|
- P1-3 门禁冲突**解法=按"闸门/报告"拆**：判据来自规范自身 L183「验收口径=执行约束、不进入交付物」→ 八类35项执行前置到 **S9 收尾静默执行**（不过禁止进 Gate-5），S11 = 可选报告层；定义只在规范 L97 写一次。
|
|||
|
|
- P1-7 推荐 **A 改写为工作台接口规范**（保留"大文本禁 PowerShell ConvertTo-Json、必须 Python urllib 直连"这条通用铁律）；接口清单不另抄，指向工作台契约文档 + server.js 为权威。
|
|||
|
|
- P1-8 共 8 处「dsh 已下线/无 dsh 分支」噪音，含 `mcn-data-insight` 侧 3 处（正文括注 + py docstring），给出一次扫净 grep 命令。
|
|||
|
|
- 附带发现：`7_生成短视频大纲.md:20` 标题「（从 S6 移入）」= 变更动作叙述 → 应删（并入 P1-1）。
|
|||
|
|
- **待用户裁决 3 项**：① P1-3 的"S9 强制 + S11 可选"拆法是否接受 ② P1-7 选 A（重写）还是 B（下线）③ 执行授权与批次范围。
|
|||
|
|
- **状态**：方案文件已交付，技能文件**零改动**。
|