Improve
路径:${CLAUDE_SKILL_DIR} 指包含此 SKILL.md 的文件夹;${CLAUDE_SKILL_DIR}/../.. 指编辑器所在仓库的 .claude/ 文件夹(即上层两层目录)。
所有向用户的提问都放在提问框中:调用 AskUserQuestion 工具(提供 2-4 个选项,推荐的排第一)。仅当 代理没有该工具时,才用文本形式提出带编号的问题。
此技能在仓库的 git 检出中运行,专为仓库维护者设计。这里的一个修复会在用户下次更新时惠及所有用户。S="${CLAUDE_SKILL_DIR}/scripts"。在 Mac 和 Linux 上用 python3 运行脚本,在 Windows 上用 py 运行。
0. 谁在运行
python3 "$S/improve.py" mode
maintainer —— 仅在带有 AI_EDITOR_MAINTAINER=1 的仓库 git 检出中:继续执行步骤 1。
user —— 编辑器自身的文件在每次更新时都会被替换,因此永远不要编辑它们(包括 SKILL.md、reference、脚本或 PRINCIPLES.md)。如下收集和挑选,然后将每个接受的条目保存在用户自己的分层目录中,该目录不会因更新而改变(见仓库中的 docs/customise.md):
- 一条设置:使用
taste.py add ... --set - 一条单词规则:使用
python3 "${CLAUDE_SKILL_DIR}/../../lib/ai_editor/custom.py" rule "<rule>" - 一个字幕样式:作为
custom/captions/<name>.json,再加上taste.py set captions.preset <name> - 模板默认值:作为
custom/templates/<type>.json
然后提供 taste.py suggest,以便维护者可以为所有人修复。在此停止。
1. 收集
python3 "$S/improve.py" collect [--edits D] [--no-gh]
每行一条规则,重复最多的排在前面:包含出现次数、来源(建议、品味回归、预览修正、审阅注释、GitHub Issue)、指定的所有者名称,以及最多三个示例。由多个用户提到或应用后再次被提及的规则优先显示。
2. 挑选
显示队列顶部的条目,并在提问框中询问现在要修复哪些(多选,重复最多的优先,推荐)。对于每一条,如果不清晰,同时询问:每个用户(推荐)/ 仅部分创作者的风格(它应属于 style.json 字段,而非一条规则)/ 不是修复(关闭它)。
3. 按以下顺序修复每一项
- 规则。 在
${CLAUDE_SKILL_DIR}/../../PRINCIPLES.md中合适标题下写一行,说明在哪里强制执行,同时在所属的 SKILL.md 或 reference 中添加相同的规则。应具有通用性,绝不针对单个视频:例如 "变焦缓动至少持续 0.5 秒",而非 "0:12 处的变焦卡顿"。 - 强制执行。 使规则生效的最小代码,无需任何人记住它:在检查脚本(
check.py、quality.py、product.py check、ai_tells.py)中产生 FAIL,在可能会破坏规则的脚本中拒绝执行(gates.py),一个无法产生该问题的默认值,或者在tests/check_plugins.py中为仓库规则添加一行。优先加强现有检查,而不是新增一个。 - 测试。 在该脚本的
demo()(或tests/目录)中添加一个断言,基于一个小型的合成失败示例构建。在修复前运行并看到它失败,修复后运行并看到它通过。只有代理才能遵循的规则(涉及提问、解释)则在evals/中放置评估案例:包含prompt.md和一个tool_used或llm评分器。 - 记录。 在
docs/feedback-matrix.md中记录:规则、写在何处、由什么强制执行、有哪些测试。
4. 运行所有内容
python3 tests/check_plugins.py
python3 .claude/lib/ai_editor/okf.py check
接着运行 tests/demos.sh(每个脚本的 demo)、node tests/test_record.mjs,如果渲染器已配置则运行 tests/smoke.py 和 tests/golden.py。全部通过后才能交接。不要提交代码;维护者会审查 diff 并提交。
对于现已修复的 GitHub Issue,在询问后,可提供一条包含修复摘要的评论并关闭该 Issue(gh issue close <n> --comment "...")。
切勿
- 切勿编辑用户的 taste.md、taste.json、rules.json 或 suggestions.jsonl:这些属于用户自己。
- 切勿在仓库中放置个人数据:不要包含姓名、用户名、邮箱、文件名或来自反馈的影像资料。请编写通用规则和合成示例。
tests/check_plugins.py会检测已知的私人姓名;请先检查每个示例再放入仓库。 - 切勿仅靠注释来闭环。没有强制执行和测试的规则不算完成。
文件
scripts/improve.py:包含mode、collect、demo函数。仅读取文件。${CLAUDE_SKILL_DIR}/../../lib/ai_editor/custom.py:用户的<library>/custom/目录(用户模式下向其写入)。${CLAUDE_SKILL_DIR}/../../skills/taste/scripts/taste.py:其中suggest和issue写入用户侧内容。