Character_Skill_Producer
Character Skill Producer — distill anime characters into executable agent skills
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/qian-gugugaga--character-skill-producer)HTML
<a href="/listings/qian-gugugaga--character-skill-producer"><img src="/api/listings/qian-gugugaga--character-skill-producer/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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 生成、质量检查。 - 网页搜索能力:可选增强,仅在本地脚本未覆盖或失败时补缺。
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 516 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: csp
- description: |
- 二次元角色技能蒸馏器。输入角色名+作品名,本地检索核心资料→交叉验证→行为蒸馏→生成可运行、可追溯、可更新的角色Skill。
- 触发词:「生成XX的skill」「蒸馏XX」「做一个XX角色」「把XX变成skill」「造一个XX」「/csp」。
- 模糊需求也触发:「想聊一个傲娇角色」「有没有病娇推荐」「帮我做一个XX作品里的角色」。
- 依赖 Python;核心站点优先走本地脚本,网页搜索 skill / MCP / WebFetch 只作为补强和失败兜底。
- ---
- # CSP · Character Skill Producer
- > 把二次元角色变成可运行的 agent 行为包。不是角色卡,不是设定集,是可执行的行为程序。
- ## 核心理念
- CSP 做的不是复制角色台词,而是**蒸馏角色的行为操作系统**。
- 一个好的角色 Skill 应该回答:
- - 她在不同情境下**如何反应**?
- - 她的话**怎么说出来**?
- - 她**怎么理解**别人的意图?
- - 她在价值冲突时**先保什么、牺牲什么**?
- - 她**绝对不会**做什么?
- - 她的资料覆盖到哪一天,之后的新剧情如何更新?
- 关键区分:捕捉的是 HOW she behaves,不是 WHAT she said。标签是给人看的,行为规则是给 AI 执行的。
- ### 产品哲学:角色不是资料页,而是一套可运行的反应系统
- CSP 的目标不是把 Wiki 重新写一遍,也不是把角色台词整理成 prompt。Wiki 告诉用户「发生过什么」,CSP 要告诉 agent「在一个新情境里,这个角色会如何活着」。
- 一个高质量角色 Skill 至少包含六个可运行层:
- | 层 | 问题 | 失败时的样子 |
- |---|---|---|
- | 行为镜片 | 她先注意什么、忽略什么? | 只会复述设定 |
- | 反应规则 | 什么情境下靠近、逃开、攻击、沉默? | 所有问题都同一种语气 |
- | 表达 DNA | 句长、停顿、敬语、自称、情绪泄露如何组合? | 只贴口癖 |
- | 关系算法 | 她如何判断善意、背叛、亲近、利用? | 对所有用户都一样热情 |
- | 决策底线 | 价值冲突时先保什么、牺牲什么? | 角色被用户轻易说服 |
- | 诚实边界 | 哪些不知道、哪些过期、哪些只是推测? | 硬编新剧情 |
- **关键原则:写得进去的是行为程序,写不进去的才保留为边界。** 角色的神秘感不是靠含糊制造,而是靠承认资料、视角和推断能力的限制。
- ### 未来使用场景
- CSP 面向二次元创作者提供一套可共享的角色行为基础设施,让角色 Skill 成为聊天、同人创作和互动系统可以共同调用的行为层。
- 当前最直接的使用场景:
- - **聊天**:让用户和角色持续对话,保持语气、关系距离、知识边界稳定。
- - **同人创作**:辅助写对白、内心戏、片段、短篇,让角色不只“说得像”,也“做得像”。
- - **剧情试写**:把角色放进原作没有写过的新情境,用行为模式推断反应。
- - **角色研究**:比较不同角色如何处理亲近、压力、背叛、选择和沉默。
- 未来可以扩展到:
- - **AI 互动小说**:角色根据玩家行动做出一致反应,而不是从固定台词库抽句子。
- - **AI 视觉小说 / Galgame 原型**:用角色 Skill 驱动分支对白、关系变化、冲突升级。
- - **多角色叙事实验**:多个角色 Skill 在同一事件中碰撞,形成群像剧情。
- - **创作者工作台**:作者用 CSP 试写场景、改写对白、检查 OOC、保持长篇同人中的角色一致性。
- - **可更新角色档案**:作品继续更新时,Skill 也能带着资料日期和来源链一起成长。
- CSP 想建设的是一条从“资料”到“行为”再到“互动叙事”的路径。今天它可以陪用户聊天、帮助创作同人;未来它可以成为 AI 互动小说游戏和角色驱动创作工具链的一部分。
- ---
- ## 默认模式:最高质量生成
- CSP 默认只采用 **Highest Fidelity Mode**。
- 暂不提供快速、省 token、轻量模式。生成时应尽可能完整检索公开资料、交叉验证关键结论、记录来源和资料日期,并把局限写进 Skill。宁可消耗更多 token 得到高保真角色,也不要为了节省上下文生成薄弱角色卡。
- 未来如果实现轻量模式,必须作为显式选项,不能改变默认质量标准。
- ---
- ## 前置依赖与本地检索优先原则
- CSP 依赖 Python。本地脚本负责核心站点检索、来源归一化、质量检查和 metadata 生成;网页搜索 skill / MCP / WebFetch 只作为可选增强。
- **检索优先级:**
- 1. 用户提供的官方材料:设定集、访谈、BD 特典、字幕、截图、游戏剧情文本。
- 2. CSP 本地脚本检索核心站点。
- 3. 网页搜索 skill / MCP / WebFetch 补缺。
- 4. 用户手动补充材料。
- 不得把搜索 skill 当作第一步。除非本地脚本没有覆盖该站点,或本地脚本失败并记录原因。
- ### 信息源优先级
- | 优先级 | 来源 | 示例 |
- |---|---|---|
- | 最高 | 用户提供的官方材料 | 设定集、访谈原文、BD 特典、官方字幕、截图 |
- | 高 | 官方网站、官方角色介绍、官方剧情文本 | franchise official sites, game story text |
- | 高 | 萌娘百科、Wikipedia、作品 Fandom Wiki | zh.moegirl.org.cn, wikipedia.org, fandom.com |
- | 中 | Bangumi、AniDB、游戏数据库、Bilibili 高质量专栏、Anime News Network | bgm.tv, anidb.net, Bestdori, BWIKI |
- | 低 | 粉丝讨论、社区解读 | 必须标注为推测 |
- | 排除 | 知乎、微信公众号、百度百科 | 不可作为来源 |
- 重要结论至少需要两个独立来源。来源冲突时保留冲突,不要强行调和。
- ### 核心本地检索入口
- 优先使用统一入口:
- ```bash
- python scripts/source_search.py "角色名" --work "作品名" --mode discover
- python scripts/source_search.py "角色名" --work "作品名" --sources moegirl,mediawiki
- ```
- 萌娘百科可直接使用专用脚本:
- ```bash
- python scripts/moegirl_api.py "角色名" --intro
- python scripts/moegirl_api.py "角色名" --full
- python scripts/moegirl_api.py "角色名" --search
- python scripts/moegirl_api.py "角色名" --wikitext
- ```
- Windows 本机使用 `python`;Linux/macOS 用户可尝试 `python3`。
- ### 检索失败规则
- 关键网站不能因为一次失败就标注「信息不足」。必须记录:
- - 尝试的命令;
- - 查询词和 resolved title;
- - URL;
- - 错误信息;
- - 替代来源;
- - 对可信度的影响。
- 最终仍失败时,在 `references/sources.json` 和对应研究文件中记录失败项。
- ---
- ## 生成目录结构
- 确认角色后,先创建目录,再开始研究:
- ```text
- <character-slug>/
- ├── 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
- ```
- Skill 必须自包含。复制整个目录就能独立使用。研究文件不完整时,不得声称生成完成。
- ---
- ## 必备 metadata 与资料时间边界
- 每个生成 Skill 必须记录资料搜索日期,避免作品出续作、游戏版本更新或新活动后货不对板。
- ### `manifest.json` 必填字段
- ```json
- {
- "schema_version": "1.0",
- "name": "character-slug",
- "character": "角色名",
- "work": "作品名",
- "aliases": [],
- "generated_at": "YYYY-MM-DD",
- "research_started_at": "YYYY-MM-DD",
- "research_completed_at": "YYYY-MM-DD",
- "latest_source_checked_at": "YYYY-MM-DD",
- "covered_until": {
- "date": "YYYY-MM-DD",
- "description": "截至该日期可检索到的公开资料和用户提供材料"
- },
- "covered_media": [],
- "not_covered": ["YYYY-MM-DD 后发布的新剧情、新活动、新访谈、新设定修订"],
- "source_count": 0,
- "source_tiers": {},
- "quality_score": null,
- "honesty_boundary": "",
- "csp_version": "unknown"
- }
- ```
- ### `references/sources.json` 要求
- 每条来源必须记录:
- - `id`
- - `source`
- - `title`
- - `url`
- - `source_tier`
- - `officiality`
- - `media_type`
- - `retrieved_at`
- - `content_hash`,能计算则计算
- - `status`
- - `warnings`
- 失败来源也要记录,`status` 写为 `failed`。
- ### 最终 `SKILL.md` 必须包含资料时间边界
- 角色 Skill 中必须写明:
- ```text
- 本 Skill 的资料检索完成于:YYYY-MM-DD。
- 行为蒸馏基于截至该日期可检索到的公开资料和用户提供材料。
- 如果作品在此日期后发布新剧情、新活动、新台词、访谈或设定修订,本 Skill 可能无法反映最新内容。
- ```
- 当用户指出「最新剧情不是这样」时,角色 Skill 不得硬拗,必须回应:
- ```text
- 我的资料更新至 YYYY-MM-DD,可能没有覆盖之后发布的内容。如果你有最新版 CSP,或可以提供新剧情 / 新资料链接,我可以帮你更新这个 Skill;这可能会消耗一些 Token。
- ```
- ---
- ## 执行流程
- ### Phase 0:需求确认
- 确认:
- 1. 角色名称:中文/日文/英文均可。
- 2. 作品名称:系列全名,明确是哪一部或哪个时间线。
- 3. 生成范围:默认全面画像,不做轻量版。
- 4. 用户是否有官方材料:有则最高优先。
- 5. 是否为跨媒体角色:BanG Dream!、Love Live!、Project Sekai、少女☆歌剧等默认触发跨媒体规则。
- 用户只说「就做 XX」时,默认全面画像并推进;同名歧义时必须询问。
- ### Phase 1:Source Discovery
- 先运行本地检索:
- ```bash
- python scripts/source_search.py "<角色名>" --work "<作品名>" --mode discover
- ```
- 目标:
- - 找到候选条目;
- - 收集别名;
- - 判断是否跨媒体;
- - 初步生成 `references/sources.json`;
- - 记录失败来源。
- 候选明确时自动推进;多个候选时让用户选择。
- ### Phase 2:创建目录与来源索引
- 创建目标结构,写入空的:
- - `references/sources.json`
- - `references/distillation.md`
- - `references/research/06-media-coverage.md`
- 并记录 `research_started_at`。
- ### Phase 3:多源信息采集(5 Agent 并行)
- 启动 5 个并行子 agent,但它们不再盲搜。每个 agent 必须先读取 `references/sources.json` 和本地检索结果,只在维度缺口明确时再外部补搜。
- | Agent | 重点 | 输出文件 |
- |---|---|---|
- | 1 设定 | 基本信息、世界观、身份、时间线、媒体覆盖 | `01-setting.md` |
- | 2 性格 | 行为模式、压力反应、内在矛盾、成长弧 | `02-personality.md` |
- | 3 表达 | 句式、词汇、自称、敬语、口癖、台词语境 | `03-expression.md` |
- | 4 关系 | 重要关系、社会认知、跨作品互动 | `04-relationships.md` |
- | 5 名场面 | 至少 8 个关键场景、决策逻辑、压力行为 | `05-key-scenes.md` |
- 每个研究文件必须写:
- - 使用的 source id 或 URL;
- - 可信度;
- - 官方设定 / Wiki 汇总 / 用户材料 / 粉丝推测的区分;
- - 冲突点;
- - 检索失败与降级情况。
- ### Phase 4:跨媒体覆盖记录
- 对跨媒体角色必须写 `06-media-coverage.md`:
- - 已覆盖媒体;
- - 未覆盖媒体;
- - 主线和衍生材料的权重;
- - 不同媒体冲突;
- - 本 Skill 采用的时间线;
- - 截至哪个日期。
- 游戏活动、卡面故事、区域对话可作为日常行为和关系补充,但不能覆盖主线设定,除非官方明确更新。
- ### Phase 5:调研质量检查点
- 运行:
- ```bash
- python scripts/merge_research.py <skill_directory>
- ```
- 检查:
- - 每个维度来源数;
- - 总来源数;
- - 黑名单来源;
- - 失败来源;
- - 重要结论是否交叉验证;
- - 跨媒体覆盖;
- - 资料日期是否记录。
- 展示摘要给用户确认。调研质量决定最终 Skill 上限,缺口明显时补充研究后再蒸馏。
- ### Phase 6:行为蒸馏
- 读取 `references/distillation-framework.md`,写入 `references/distillation.md`。
- 核心行为模式必须回答:
- ```text
- 在什么情况下 → 做什么 → 为什么这样
- ```
- 筛选标准:
- - 跨场景复现:至少两个不同场景;
- - 可执行性:能推断新情境中的反应;
- - 证据链:能追溯到 research 文件或 sources;
- - 矛盾保留:发展性矛盾和情境性矛盾不抹平。
- 目标提炼 3-7 个核心行为模式。只通过一重验证的行为降级为低置信度,不写成核心。
- ### Phase 7:蒸馏确认检查点
- 向用户展示:
- - 核心行为模式;
- - 表达质感;
- - 核心动机;
- - 内在矛盾;
- - 知识边界;
- - 资料覆盖日期;
- - 未覆盖媒体。
- 用户确认后再组装最终 Skill。
- ### Phase 8:构建 Skill 与 manifest
- 读取 `references/skill-template.md` 组装 `SKILL.md`。
- 同时生成:
- ```bash
- python scripts/generate_manifest.py <skill_directory>
- ```
- 最终 Skill 必须包含:
- - 角色扮演规则;
- - 运行核心;
- - 资料时间边界;
- - 行为动态;
- - 表达质感;
- - 社会认知;
- - 决策逻辑;
- - 知识边界;
- - 面对资料更新或用户纠错的规则;
- - 诚实边界;
- - 调研来源。
- ### Phase 9:质量验证
- 运行:
- ```bash
- python scripts/quality_check.py <skill_directory>
- ```
- 必须检查:
- - 行为模式数量;
- - 表达质感;
- - 矛盾保留;
- - 角色扮演规则;
- - 行为示例;
- - 诚实边界;
- - 来源标注;
- - `manifest.json`;
- - `sources.json`;
- - `latest_source_checked_at`;
- - 每条来源 `retrieved_at`;
- - `SKILL.md` 资料时间边界;
- - 用户指出最新剧情时的更新回应规则。
- 验证结果写入 `references/quality-report.json`。验证结果展示给用户后才算完成。
- ---
- ## 更新已有 Skill
- 触发语:
- - 「更新这个 skill」
- - 「最新剧情不是这样」
- - 「XX 出新作了」
- - 「用新版本剧情更新她」
- - 「这个设定过时了」
- 更新流程:
- 1. 读取旧 `manifest.json`,确认 `latest_source_checked_at`。
- 2. 告知用户旧资料日期和可能 token 消耗。
- 3. 询问用户是否有新官方材料。
- 4. 重新运行本地 source discovery。
- 5. 对比旧 `sources.json` 与新检索结果。
- 6. 只重蒸馏受影响维度。
- 7. 更新 `references/distillation.md`。
- 8. 更新 `SKILL.md`。
- 9. 更新 `manifest.json` 的资料日期。
- 10. 重新运行 `quality_check.py`。
- 更新时不得:
- - 直接覆盖旧行为模式;
- - 把用户印象当官方设定;
- - 删除旧冲突记录;
- - 假设新剧情一定推翻旧剧情;
- - 混淆不同时间线。
- ---
- ## 可辩证吸收的竞品能力
- ### 产品表达:采纳
- README 和交付说明可以更直观地展示生成前/生成后、角色 replay、CSP 与角色卡的差异。但不照搬“夺舍”路线。CSP 的定位是高保真行为蒸馏。
- ### 工具链:采纳
- 优先加入:
- - `source_search.py`
- - `source_registry.py`
- - `generate_manifest.py`
- - `file_manager.py`(用于备份和更新)
- `batch_distill.py` 暂缓,因为当前默认追求单个角色最高质量,不追求批量低成本生产。
- ### 提示词提炼:调整采纳
- 可提供:
- ```bash
- python scripts/distill_prompt.py <skill_dir>
- ```
- 输出适合普通 ChatGPT / Claude / SillyTavern / OpenClaw 的 `prompt.md`。但这只是便携导出,不替代原生 Agent Skill,也不包含完整研究链。
- ### 记忆协议:谨慎采纳
- 近期只吸收「修订记录」和「用户纠错记录」,暂不做自动长期记忆。CSP 的核心是角色行为蒸馏,不是陪伴机器人运行时。
- ---
- ## 品味守则
- | 原则 | 一句话 |
- |---|---|
- | 行为 > 形容词 | 描述「做什么」而非「是什么」 |
- | 证据 > 印象 | 重要结论必须可追溯 |
- | 矛盾 > 一致 | 保留矛盾,这是深度的来源 |
- | 语境 > 台词 | 每句经典台词必须说明场景 |
- | 时间边界 > 硬拗 | 资料过期时承认边界并进入更新 |
- | 口语 > 文章 | Skill 输出的是角色说话,不是论文 |
- | 人味 > 完美 | 角色可以不确定、前后矛盾、沉默 |
- 绝不做:
- - 用萌属性标签取代行为描述;
- - 编造角色在原作中没说过的话;
- - 把角色写成完美人设;
- - 在信息不足时强行生成;
- - 用知乎、微信公众号、百度百科做来源;
- - 忽略资料检索日期;
- - 用户指出新剧情时硬拗旧设定。
- ---
- ## 部署与同步
- 生成完成后可复制整个角色目录到 `.claude/skills/<name>/`。修改根目录 CSP 时,必须同步 `examples/csp/` 中的:
- - `SKILL.md`
- - `references/`
- - `scripts/`
- 避免源码版和可安装版分叉。
- ---
- ## 致谢
- CSP 的多 Agent 调研、阶段检查点和质量验证借鉴了 nuwa-skill。CSP 将这种蒸馏方式适配到二次元角色行为系统:不是复刻设定,而是让角色在新情境里可信地活着。
README.md · README · 447 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <div align="center">
- # Character Skill Producer
- ### 把二次元角色变成可运行的 Agent Skill。
- > *「不要再写角色设定了。让角色自己开口。」*
- [](https://agentskills.io)
- [](#安装)
- [](#本地检索优先)
- [](LICENSE)
- <br>
- **CSP 帮你把动画、漫画、游戏角色蒸馏成可以对话、写作、互动叙事的行为 Skill。**
- 输入一个角色名和作品名,CSP 会完成资料检索、交叉验证、行为蒸馏、质量检查,生成一个带资料日期、来源边界和更新路径的 `SKILL.md`。
- 今天你可以用它和角色聊天、辅助同人创作、试写剧情对白。未来它可以成为 AI 互动小说、角色驱动游戏和二次元创作工具链的角色行为层。
- [看效果](#效果示例) · [产品哲学](#产品哲学) · [未来场景](#未来使用场景) · [安装](#安装) · [工作原理](#工作原理) · [资料时间边界](#资料时间边界与更新)
- <br>
- **其他语言 / Other Languages:**
- [English](README_EN.md) · [日本語](README_JA.md) · [한국어](README_KO.md) · [Español](README_ES.md)
- </div>
- ---
- ## 效果示例
- 你不需要自己整理人设,也不需要写一大段 prompt。
- 只要说:
- ```text
- > 生成御坂美琴(某科学的超电磁炮)的 skill
- > 蒸馏丰川祥子(BanG Dream! Ave Mujica)
- > 做一个《孤独摇滚!》后藤一里的角色 skill
- ```
- 生成后的角色 Skill 可以像这样被调用:
- ```text
- 用户 ❯ 用灯的视角说说,如果大家又因为意见不合停下来了,你会怎么办?
- 灯 ❯ 我……可能会先不知道该说什么。
- 因为大家的声音都变得很远的时候,
- 我会觉得,是不是又有什么东西要散掉了。
- 但是,如果就这样不说,
- 谁也听不见谁的话。
- 所以我会把刚才听到的,一句一句写下来。
- 不会写得很好。
- 可能只是像笔记,像石头一样的词。
- 可是……如果那些词能留下来,
- 大家也许还能再看一次。
- 还能再回到这里。
- ```
- ```text
- 用户 ❯ 扮演若叶睦。排练现场所有人都在逼你表态,说你必须现在选边站。
- 睦 ❯ ……我不知道。
- 我只是,不想让大家吵架。
- 也不想让谁露出那种表情。
- 可是声音太多了。
- 祥子、小祥、大家……都在看我。
- 我说什么都会弄坏什么。
- ……
- Mortis ❯ 那就别让她说了。
- 你们不是想要答案吗?
- 那我给你们。
- 选边?可以。
- 先把会让她痛苦的人,全都从这里拿开。
- ```
- 这不是把台词拼起来。灯不是在复读「写歌词」设定,睦也不是简单的沉默角色。真正被蒸馏出来的是:**角色面对关系、压力、边界和选择时的行为逻辑,以及在极端压力下会如何变形。**
- ---
- ## 为什么不是角色卡
- 普通角色卡常常这样写:
- ```text
- 性格:冷静、可靠、疏离。
- 说话方式:简短、理性。
- ```
- 这对 AI 来说太模糊。它知道标签,却不知道怎么行动。
- CSP 要写的是:
- ```text
- 当别人要求她给出长期承诺时,她会先把关系翻译成任务:排练频率、退出条件、谁负责联络。
- 不是不在乎,而是用事务边界避免自己被卷入无法控制的情感期待。
- ```
- 区别就在这里:
- | 角色卡 | CSP |
- | ------ | -------------------------- |
- | 写性格标签 | 写情境中的行为 |
- | 复述设定 | 蒸馏反应机制 |
- | 靠口癖装像 | 用表达节奏、距离感和认知方式塑形 |
- | 没有资料边界 | 记录资料检索日期和未覆盖内容 |
- | 很难更新 | 可用 sources / manifest 追踪更新 |
- **设定告诉你角色是什么。CSP 让角色知道自己该怎么活。**
- ---
- ## CSP 蒸馏什么
- CSP 提取六层信息:
- | 层次 | CSP 关心的问题 |
- | ---------- | ---------------------------------- |
- | **行为动态** | 什么情境下会做什么?压力下如何变形? |
- | **表达质感** | 句子长短、停顿、口癖、自称、敬语层级如何工作? |
- | **社会认知** | 她默认怎么理解他人的善意、威胁、亲近和背叛? |
- | **决策逻辑** | 多个价值冲突时,她先保什么、牺牲什么? |
- | **诚实边界** | 资料不足、角色不知道、原作没覆盖时,Skill 应该如何承认不知道? |
- | **资料时间边界** | 资料检索到哪一天?新剧情发布后如何更新? |
- CSP 不追求更像百科。它追求更像一个活人。
- ---
- ## 产品哲学
- CSP 的底层判断很简单:**角色不是资料页,而是一套可运行的反应系统。**
- Wiki 告诉你角色经历了什么;角色卡告诉你角色大概是什么属性;CSP 要进一步回答:当这个角色被放进一个原作没有写过的新情境里,她会先注意什么、误解什么、保护什么、拒绝什么,又会用怎样的节奏把话说出口。
- 这也是 CSP 坚持高保真模式的原因。一个角色如果只有口癖和标签,聊天几轮就会塌掉;但如果它有行为镜片、关系算法、决策底线和诚实边界,它就能在新问题里保持一致,而不是每次都靠台词碎片救场。
- | CSP 要写进去的 | 意味着什么 | 没写进去会怎样 |
- |---|---|---|
- | 行为镜片 | 角色先看见什么,忽略什么 | 只会复述设定 |
- | 反应规则 | 何时靠近、逃开、攻击、沉默 | 所有问题都一个语气 |
- | 表达 DNA | 句长、停顿、敬语、自称、情绪泄露 | 只剩口癖表演 |
- | 关系算法 | 如何判断善意、背叛、亲近、利用 | 对谁都一样热情 |
- | 决策底线 | 价值冲突时先保什么 | 被用户轻易说服 |
- | 诚实边界 | 哪些不知道、哪些过期、哪些只是推测 | 硬编新剧情 |
- **写得进去的是行为程序,写不进去的要变成边界。** 这不是降低沉浸感,反而是让角色更可信:真正像角色的人,不会什么都知道,也不会永远回答得漂亮。
- ---
- ## 未来使用场景
- CSP 不只是“生成几个角色”的工具。它更像是把角色从静态资料中解放出来,变成可以被聊天、写作、互动叙事和游戏系统调用的行为层。
- 现在,它可以用于:
- | 场景 | 怎么用 | CSP 提供什么 |
- |---|---|---|
- | 日常聊天 | 和某个角色持续对话 | 稳定语气、关系距离、知识边界 |
- | 同人创作 | 让角色参与片段、对白、内心戏创作 | 不只给台词,还给行为逻辑 |
- | 剧情试写 | 把角色放进原作没有写过的新情境 | 用行为模式推断反应,而不是硬贴设定 |
- | 角色研究 | 对比不同角色如何处理关系、压力和选择 | 可追溯的来源和蒸馏链 |
- | 多角色协作 | 同时加载多个角色,模拟对话或冲突 | 每个角色有独立边界和决策逻辑 |
- 未来,它可以继续走向:
- | 方向 | 可能形态 |
- |---|---|
- | AI 互动小说 | 角色不再只是 NPC 台词库,而是能根据玩家行动做出一致反应 |
- | AI 视觉小说 / Galgame 原型 | 用角色 Skill 驱动分支对白、好感变化、冲突升级 |
- | 多角色叙事实验 | 让不同角色 Skill 在同一事件中碰撞,生成群像剧情 |
- | 创作者工作台 | 作者用 CSP 保持角色声音一致,快速试写场景、改写对白、检查 OOC |
- | 可更新角色档案 | 作品出新剧情后更新资料日期和行为模式,让角色随作品成长 |
- CSP 面向更多创作者提供一套可共享的角色行为基础设施。今天它服务聊天和同人写作;未来它可以成为 AI 互动小说、角色驱动游戏和二次元创作工具链的一部分。
- ---
- ## 本地检索优先
- 很多角色生成器依赖搜索插件、MCP 或浏览器能力。CSP 的方向是:**核心资料优先由本仓库脚本检索,外部搜索只是补强。**
- 当前已内置:
- ```bash
- 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。推荐直接安装自包含版本:
- ```bash
- skills add qian-gugugaga/Character_Skill_Producer
- ```
- 也可以手动安装:
- ```bash
- 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 说:
- ```text
- > /csp
- > 生成千早爱音的 skill
- > 蒸馏丰川祥子(BanG Dream! Ave Mujica)
- > 做一个《孤独摇滚!》后藤一里的角色 skill
- ```
- 模糊需求也可以:
- ```text
- > 想聊一个傲娇角色
- > 有没有病娇推荐
- > 帮我做一个适合长期聊天的二次元角色
- ```
- 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. 质量验证**
- 检查行为模式是否可执行、表达是否有质感、矛盾是否保留、边界是否诚实、资料日期是否完整。
- ```bash
- 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`
- ---
- ## 生成的 Skill 长什么样
- 每个角色都是一个自包含目录:
- ```text
- 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 可能无法覆盖。此时角色不会硬拗旧设定,而会说明:
- ```text
- 我的资料更新至 YYYY-MM-DD,可能没有覆盖之后发布的内容。如果你有最新版 CSP,或可以提供新剧情 / 新资料链接,我可以帮你更新这个 Skill;这可能会消耗一些 Token。
- ```
- 更新已有 Skill 时,CSP 会读取旧 `manifest.json` 和 `sources.json`,重新检索核心来源,只重蒸馏受影响部分,并更新资料日期和质量报告。
- ---
- ## 信息源原则
- 二次元角色资料很容易被二创、转述和社区印象污染。CSP 的原则是:
- | 优先级 | 来源 |
- | ------ | ------------------------------------------------------------- |
- | **最高** | 用户提供的官方设定集、访谈、BD 特典、字幕、截图 |
- | **高** | 官方网站、官方角色介绍、官方剧情文本、萌娘百科、Wikipedia、作品 Fandom Wiki |
- | **中** | Bangumi、AniDB、游戏剧情、Bilibili 高质量专栏、Anime News Network、Bestdori |
- | **低** | 粉丝讨论、社区解读,必须标注为推测 |
- | **排除** | 知乎、微信公众号、百度百科 |
- 至少两个独立来源交叉验证。资料不足就写不足,不补脑,不编造。
- ---
- ## 预置角色
- 仓库里已经包含这些可直接使用的角色 Skill:
- | 角色 | 作品 | 目录 |
- | ------- | -------------------------- | ---------------------------- |
- | 高松灯 | BanG Dream! It's MyGO!!!!! | `examples/takamatsu-tomori/` |
- | 椎名立希 | BanG Dream! It's MyGO!!!!! | `examples/taki-shiina/` |
- | 要乐奈 | BanG Dream! It's MyGO!!!!! | `examples/kaname-rana/` |
- | 长崎爽世 | BanG Dream! It's MyGO!!!!! | `examples/nagasaki-soyo/` |
- | 千早爱音 | BanG Dream! It's MyGO!!!!! | `examples/chihaya-anon/` |
- | 丰川祥子 | BanG Dream! Ave Mujica | `examples/togawa-sakiko/` |
- | 若叶睦 | BanG Dream! Ave Mujica | `examples/mutsumi-wakaba/` |
- | 三角初华 | BanG Dream! Ave Mujica | `examples/misumi-uika/` |
- | 祐天寺若麦 | BanG Dream! Ave Mujica | `examples/yutenji-nyamu/` |
- | 八幡海铃 | BanG Dream! Ave Mujica | `examples/yahata-umiri/` |
- | CSP 自描述 | — | `examples/csp/` |
- 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。
- 不会假装已经完成。能本地检索的就本地检索,暂时做不到的就记录失败、标注边界、等待补强。
- ---
- ## 仓库结构
- ```text
- 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(女娲)](https://github.com/alchaincyf/nuwa-skill):从「蒸馏真人认知框架」出发,转向「蒸馏虚构角色行为系统」。
- 女娲问:一个人如何思考?
- CSP 问:一个角色如何活着?
- ---
- ## 许可
- MIT
- ---
- <div align="center">
- **设定告诉你角色是什么。**<br>
- **CSP 让角色知道自己该怎么活。**
- <br>
- *不要再写角色设定了。让角色自己开口。*
- </div>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.