Repository navigation
Type docs' 禁止 sections split into floors and common misuses; general notes on facts, parallel agents, recordings; canvas-film's optional modules - #112
Merged
Conversation
…notes on facts, parallel agents, recordings; canvas-film's optional modules
ZLHad
marked this pull request as ready for review
October 18, 2026 16:00
ZLHad
enabled auto-merge (squash)
October 18, 2026 16:00
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What and why · 改了什么、为什么
第 1 批:把剩下写死的口味松开,补几段通用的注意事项。判别标准是:换一支完全不同的片子,这条还成立吗?模型不照做,是会出错,还是只是做得不一样?(规划:
docs/design-notes/2026-10-17-guidance-round.md第 11 节,私有笔记。)8 份类型文档(01–04、06–09)的"禁止"一节:照 05 的写法分成"底线"(以及代码、编码出错的"会出错的")和"常见误用(参考)",每条写原因。节名不动,quick 照常读这一节。
Prompt 增量块:默认值照留,去掉几处写死的 never:
playbook/03:锚点网格写成可用的做法;"只用 2–3 种转场"写成默认,并写明原因:重复用的几种转场会成为这支片子的语言。recipes 里一处引用跟着改。
engines/canvas-film/README:配乐时钟和时间映射挪进"可选模块"一节,说明不设
FILM.music/FILM.timemap就不起作用;补一句改映射时怎样不挪已定的落点。几段通用注意事项:
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 --committedpasses · 通过CHANGELOG.md→ Unreleased · 已记进 CHANGELOGCLAUDE.md→ ranbin/vh sync-agents· 没改 CLAUDE.md