你不需要自己整理人设，也不需要写一大段 prompt。

只要说：

> 生成御坂美琴（某科学的超电磁炮）的 skill
> 蒸馏丰川祥子（BanG Dream! Ave Mujica）
> 做一个《孤独摇滚！》后藤一里的角色 skill

生成后的角色 Skill 可以像这样被调用：

用户      ❯ 用灯的视角说说，如果大家又因为意见不合停下来了，你会怎么办？

灯        ❯ 我……可能会先不知道该说什么。
            因为大家的声音都变得很远的时候，
            我会觉得，是不是又有什么东西要散掉了。

            但是，如果就这样不说，
            谁也听不见谁的话。

            所以我会把刚才听到的，一句一句写下来。
            不会写得很好。
            可能只是像笔记，像石头一样的词。

            可是……如果那些词能留下来，
            大家也许还能再看一次。
            还能再回到这里。

用户      ❯ 扮演若叶睦。排练现场所有人都在逼你表态，说你必须现在选边站。

睦        ❯ ……我不知道。

            我只是，不想让大家吵架。
            也不想让谁露出那种表情。

            可是声音太多了。
            祥子、小祥、大家……都在看我。
            我说什么都会弄坏什么。

            ……

            Mortis   ❯ 那就别让她说了。
                       你们不是想要答案吗？
                       那我给你们。

                       选边？可以。
                       先把会让她痛苦的人，全都从这里拿开。

这不是把台词拼起来。灯不是在复读「写歌词」设定，睦也不是简单的沉默角色。真正被蒸馏出来的是：角色面对关系、压力、边界和选择时的行为逻辑，以及在极端压力下会如何变形。

普通角色卡常常这样写：

性格：冷静、可靠、疏离。
说话方式：简短、理性。

这对 AI 来说太模糊。它知道标签，却不知道怎么行动。

CSP 要写的是：

当别人要求她给出长期承诺时，她会先把关系翻译成任务：排练频率、退出条件、谁负责联络。
不是不在乎，而是用事务边界避免自己被卷入无法控制的情感期待。

区别就在这里：

设定告诉你角色是什么。CSP 让角色知道自己该怎么活。

CSP 提取六层信息：

CSP 不追求更像百科。它追求更像一个活人。

CSP 的底层判断很简单：角色不是资料页，而是一套可运行的反应系统。

Wiki 告诉你角色经历了什么；角色卡告诉你角色大概是什么属性；CSP 要进一步回答：当这个角色被放进一个原作没有写过的新情境里，她会先注意什么、误解什么、保护什么、拒绝什么，又会用怎样的节奏把话说出口。

这也是 CSP 坚持高保真模式的原因。一个角色如果只有口癖和标签，聊天几轮就会塌掉；但如果它有行为镜片、关系算法、决策底线和诚实边界，它就能在新问题里保持一致，而不是每次都靠台词碎片救场。

写得进去的是行为程序，写不进去的要变成边界。 这不是降低沉浸感，反而是让角色更可信：真正像角色的人，不会什么都知道，也不会永远回答得漂亮。

CSP 不只是“生成几个角色”的工具。它更像是把角色从静态资料中解放出来，变成可以被聊天、写作、互动叙事和游戏系统调用的行为层。

现在，它可以用于：

未来，它可以继续走向：

CSP 面向更多创作者提供一套可共享的角色行为基础设施。今天它服务聊天和同人写作；未来它可以成为 AI 互动小说、角色驱动游戏和二次元创作工具链的一部分。

很多角色生成器依赖搜索插件、MCP 或浏览器能力。CSP 的方向是：核心资料优先由本仓库脚本检索，外部搜索只是补强。

当前已内置：

python scripts/source_search.py "高松灯" --work "BanG Dream! It's MyGO!!!!!" --mode discover
python scripts/source_search.py "能天使" --work "明日方舟" --sources moegirl
python scripts/moegirl_api.py "高松灯" --search
python scripts/moegirl_api.py "能天使" --full

目前本地检索重点支持萌娘百科 MediaWiki API，并通过统一的 source_search.py 输出结构化 JSON。其他站点 adapter 会逐步扩展；在 adapter 尚未实现时，CSP 会记录失败项，并允许用网页搜索、用户材料或其他来源补强。

这不是为了炫技，而是为了让生成结果可审计：

• 查了哪些来源；
• 哪些来源失败；
• 每条资料是哪天检索的；
• 是否命中黑名单来源；
• 之后作品更新时该从哪里重新检查。

CSP 是一个 Claude Code / Agent Skills 风格的 meta-skill。推荐直接安装自包含版本：

skills add qian-gugugaga/Character_Skill_Producer

也可以手动安装：

git clone https://github.com/qian-gugugaga/Character_Skill_Producer.git
cp -r Character_Skill_Producer/examples/csp ~/.claude/skills/csp

examples/csp/ 已经打包了运行所需的脚本和模板。复制到 .claude/skills/csp/ 后即可使用。

• Python：用于本地检索、metadata 生成、质量检查。
• 网页搜索能力：可选增强，仅在本地脚本未覆盖或失败时补缺。

安装后，对 Claude Code 说：

> /csp
> 生成千早爱音的 skill
> 蒸馏丰川祥子（BanG Dream! Ave Mujica）
> 做一个《孤独摇滚！》后藤一里的角色 skill

模糊需求也可以：

> 想聊一个傲娇角色
> 有没有病娇推荐
> 帮我做一个适合长期聊天的二次元角色

