character-management

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Character Management

角色管理

Overview

概述

Create and manage rich character profiles for a story project. Each character is a markdown file with YAML frontmatter in the

characters/

directory. Characters are cross-referenced with other story elements through kebab-case identifiers.

为故事项目创建并管理内容丰富的角色档案。每个角色都是存放在

characters/

目录下的Markdown文件，带有YAML frontmatter。角色通过kebab-case格式的标识符与其他故事元素相互关联。

Prerequisites

前置要求

A story project must already exist (created via the story-init skill). Verify by checking for

story.md

in the project root.

必须已存在故事项目（通过story-init skill创建）。可通过检查项目根目录下是否存在

story.md

来验证。

Creating a Character

创建角色

Read
```
story.md
```
for genre, themes, and tone context
Read
```
characters/_index.md
```
for existing characters
Ask for the character's name and role (protagonist, antagonist, supporting, minor)
Build the profile through conversation, exploring:
- Appearance and distinguishing features
- Personality, traits, and quirks
- Backstory and formative events
- Motivations (external wants vs internal needs)
- Voice and speech patterns (ask for example dialogue)
- Character arc (starting state, turning points, ending state)
- Key life events for the timeline
Write the character file using the template in
```
references/character-template.md
```
Save to
```
characters/{name-kebab}.md
```
Update
```
characters/_index.md
```
registry table
If relationships reference existing characters, update those character files too

阅读
```
story.md
```
了解故事的题材、主题和基调背景
阅读
```
characters/_index.md
```
查看已有角色
询问用户角色的姓名和定位（主角、反派、配角、次要角色）
通过对话完善角色档案，梳理以下维度：
- 外貌和标志性特征
- 性格、特质和小怪癖
- 背景故事和成长关键事件
- 动机（外在目标 vs 内在需求）
- 语气和说话模式（可要求用户提供对话示例）
- 角色弧光（初始状态、转折点、最终状态）
- 时间线中的关键人生事件
使用
```
references/character-template.md
```
中的模板编写角色文件
保存到
```
characters/{name-kebab}.md
```
路径
更新
```
characters/_index.md
```
的登记表格
如果角色关系涉及已有角色，同时更新这些角色的文件

Updating a Character

更新角色

Read the existing character file
Read
```
characters/_index.md
```
for context on other characters
Make the requested changes
If relationships changed, update the other character's file (bidirectional)
Update
```
characters/_index.md
```
if role or status changed

读取现有的角色文件
阅读
```
characters/_index.md
```
了解其他角色的相关背景
按照用户要求进行修改
如果角色关系发生变动，同步更新关联角色的文件（双向同步）
如果角色定位或状态发生变动，更新
```
characters/_index.md
```

Managing Relationships

关系管理

Reference

references/relationship-types.md

for the full list of relationship types and inverse pairs.

When adding a relationship:

Add the relationship entry to the character's frontmatter
Add the inverse relationship to the other character's frontmatter
Update the Relationship Map section in
```
characters/_index.md
```

完整的关系类型和对应反向关系列表可参考

references/relationship-types.md

。

添加关系时：

在角色的frontmatter中添加关系条目
在关联角色的frontmatter中添加反向关系
更新
```
characters/_index.md
```
中的关系图谱部分

Family Trees

家谱

Family trees are maintained in the

characters/_index.md

under the "Family Trees" section. Format:

markdown

undefined

家谱维护在

characters/_index.md

的“家谱”板块下，格式如下：

markdown

undefined

Family Trees

{Family Name}

{Character Name} ({status}) - [{name-kebab}.md]
- {Child Name} - [{name-kebab}.md]
- {Child Name} - [{name-kebab}.md]


Indent children under parents. Note marriages/partnerships inline.

{Character Name} ({status}) - [{name-kebab}.md]
- {Child Name} - [{name-kebab}.md]
- {Child Name} - [{name-kebab}.md]


子辈缩进在父辈下方，在行内标注婚姻/伴侣关系。

Cross-Referencing

交叉引用

When a character is referenced in worldbuilding (e.g., a location's
```
notable-characters
```
), ensure the link exists both ways
When a character appears in a plot arc, ensure they're listed in the arc's
```
characters
```
frontmatter
Character tags should be consistent across the project (e.g., if
```
magic-user
```
is used, always use that exact tag)

当角色在世界观构建中被引用时（例如某个地点的
```
notable-characters
```
字段），确保双向都存在关联链接
当角色出现在某个剧情弧中时，确保他们被列在该剧情弧的
```
characters
```
frontmatter中
整个项目的角色标签需保持一致（例如如果使用了
```
magic-user
```
标签，后续要始终使用完全一致的标签）

Reference Files

参考文件

references/character-template.md
- Full blank template for character profiles
references/relationship-types.md
- Complete relationship type reference with inverse pairs

references/character-template.md
- 空白的完整角色档案模板
references/relationship-types.md
- 包含反向关系的完整关系类型参考