agentleFS
e06084e06084/claude-screenwriting/skills/screenwriting-lint/SKILL.md

screenwriting-lint

Skill9 starsChanged 6 months agoMITView on GitHub

剧作结构健康度检查。扫描 wiki vault,按编剧理论维度诊断结构完整性、 角色弧一致性、连接完整性,输出评分报告和优先修复建议。 Triggers on: "/screenwriting-lint", "诊断", "检查", "健康度", "story health".

The file

Files
SKILL.md

Screenwriting Lint

对故事 wiki 进行全面的结构健康度检查,基于 Vogler/McKee/Save the Cat 理论标准。

诊断维度

1. Beat 完整度(30 分)

检查项分值严重度
15 个 beat 文件全部存在10Error if missing
关键 beat 有实质内容(#4 Catalyst, #9 Midpoint, #11 All Is Lost, #13 Break into Three)10Error if empty
Opening Image (#1) 有内容3Warning
Final Image (#15) 有内容3Warning
Opening 与 Final 有可对比性4Warning

关键 beat 诊断标准:

  • Catalyst: 必须描述一个外力事件(非主角主动选择)
  • Midpoint: 必须有"赌注升级"或"规则改变"的表述
  • All Is Lost: 必须有"死亡气息"(字面或象征性的丧失)
  • Break into Three: 必须有 A+B 融合的顿悟

2. 角色弧一致性(30 分)

检查项分值严重度
主角(hero)存在5Error
主角有 Wants5Error
主角有 Needs5Error
Wants ≠ Needs(存在张力)5Warning
主角有 Shard of Glass3Warning
主角有 Contradiction(surface ≠ truth)3Warning
主角有 arc_type 设置2Info
Shadow/反派有独立动机2Warning

Wants/Needs 张力检测:

  • 如果 Wants 和 Needs 用词高度相似 → Warning "张力不足"
  • 如果 Wants 的实现路径必然满足 Needs → Warning "无内在冲突"

3. 结构健康度(25 分)

检查项分值严重度
Catalyst 是外力事件6Error
Midpoint 有转折/升赌注6Warning
All Is Lost 够低(有丧失感)5Warning
B Story 存在且与主题关联4Warning
Theme Stated (#2) 与 logline 主题呼应4Info

4. 连接完整性(15 分)

检查项分值严重度
无孤儿角色(每个角色至少被 1 个 beat 引用)5Warning
无断链(无指向不存在页面的 [[link]])5Error
每个 beat/character 有 source backlink5Info

执行流程

  1. Glob 获取 wiki/ 下所有 .md 文件列表
  2. Read 关键文件:index.md, 所有 beats, 所有 characters, meta/logline.md
  3. 逐维度检查,记录发现
  4. 计算总评分
  5. 按严重度排序输出报告

输出格式

📊 故事健康度: {score}/100

分项评分:
├── Beat 完整度: {x}/30
├── 角色弧一致性: {x}/30
├── 结构健康度: {x}/25
└── 连接完整性: {x}/15

🔴 Error ({count}) — 必须修复
{逐条列出,含文件路径和具体问题}

🟡 Warning ({count}) — 建议修复
{逐条列出}

ℹ️ Info ({count}) — 可选优化
{逐条列出}

🟢 Good ({count}) — 做得好
{肯定已完成的部分}

💡 优先修复建议(Top 3):
1. {最高优先级 + 为什么 + 怎么修}
2. {次优先级}
3. {第三优先级}

特殊情况处理

Wiki 为空或极度不完整

如果发现:

  • 无 index.md → 输出"Wiki 未初始化,请先运行 /story"
  • 无任何 beat 文件 → 输出"尚未开始创建节拍,建议 /ingest 或 /beats generate"
  • 仅有 1-2 个文件 → 给出"初始化阶段建议"而非大量错误

--fix 模式

当用户使用 /lint --fix 时:

  1. 对每个可自动修复的问题生成修复建议
  2. 展示修复内容,逐项确认
  3. 仅修复用户确认的项目
  4. 记录修复到 wiki/log.md

可自动修复的问题:

  • 缺失的 beat 文件(创建空模板)
  • 断链(创建空的被引用页面)
  • 缺失的 source backlink(添加到文件末尾)

不可自动修复的问题:

  • 内容质量问题(Catalyst 不是外力等)
  • Wants/Needs 张力不足
  • 任何需要创意判断的改动

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.