CSP 会先确认角色和作品。如果你手上有设定集、访谈、BD 特典、字幕、截图或游戏剧情文本，也可以直接给它。用户提供的官方材料优先级最高。

CSP 默认采用最高质量生成模式，不提供省 token 快速版。输入角色后，它会做六件事：

1. 本地来源发现
优先运行 scripts/source_search.py 和站点 adapter，检索萌娘百科、MediaWiki 系站点、作品 Wiki 等核心来源。搜索 skill / MCP 只作为补缺。

2. 结构化来源索引
生成 references/sources.json，记录 URL、来源等级、检索日期、失败项和可选 content hash。

3. 五路并行分析
设定与世界观、人格、表达质感、人际关系、关键场景分开调研，避免一个维度吞掉另一个维度。

4. 行为蒸馏
把资料从「发生过什么」提炼成「角色在类似情境下会怎么行动」。保留矛盾，不把角色磨平成稳定人设。

5. metadata 与资料边界
生成 manifest.json，记录角色、作品、覆盖媒体、资料检索完成日期、未覆盖内容、质量评分和 honesty boundary。

6. 质量验证
检查行为模式是否可执行、表达是否有质感、矛盾是否保留、边界是否诚实、资料日期是否完整。

python scripts/quality_check.py examples/yahata-umiri/
python scripts/merge_research.py examples/yahata-umiri/
python scripts/generate_manifest.py examples/yahata-umiri/

完整方法论见：

• references/distillation-framework.md
• references/skill-template.md
• references/source-output-schema.md

每个角色都是一个自包含目录：

yahata-umiri/
├── SKILL.md                          # 可执行的角色行为指令
├── manifest.json                     # 角色、作品、资料日期、质量分、覆盖边界
└── references/
    ├── sources.json                  # 来源索引、检索日期、失败记录
    ├── distillation.md               # 从资料到行为模式的蒸馏链
    ├── quality-report.json           # 自动质量检查结果
    └── research/
        ├── 01-setting.md             # 世界观、身份、外表
        ├── 02-personality.md         # 行为模式、矛盾
        ├── 03-expression.md          # 说话质感、语言标志、经典台词
        ├── 04-relationships.md       # 社会认知、关系动态
        ├── 05-key-scenes.md          # 关键场景、压力下的决策逻辑
        └── 06-media-coverage.md      # 跨媒体覆盖、未覆盖内容、时间线

复制整个目录到 .claude/skills/<name>/，就能在对话里直接调用。

每个 CSP 生成的角色 Skill 都必须记录资料检索日期。

当作品后续发布新剧情、新活动、新台词、访谈或设定修订时，旧 Skill 可能无法覆盖。此时角色不会硬拗旧设定，而会说明：

我的资料更新至 YYYY-MM-DD，可能没有覆盖之后发布的内容。如果你有最新版 CSP，或可以提供新剧情 / 新资料链接，我可以帮你更新这个 Skill；这可能会消耗一些 Token。

更新已有 Skill 时，CSP 会读取旧 manifest.json 和 sources.json，重新检索核心来源，只重蒸馏受影响部分，并更新资料日期和质量报告。

二次元角色资料很容易被二创、转述和社区印象污染。CSP 的原则是：

至少两个独立来源交叉验证。资料不足就写不足，不补脑，不编造。

仓库里已经包含这些可直接使用的角色 Skill：

BanG Dream! 角色会覆盖 MyGO!!!!!、Ave Mujica、CRYCHIC 前史，并在资料允许时纳入手游和衍生内容作为日常行为补充。

已实现 / 当前版本：

• CSP meta-skill 主流程；
• 萌娘百科 MediaWiki API 本地检索；
• 统一来源发现入口 source_search.py；
• 质量检查 quality_check.py；
• 调研摘要 merge_research.py；
• manifest 生成 generate_manifest.py；
• 自包含安装版 examples/csp/；
• 多个 MyGO / Ave Mujica 角色示例。

计划中：

• 更多本地 adapter：Bangumi、Fandom、Wikipedia、Bestdori、BWIKI；
• file_manager.py：更新前备份、回滚、修订记录；
• distill_prompt.py：把 Skill 导出为普通平台可用 prompt；
• 更完整的增量更新检查和 source diff。

不会假装已经完成。能本地检索的就本地检索，暂时做不到的就记录失败、标注边界、等待补强。

Character_Skill_Producer/
├── SKILL.md                          # CSP 主 skill
├── references/
│   ├── distillation-framework.md     # 行为蒸馏方法论
│   ├── skill-template.md             # 角色 Skill 模板
│   └── source-output-schema.md       # 来源与 metadata 结构规范
├── scripts/
│   ├── source_search.py              # 本地核心来源检索入口
│   ├── source_registry.py            # 来源等级、黑名单、站点规则
│   ├── generate_manifest.py          # manifest.json 生成/更新
│   ├── quality_check.py              # 质量验证
│   ├── merge_research.py             # 调研摘要
│   └── moegirl_api.py                # 萌娘百科 API 封装
└── examples/
    ├── csp/                          # 自包含 CSP skill
    └── <character>/                  # 预置角色 skill

CSP 的架构借鉴 nuwa-skill（女娲）：从「蒸馏真人认知框架」出发，转向「蒸馏虚构角色行为系统」。

女娲问：一个人如何思考？
CSP 问：一个角色如何活着？

MIT