Skip to content

Type docs' 禁止 sections split into floors and common misuses; general notes on facts, parallel agents, recordings; canvas-film's optional modules - #112

Merged
ZLHad merged 1 commit into
mainfrom
claude/guidance-types
Oct 18, 2026
Merged

ZLHad merged 1 commit into
mainfrom
claude/guidance-types

Conversation

@ZLHad

@ZLHad ZLHad commented Oct 18, 2026

Copy link
Copy Markdown
Owner

What and why · 改了什么、为什么

第 1 批:把剩下写死的口味松开,补几段通用的注意事项。判别标准是:换一支完全不同的片子,这条还成立吗?模型不照做,是会出错,还是只是做得不一样?(规划:docs/design-notes/2026-10-17-guidance-round.md 第 11 节,私有笔记。)

  • 8 份类型文档(01–04、06–09)的"禁止"一节:照 05 的写法分成"底线"(以及代码、编码出错的"会出错的")和"常见误用(参考)",每条写原因。节名不动,quick 照常读这一节。

    • 原来底线和口味混在一张清单里。比如 07 手绘那条"每个镜头都是一个不同的世界,彼此之间没有联系",会把一支有意每章换一个世界的片子判错。现在写成"镜头之间毫无联系:换世界可以,留一个串起来的角色、物件或母题"。
  • Prompt 增量块:默认值照留,去掉几处写死的 never:

    • 04 的 crossfade、06 的截 PDF、08 的 1 秒笑点;
    • 04 的"每一刀都落在拍上":声明的卡点照旧 ±1 帧;
    • 02 里还留着的"一条一行记进 DECISIONS.md"。
  • playbook/03:锚点网格写成可用的做法;"只用 2–3 种转场"写成默认,并写明原因:重复用的几种转场会成为这支片子的语言。recipes 里一处引用跟着改。

  • engines/canvas-film/README:配乐时钟和时间映射挪进"可选模块"一节,说明不设 FILM.music / FILM.timemap 就不起作用;补一句改映射时怎样不挪已定的落点。

  • 几段通用注意事项:

    • 事实核查分三级;会变的数字带日期;星期、月相用代码算;评审要改引文先回出处(playbook/02);
    • 几个代理同时干活:各用草稿目录,共享文件只由主 agent 改(playbook/01);
    • 先用有授权的录音(playbook/04);
    • 软字幕轨只提醒,烧进画面的照读时底线(playbook/02)。

    playbook/02 里"确认告警"那段压短了一半。

  • 读量:quick 最多多 63 字符,standard 约多 100,多出来的是底线的分层小标题和事实核查一段。

English summary. Types 01–04 and 06–09 now split their 禁止 lists into floors (and code or encode faults) and common misuses with reasons, as 05 did; Prompt blocks drop fixed "never"s; playbook/03's transition count and anchor grid become defaults with reasons; canvas-film's README groups the music clock and the time map as optional modules. Short notes on facts, parallel agents, recordings and soft subtitle tracks. The read path grows by up to 63 characters (quick) and about 100 (standard).

How it was verified · 怎么验证的

  • tools/ci.sh --committed(VH_BASH=/bin/bash,shellcheck、pyflakes 真的跑了)通过。
  • tools/readpath.py 对比 main:见上面的读量。

Checklist · 自查

  • tools/ci.sh --committed passes · 通过
  • User-visible change noted in CHANGELOG.md → Unreleased · 已记进 CHANGELOG
  • Changed CLAUDE.md → ran bin/vh sync-agents · 没改 CLAUDE.md

…notes on facts, parallel agents, recordings; canvas-film's optional modules
@ZLHad
ZLHad marked this pull request as ready for review October 18, 2026 16:00
@ZLHad
ZLHad enabled auto-merge (squash) October 18, 2026 16:00
@ZLHad
ZLHad merged commit 6846273 into main Oct 18, 2026
2 checks passed
@ZLHad
ZLHad deleted the claude/guidance-types branch October 18, 2026 16:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant