프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. Google로 로그인하면 리뷰를 쓸 수 있어요.프로토타입 · 30분마다 업데이트
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요

shuohao-skills Skill

저장소 ↗

제작자: eternityspring★ 6,793skill 1개

설치

What it does

AI 短剧制作的 skill 集合:拆角色、排大纲、出场景与道具设定、写剧本、切分镜 | Agent skills for AI short-drama production — character bibles, adaptation outlines, art bibles, screenplays, storyboards. Runs in Claude Code & codex.

  • Connects Instruction files the AI reads
  • Account or key Not confirmed (README mentions a key or .env file)
  • Category 코딩
제작자용: README에 배지 달기

제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/skill/eternityspring-shuohao-skills.svg)](https://mcp.popnx.com/en/skills/eternityspring-shuohao-skills)

함께 쓰기

같은 작업에서 AI를 서비스에 연결하는 MCP

REA

Reverse engineer anything from your terminal or agent with one CLI and MCP server.

제작자: morluto널리 사용됨↓ 38.9만/주★ 46.8만7일 전 업데이트

MCP · 서비스 연결내 컴퓨터에서 실행

Fallow

Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.

제작자: fallow-rs널리 사용됨↓ 244.1만/주★ 5.4천그저께 업데이트

MCP · 서비스 연결내 컴퓨터에서 실행

Desktop Commander

MCP server for terminal commands, file operations, and process management

제작자: wonderwhy-er널리 사용됨↓ 74만/주★ 1만어제 업데이트

MCP · 서비스 연결내 컴퓨터에서 실행

비슷한 Skill

같은 종류의 작업, Skill 목록과 같은 순서

비슷한 항목과 비교
이 항목
shuohao-skills
reaandrej-karpathy-skillsgraphifyMoneyPrinterTurbo
제작자eternityspringmorlutomultica-aiGraphify-Labsharry0703
Skill 수11111
GitHub 별6,793467,235234,125149,873144,332
마지막 코드 변경2026년 11월 9일2026년 11월 18일2026년 4월 20일2026년 11월 18일2026년 11월 18일
라이선스Apache-2.0MIT–Apache-2.0MIT

eternityspring의 Skill(지시 묶음) 1개, AI가 읽고 그대로 일해요 · MCP server가 아니에요

Skill과 MCP의 차이

MCP = 손

AI를 외부 서비스나 데이터에 연결합니다(예: Notion 읽기, 청구서 만들기). 프로그램이나 서버가 실행 중이어야 합니다.

Skill = 안내서

작업 방법을 AI에게 가르치는 텍스트 파일. 어떤 서비스에도 연결되지 않습니다.

겹치는 경우도 있습니다. 도구를 부르는 스크립트가 있는 Skill도, 지식만 보내는 MCP도 있습니다. 하려는 작업을 기준으로 고르세요.

쓸 수 있는 앱

Claude CodeCodex

제작자 README와 repo 폴더 기준

설치

Is it safe?

  • Who made it

    GitHub account eternityspring (person), 13 years old

  • Use and upkeep

    ★ 6,793 stars · code last changed 2026년 11월 9일

  • Any scripts?

    2 scripts that can run on a computer: scripts/novel-characters.mjs, scripts/selftest.mjs

  • Uses the internet?

    Scripts that go online: scripts/novel-characters.mjs

  • Changes machine-wide settings?

    No hooks or writes to machine settings found

Checked automatically from the repo files at commit 8af10e0 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself

먼저: 어떤 AI를 쓰시나요

쓰는 앱을 고르면 그 앱의 설치 방법만 보여 드립니다

Option 1Upload to claude.ai (web and app)

Uploading to claude.ai would fail: the description is over 200 characters (229). Use "Let the AI install it" instead

Option 1Claude Code에게 설치 맡기기

이 문장을 복사해 Claude Code 채팅에 붙여 넣으세요

Where to install
Please install the skill novel-characters from https://github.com/eternityspring/shuohao-skills folder skills/novel-characters (commit 8af10e0) for all my projects, at ~/.claude/skills/novel-characters. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill novel-characters from https://github.com/eternityspring/shuohao-skills folder skills/novel-characters (commit 8af10e0) into the project this chat is open in (at .claude/skills/novel-characters). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Claude Code를 다시 열고 /novel-characters를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요

Checked against official docs 2026년 11월 12일 · Source: code.claude.com

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.claude/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    git clone --depth 1 https://github.com/eternityspring/shuohao-skills.git /tmp/popnx-skill-eternityspring-shuohao-skills-8af10e0 && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-eternityspring-shuohao-skills-8af10e0/skills/novel-characters' ~/.claude/skills/novel-characters
  3. Claude Code를 다시 열고 /novel-characters를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요

직접 설치한 Skill은 ChatGPT 데스크톱 앱, Codex CLI, IDE의 Codex 확장 프로그램에서 쓸 수 있습니다 · 웹과 모바일의 ChatGPT에서는 직접 설치한 Skill을 쓸 수 없고 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다

ChatGPT 데스크톱 앱

ChatGPT 데스크톱 앱에는 Codex가 들어 있고, Codex는 ~/.agents/skills 폴더에서 Skill을 읽습니다

Option 1ChatGPT에게 설치 맡기기

ChatGPT 데스크톱 앱에서 Codex를 열고 이 문장을 채팅에 붙여 넣으세요

Where to install
Please install the skill novel-characters from https://github.com/eternityspring/shuohao-skills folder skills/novel-characters (commit 8af10e0) for all my projects, at ~/.agents/skills/novel-characters. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill novel-characters from https://github.com/eternityspring/shuohao-skills folder skills/novel-characters (commit 8af10e0) into the project this chat is open in (at .agents/skills/novel-characters). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Option 2폴더를 직접 넣기

novel-characters 폴더를 ~/.agents/skills/novel-characters에 넣으세요

~는 홈 폴더($HOME)입니다

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.agents/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    git clone --depth 1 https://github.com/eternityspring/shuohao-skills.git /tmp/popnx-skill-eternityspring-shuohao-skills-8af10e0 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-eternityspring-shuohao-skills-8af10e0/skills/novel-characters' ~/.agents/skills/novel-characters

설치한 뒤

  • ChatGPT 데스크톱 앱: 사이드바에서 Skills를 열어 Skill이 보이는지 확인하세요
  • 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요
  • Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

웹과 모바일의 ChatGPT

직접 설치한 Skill은 쓸 수 없고, 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다

이 Skill을 ChatGPT에서 쓰려면 위 방법대로 ChatGPT 데스크톱 앱을 쓰세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

Option 1Codex에게 설치 맡기기

이 문장을 복사해 Codex 채팅에 붙여 넣으세요 · ChatGPT 데스크톱 앱 안의 Codex, Codex CLI, IDE 확장 프로그램에서 모두 쓸 수 있습니다

Where to install
Please install the skill novel-characters from https://github.com/eternityspring/shuohao-skills folder skills/novel-characters (commit 8af10e0) for all my projects, at ~/.agents/skills/novel-characters. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill novel-characters from https://github.com/eternityspring/shuohao-skills folder skills/novel-characters (commit 8af10e0) into the project this chat is open in (at .agents/skills/novel-characters). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요 · 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.agents/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    git clone --depth 1 https://github.com/eternityspring/shuohao-skills.git /tmp/popnx-skill-eternityspring-shuohao-skills-8af10e0 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-eternityspring-shuohao-skills-8af10e0/skills/novel-characters' ~/.agents/skills/novel-characters
  3. Codex를 다시 열고 관련 작업을 요청하면 Codex가 skill을 목록에 보여 줘요

Option 1Cursor에게 설치 맡기기

이 문장을 복사해 Cursor 채팅에 붙여 넣으세요

Where to install
Please install the skill novel-characters from https://github.com/eternityspring/shuohao-skills folder skills/novel-characters (commit 8af10e0) for all my projects, at ~/.cursor/skills/novel-characters. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill novel-characters from https://github.com/eternityspring/shuohao-skills folder skills/novel-characters (commit 8af10e0) into the project this chat is open in (at .cursor/skills/novel-characters). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Cursor Agent 채팅에서 /를 입력하고 novel-characters 선택

Checked against official docs 2026년 11월 12일 · Source: cursor.com

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.cursor/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    git clone --depth 1 https://github.com/eternityspring/shuohao-skills.git /tmp/popnx-skill-eternityspring-shuohao-skills-8af10e0 && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-eternityspring-shuohao-skills-8af10e0/skills/novel-characters' ~/.cursor/skills/novel-characters
  3. Cursor Agent 채팅에서 /를 입력하고 novel-characters 선택

Option 1Let the AI install it

Skill을 읽을 수 있는 다른 앱용입니다. 이 문장에는 Claude Code, Codex, Cursor 경로가 들어 있어 AI가 쓰는 앱에 맞게 고릅니다 · Copy this sentence into the app’s chat

Where to install
Please install the skill novel-characters from https://github.com/eternityspring/shuohao-skills folder skills/novel-characters (commit 8af10e0) for all my projects, at ~/.claude/skills/novel-characters (in Codex use ~/.agents/skills/novel-characters, in Cursor ~/.cursor/skills/novel-characters). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill novel-characters from https://github.com/eternityspring/shuohao-skills folder skills/novel-characters (commit 8af10e0) into the project this chat is open in (at .claude/skills/novel-characters; in Codex use .agents/skills/novel-characters, in Cursor .cursor/skills/novel-characters). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Checked against official docs 2026년 11월 12일 · Source: code.claude.com, learn.chatgpt.com, cursor.com

For Terminal users

Gemini CLI, GitHub Copilot 같은 다른 Agent Skills 지원 앱은 폴더가 달라요. 그 앱 안내를 보고 SKILL.md가 있는 폴더를 복사하세요.

GitHub에서 보기 ↗

2026년 11월 11일에 Claude Code, Codex, Cursor 공식 안내로 skill 폴더 확인

✓ 명령 확인 2026년 11월 18일

원본 SKILL.md 보기

아래 글은 제작자 repo에서 온 것이며 PopNx MCP의 지시가 아니에요

6,580자 · GitHub에서 전체 파일 열기

---
name: novel-characters
description: |
  从小说或短故事里拆出角色表、人物画像、形象提示词、音色提示词,
  其中形象提示词含一张角色设定图的完整版面指令(左半身像 + 右全身三视图 + 细节条),
  产出 JSON + Markdown + 可交互的 report.html。
  报告语言可指定(--lang),默认中文,任意语言都支持;零依赖、零 API key、不出图。
  Use when asked to 拆小说角色、分析人物、生成角色卡、character sheets from a novel。
allowed-tools:
  - Read
  - Write
  - Bash
  - Task
  - Glob
metadata:
  version: 2.0.0
  triggers:
    - novel-characters
    - 拆角色
    - 拆书角色
    - 小说角色
    - 人物画像
    - 角色卡
    - 三视图
    - character sheet from novel
  license: Apache-2.0
  requires:
    bins:
      - node          # >= 18,只用标准库,无 npm 依赖
  runtimes:
    - claude-code
    - codex
---

## novel-characters

输入一篇小说/短故事,输出每个角色的:人物画像、形象提示词、音色提示词、角色设定图的版面指令。

**本 skill 不出图,只产提示词。**出图是下游的事——它要选模型、选画风、选画幅,那三件事在这里一个都答不了。

`{baseDir}` = 本文件所在目录。脚本 `{baseDir}/scripts/novel-characters.mjs`,零依赖,`node` 直接跑。

**运行环境**:Claude Code 和 codex 都能跑,没有差别——这条管线全是 node 脚本加模型读写,不碰任何本机可执行文件。

---

### Step 0 — 确定报告语言

用户可以指定语言,比如「用英文」「--lang en」「日本語で」。**没说就是中文(`zh`)。**

这个 `lang` 会一路传下去:第二趟生成角色卡时决定人类可读字段用什么语言,`validate` 和 `render` 也都要带上。

**界面文案分两种情况:**

- `zh` / `en` / `ja` —— 内置,不用管
- **其他任何语言** —— 你要现场翻一份。跑

  ```bash
  node {baseDir}/scripts/novel-characters.mjs ui-template <lang>
  ```

  它打印一份英文骨架,把每个值翻译成目标语言,整块放进 `cast.json` 顶层的 `ui` 字段。渲染时会合并进内置表。

  **不给 `ui` 的话 `validate` 会直接报错**——否则报告会是「角色内容是法语、界面标签是英文」的半吊子状态。

支持的语言不受内置表限制,法语韩语西班牙语都能出完整报告。

### Step 1 — 定位输入

用户给文件路径就直接用。直接粘正文的,**先落到一个临时 .txt**——后面校验「引文是否逐字」要拿原文比对,没有原文文件这步就没法做。

确定输出目录:用户指定就用;没指定就用原书同级目录。

**有 `outline.json`(novel-outline 的产出)就一起要过来,走 seed**——大纲是角色设定的上游,它的 `characters` 块已经定死了角色清单:

```bash
node {baseDir}/scripts/novel-characters.mjs seed <outline.json> > <workdir>/seed.json
```

搬过来的是大纲已经拍板的事实,留空的是这一层才该做的设计:

| outline 的字段 | seed 之后 |
| --- | --- |
| `id` | 原样保留成角色码——下游 script / storyboard 用它引用角色 |
| `name` | 角色表就照这份,**不再自己判断谁该进** |
| `tier` | 映射成 `importance`:`lead` → `protagonist`、`support` → `supporting`、`functional` → `minor` |
| `arc` | 直接落进 `persona.arc` |
| `role` / `from` | 进 `seedNote`——定位(女主 / 反派)与「由原著的谁合并而来」,扫原文时知道该收哪几条线的戏 |

留空待填:`aliases`(要读原文才知道)、`oneLiner`、`persona` 其余各项、`image`、`voice`。**seed 出来的是骨架不是成品**,直接跑 `validate` 会报一堆字段缺失,那是预期的——后面 Step 2–6 就是来填它的。

两处口径要守住:

- **大纲定的分档不要推翻**。谁重要是改编阶段拍板的事,这一层只负责把定下来的人做深。真觉得分档不对,回去改大纲,别在这里悄悄改一个不一样的
- **主角组内部可以细分**。outline 的 `lead` 是「男女主 + 主反派」一整组,对应 `protagonist` 与 `major` 两档,seed 一律给 `protagonist`;照 `seedNote` 里的定位把主角之外的改成 `major`,这不算推翻分档

**没有 `outline.json` 也照常跑**,本 skill 不依赖它——跳过 seed,从 Step 2 开始自己从原文拆角色表。

### Step 2 — 分块

```bash
node {baseDir}/scripts/novel-characters.mjs chunk <book.txt> <workdir>
```

打印 `{"chunks": N, ...}`。

- **N == 1**:跳过 Step 3,直接在当前会话读原文做第一趟,结果自己写成 `<workdir>/roster-00.json`
- **N > 1**:进 Step 3
- `truncated: true`:明确告诉用户尾部没扫到,别闷着

### Step 3 — 第一趟扫描(仅 N > 1)

**当前环境支持子代理就并发**(Claude Code 的 Task、codex 的 subagent):每块一个子代理,**所有调用放在同一条消息里**才是真并发。不支持就一块一块串行读,结果一样,只是慢。

每个子代理的任务:
1. 读 `{baseDir}/references/roster-pass.md`,照它执行
2. 读 `<workdir>/chunk-NN.txt`
3. 把 roster JSON 写到 `<workdir>/roster-NN.json`
4. 只回一句「done NN,抽到 X 个角色」

### Step 4 — 归并 + 复核

```bash
node {baseDir}/scripts/novel-characters.mjs merge <workdir> | tee <workdir>/merged.json
```

落到 `merged.json` 不只是留档:Step 6 的 assemble 靠它拿同档角色的戏份顺序。

按名字+别名精确收敛(某块把「陆」列成「陆行远」的别名,两条就并成一个人),notes 累加、quotes 去重,按出现块数降序——出现的块越多戏份越重。

输出是 `{ "characters": [...], "mergeCandidates": [...] }`。**`mergeCandidates` 要逐条复核**:精确匹配只能收敛两块恰好写了相同称呼的情况,剩下的是语义判断,脚本做不了。候选来自名字包含关系(`「陆」⊂「陆行远」`)——是强信号不是判决,同姓的父子、兄弟就不能合。候选之外你自己看出来的同人(「陆先生」和「行远」没有包含关系,不会进候选)也要合。

要合并就写一份 merges.json 再落地:

```json
{ "merges": [{ "keep": "陆行远", "absorb": ["陆", "陆先生"] }] }
```

```bash
node {baseDir}/scripts/novel-characters.mjs merge <workdir> --apply merges.json | tee <workdir>/merged.json
```

`keep`/`absorb` 用名字或任一别名定位都行,找不到会直接报错。输出仍带 `mergeCandidates`,剩下的都确认是不同的人(或清空)再进下一步。没有要合的就直接往下走——但 `merged.json` 必须留着。

### Step 5 — 选角

取前 N 位。默认 30,用户说了就听用户的。剩下的角色在最后汇报里提一句「还识别出 X 位没做画像」。

### Step 6 — 第二趟出卡

每个角色一份,同样能并发就并发。

每份任务拿到:
- `{baseDir}/references/profile-pass.md` 和 `{baseDir}/references/schema.md`(读它们,照着做)
- **报告语言 `lang`**(Step 0 定的)
- 该角色归并后的 `name` / `aliases` / `notes` / `quotes`
- **同批其他角色的名字**(避免长相声线撞车)

按 `profile-pass.md` 完成身份—外观语义自检后再交卡:人物档案、形象提示词、本地译文与设定图主体不能各说一种身份。大纲决定名单和改编取舍,原文观察补足外形依据;不要只给大纲而跳过 Step 2–4 的原文扫描。

角色卡 JSON 写到 `<workdir>/card-<slug>.json`。**断点续跑**:`card-<slug>.json` 已存在的角色不必重跑。

**同时写一段故事摘要**:用 `lang` 指定的语言,3–5 句,交代时空背景、核心情境、这几个人聚在一起的由头。短篇直接从原文写;长篇从各块的 roster note 归纳。不剧透结局,不写成推荐语。写到 `<workdir>/summary.txt`。非内置语言的话,把 Step 0 翻好的 ui 整块存成 `<workdir>/ui.json`。

然后合成 cast.json——**用 assemble,不要手拼**(手拼会丢字段、写错顶层键):

```bash
node {baseDir}/scripts/novel-characters.mjs assemble <workdir> \
  --source <书名> --lang <lang> \
  --out <输出目录>/<书名>-cast.json
```

坏卡会被逐个点名——哪份 `card-*.json` 坏了就只重跑那个角色,其他不用动。

同档角色的先后是戏份顺序,来自 Step 4 留下的 `<workdir>/merged.json`(assemble 自动读,也可用 `--order` 指别的文件)。报告左栏「按戏份排序」的序号就靠它——看到「同档角色将按文件名序」的警告说明 merged.json 丢了,回 Step 4 重新生成。

### Step 7 — 校验 ⛔ 不能跳

```bash
node {baseDir}/scripts/novel-characters.mjs validate <cast.json> <book.txt>
```

记得带上 `--lang`(Step 0 定的)。检查:结构、`importance` 枚举、**引文逐字**、**出图提示词不含人名**、**语言分工**(人类字段跟随 `lang`、出图/TTS 提示词永远英文)、以及**非内置语言必须带 `ui`**。

**有违规就按报错逐条修,改完重跑,直到通过。** 这四类错模型真的会犯——这套检查就是被真实输出打出来的。

### Step 8 — 输出

```bash
cd <输出目录>
node {baseDir}/scripts/novel-characters.mjs render <cast.json> --md   > <书名>-cast.md
node {baseDir}/scripts/novel-characters.mjs render <cast.json> --html > report.html
```

语言取 `cast.json` 里的 `lang`,要临时覆盖就加 `--lang <code>`。

`render` 默认去 cast.json 同级的 `images/<slug>-sheet.png` 找图;图在别处就用 `--images <目录>`
指过去(任意路径)。**本 skill 不产生这些文件**——下游出完图,重跑一次 render 就能把图嵌进报告。

report.html 的样式约定见 `{baseDir}/references/report-style.md`——要改样式先读它,别把它改回通用卡片墙。

最终落地:

```
<输出目录>/
├── <书名>-cast.json
├── <书名>-cast.md
├── report.html                    ← 双击就能开
└── images/                        ← 本 skill 不写这个目录
    └── <slug>-sheet.png           ← 下游出完图放这儿,render 会捡起来
```

### Step 9 — 汇报

一句话说清:角色数、报告路径。校验一次没过的话,说明修了什么。原文被截断要明确说清楚。

**不要说「已出图」或「已生成设定图」**——这一步不存在了,交付的是提示词。

---

## 边界

- 单次上限 24 块(净覆盖约 93 万字符),超了会明确报 `truncated`,不静默截断
- 人类可读字段跟随 `--lang`(默认中文);出图和 TTS 提示词**永远英文**,那些引擎吃英文最稳
- **本 skill 不出图。**`image.sheet` 是给下游的版面指令,版面最容易崩的几处(一张图两个长相、
  为了塞细节把人物压扁、左栏收口)靠提示词里写死的几句压住,见 `references/sheet.md`
- 想要能实时编辑、边跑边看的交互界面,那是另一个东西,不在这个 skill 里

## 自测

```bash
node {baseDir}/scripts/selftest.mjs
```

329 项断言,不调模型、不花额度,覆盖分块 / 归并 / 合成 / 多语言 / 校验 / 渲染的全部确定性逻辑。改完脚本先跑这个。

## 自带样例

`{baseDir}/examples/渡口.txt` 是一篇短故事,4 个角色,其中货郎全程只有绰号、船夫只被叫过「老伯」——专门用来验别名归并。对应产出 `渡口-cast.json` / `渡口-cast.md` 可以当质量基准,也是校验的自检夹具。

토론

질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.

아직 글이 없어요. 처음으로 질문하거나 공유해 보세요.

이곳의 글은 사용자가 쓴 것으로, PopNx 팀의 글이 아니에요.

로그인하고 글쓰기

GitHub 정보

GitHub 스타
6,793
제작자
eternityspring
라이선스
Apache-2.0
최근 코드 수정
2026년 11월 9일
repo 안 SKILL.md(번역본과 템플릿 포함)
1