name: writer-memory description: 作家代理式记忆系统 - 跟踪角色、关系、场景和主题 argument-hint: “init|char|rel|scene|query|validate|synopsis|status|export [args]”
作家记忆 - 代理式记忆系统 for 作家
持久记忆系统，专为创意作家设计，特别支持韩国故事创作工作流。
概述
作家记忆在克劳德会话之间维护上下文，服务小说作家。它跟踪：
- 角色 (캐릭터): 情感弧线 (감정궤도)、态度 (태도)、对话语调 (대사톤)、说话等级
- 世界 (세계관): 设定、规则、氛围、约束
- 关系 (관계): 角色动态和随时间演变
- 场景 (장면): 镜头构成 (컷구성)、叙述语调、情感标签
- 主题 (테마): 情感主题 (정서테마)、作者意图
所有数据保存在 .writer-memory/memory.json 中，便于git友好的协作。
命令
| 命令 | 动作 |
|---|---|
/oh-my-claudecode:writer-memory init <project-name> |
初始化新项目记忆 |
/oh-my-claudecode:writer-memory status |
显示记忆概览（角色数、场景数等） |
/oh-my-claudecode:writer-memory char add <name> |
添加新角色 |
/oh-my-claudecode:writer-memory char <name> |
查看角色详情 |
/oh-my-claudecode:writer-memory char update <name> <field> <value> |
更新角色字段 |
/oh-my-claudecode:writer-memory char list |
列出所有角色 |
/oh-my-claudecode:writer-memory rel add <char1> <char2> <type> |
添加关系 |
/oh-my-claudecode:writer-memory rel <char1> <char2> |
查看关系 |
/oh-my-claudecode:writer-memory rel update <char1> <char2> <event> |
添加关系事件 |
/oh-my-claudecode:writer-memory scene add <title> |
添加新场景 |
/oh-my-claudecode:writer-memory scene <id> |
查看场景详情 |
/oh-my-claudecode:writer-memory scene list |
列出所有场景 |
/oh-my-claudecode:writer-memory theme add <name> |
添加主题 |
/oh-my-claudecode:writer-memory world set <field> <value> |
设置世界属性 |
/oh-my-claudecode:writer-memory query <question> |
自然语言查询记忆（支持韩语） |
/oh-my-claudecode:writer-memory validate <character> <dialogue> |
检查对话是否匹配角色语调 |
/oh-my-claudecode:writer-memory synopsis |
生成情感聚焦的摘要 |
/oh-my-claudecode:writer-memory export |
以可读的markdown格式导出完整记忆 |
/oh-my-claudecode:writer-memory backup |
创建手动备份 |
记忆类型
角色记忆 (Character Memory)
跟踪对一致刻画至关重要的个体角色属性：
| 字段 | 韩语 | 描述 |
|---|---|---|
arc |
감정궤도 | 情感旅程（例如：“체념 -> 욕망자각 -> 선택”） |
attitude |
태도 | 当前对生活/他人的态度 |
tone |
대사톤 | 对话风格（例如：“담백”, “직설적”, “회피적”） |
speechLevel |
말투 레벨 | 正式性：반말, 존댓말, 해체, 혼합 |
keywords |
핵심 단어 | 他们使用的特征性词语/短语 |
taboo |
금기어 | 他们永远不会说的词语/短语 |
emotional_baseline |
감정 기준선 | 默认情感状态 |
triggers |
트리거 | 引发情感反应的因素 |
示例：
/writer-memory char add 새랑
/writer-memory char update 새랑 arc "체념 -> 욕망자각 -> 선택"
/writer-memory char update 새랑 tone "담백, 현재충실, 감정억제"
/writer-memory char update 새랑 speechLevel "해체"
/writer-memory char update 새랑 keywords "그냥, 뭐, 괜찮아"
/writer-memory char update 새랑 taboo "사랑해, 보고싶어"
世界观记忆 (World Memory)
建立您的故事所居住的宇宙：
| 字段 | 韩语 | 描述 |
|---|---|---|
setting |
배경 | 时间、地点、社会背景 |
rules |
규칙 | 世界运作方式（魔法系统、社会规范） |
atmosphere |
분위기 | 整体情绪和基调 |
constraints |
제약 | 在这个世界中不能发生的事情 |
history |
역사 | 相关的背景故事 |
关系记忆 (Relationship Memory)
捕获角色间随时间变化的动态：
| 字段 | 描述 |
|---|---|
type |
基本关系：浪漫、家庭、友谊、竞争、职业 |
status |
当前状态：萌芽、稳定、紧张、破裂、愈合 |
power_dynamic |
谁占上风，如果有的话 |
events |
关系改变时刻的时间线 |
tension |
当前未解决的冲突 |
intimacy_level |
情感亲密程度（1-10） |
示例：
/writer-memory rel add 새랑 해랑 romantic
/writer-memory rel update 새랑 해랑 "첫 키스 - 새랑 회피"
/writer-memory rel update 새랑 해랑 "해랑 고백 거절당함"
/writer-memory rel update 새랑 해랑 "새랑 먼저 손 잡음"
场景记忆 (Scene Memory)
跟踪个体场景及其情感架构：
| 字段 | 韩语 | 描述 |
|---|---|---|
title |
제목 | 场景标识符 |
characters |
등장인물 | 谁出现 |
location |
장소 | 发生地点 |
cuts |
컷 구성 | 逐镜头分解 |
narration_tone |
내레이션 톤 | 叙述声音风格 |
emotional_tag |
감정 태그 | 主要情感（例如：“설렘+불안”） |
purpose |
목적 | 这个场景在故事中存在的目的 |
before_after |
전후 변화 | 对角色前后的变化 |
主题记忆 (Theme Memory)
捕获贯穿您故事的深层意义：
| 字段 | 韩语 | 描述 |
|---|---|---|
name |
이름 | 主题标识符 |
expression |
표현 방식 | 这个主题如何表现 |
scenes |
관련 장면 | 体现这个主题的场景 |
character_links |
캐릭터 연결 | 哪些角色承载这个主题 |
author_intent |
작가 의도 | 您希望读者感受什么 |
摘要生成 (시놉시스)
/synopsis 命令使用5个基本元素生成情感聚焦的摘要：
5 Essential Elements (시놉시스 5요소)
-
主人公态度摘要 (Protagonist Attitude Summary)
- 主人公如何对待生活/爱/冲突
- 他们的核心情感立场
- 示例：“새랑은 상실을 예방하기 위해 먼저 포기하는 사람”
-
关系核心构图 (Core Relationship Structure)
- 驱动故事的核心动态
- 权力失衡和紧张
- 示例：“사랑받는 자와 사랑하는 자의 불균형”
-
情感主题 (Emotional Theme)
- 故事唤起的感觉
- 不是情节，而是情感真相
- 示例：“손에 쥔 행복을 믿지 못하는 불안”
-
类型 vs 实际情感对比 (Genre vs Real Emotion Contrast)
- 表面类型期望 vs 实际情感内容
- 示例：“로맨스지만 본질은 자기수용 서사”
-
结局情感余韵 (Ending Emotional Aftertaste)
- 故事结束后的余留感觉
- 示例：“씁쓸한 안도, 불완전한 해피엔딩의 여운”
角色验证 (캐릭터 검증)
/validate 命令检查对话是否匹配角色的已建立声音。
检查内容
| 检查 | 描述 |
|---|---|
| 说话等级 | 正式性是否匹配？(반말/존댓말/해체) |
| 语调匹配 | 情感记录是否适合？ |
| 关键词使用 | 使用特征性词语？ |
| 禁忌违反 | 使用禁忌词语？ |
| 情感范围 | 在角色的基准线内？ |
| 上下文匹配 | 适用于关系和场景？ |
验证结果
- 通过: 对话与角色一致
- 警告: 轻微不一致，可能是有意为之
- 失败: 显著偏离已建立的声音
示例：
/writer-memory validate 새랑 "사랑해, 해랑아. 너무 보고싶었어."
输出：
[FAIL] 새랑验证失败：
- 禁忌："사랑해" - 角色避免直接声明
- 禁忌："보고싶었어" - 角色压制渴望表达
- 语调：对새랑的담백风格过于情感直接
建议替代：
- "...왔네."（最小承认）
- "늦었다."（转移到外部事实）
- "밥 먹었어?"（通过实际关心表达关怀）
上下文查询 (맥락 질의)
对记忆的自然语言查询，完全支持韩语。
示例查询
/writer-memory query "새랑은 이 상황에서 뭐라고 할까?"
/writer-memory query "규리의 현재 감정 상태는?"
/writer-memory query "해랑과 새랑의 관계는 어디까지 왔나?"
/writer-memory query "이 장면의 정서적 분위기는?"
/writer-memory query "새랑이 먼저 연락하는 게 맞아?"
/writer-memory query "해랑이 화났을 때 말투는?"
系统综合所有相关记忆类型的答案。
行为
- 初始化时: 创建
.writer-memory/memory.json，包含项目元数据和空集合 - 自动备份: 修改前将更改备份到
.writer-memory/backups/ - 韩语优先: 情感词汇全程使用韩语术语
- 会话加载: 记忆在会话开始时加载，以便立即上下文
- Git友好: JSON格式化，便于清晰的差异和协作
集成
与 OMC 笔记系统
作家记忆与 .omc/notepad.md 集成：
- 场景想法可以作为笔记捕获
- 分析会话中的角色见解被保存
- 笔记和记忆之间的交叉引用
与建筑师代理
用于复杂角色分析：
Task(subagent_type="oh-my-claudecode:architect",
model="opus",
prompt="Analyze 새랑's arc across all scenes...")
角色验证管道
验证从以下位置拉取上下文：
- 角色记忆（语调、关键词、禁忌）
- 关系记忆（与对话伙伴的动态）
- 场景记忆（当前情感上下文）
- 主题记忆（作者意图）
摘要构建器
摘要生成聚合：
- 所有角色弧线
- 关键关系事件
- 场景情感标签
- 主题表达
示例
完整工作流
# 初始化项目
/writer-memory init 봄의 끝자락
# 添加角色
/writer-memory char add 새랑
/writer-memory char update 새랑 arc "체념 -> 욕망자각 -> 선택"
/writer-memory char update 새랑 tone "담백, 현재충실"
/writer-memory char update 새랑 speechLevel "해체"
/writer-memory char add 해랑
/writer-memory char update 해랑 arc "확신 -> 동요 -> 기다림"
/writer-memory char update 해랑 tone "직진, 솔직"
/writer-memory char update 해랑 speechLevel "반말"
# 建立关系
/writer-memory rel add 새랑 해랑 romantic
/writer-memory rel update 새랑 해랑 "첫 만남 - 해랑 일방적 호감"
/writer-memory rel update 새랑 해랑 "새랑 거절"
/writer-memory rel update 새랑 해랑 "재회 - 새랑 내적 동요"
# 设置世界
/writer-memory world set setting "서울, 현대, 20대 후반 직장인"
/writer-memory world set atmosphere "도시의 건조함 속 미묘한 온기"
# 添加主题
/writer-memory theme add "포기하지 않는 사랑"
/writer-memory theme add "자기 보호의 벽"
# 添加场景
/writer-memory scene add "옥상 재회"
# 查询以写作
/writer-memory query "새랑은 이별 장면에서 어떤 톤으로 말할까?"
# 验证对话
/writer-memory validate 새랑 "해랑아, 그만하자."
# 生成摘要
/writer-memory synopsis
# 导出供参考
/writer-memory export
快速角色检查
/writer-memory char 새랑
输出：
## 새랑
**Arc (감정궤도):** 체념 -> 욕망자각 -> 선택
**Attitude (태도):** 방어적, 현실주의
**Tone (대사톤):** 담백, 현재충실
**Speech Level (말투):** 해체
**Keywords (핵심어):** 그냥, 뭐, 괜찮아
**Taboo (금기어):** 사랑해, 보고싶어
**Relationships:**
- 해랑: romantic (intimacy: 6/10, status: healing)
**Scenes Appeared:** 옥상 재회, 카페 대화, 마지막 선택
存储模式
{
"version": "1.0",
"project": {
"name": "봄의 끝자락",
"genre": "로맨스",
"created": "2024-01-15T09:00:00Z",
"lastModified": "2024-01-20T14:30:00Z"
},
"characters": {
"새랑": {
"arc": "체념 -> 욕망자각 -> 선택",
"attitude": "방어적, 현실주의",
"tone": "담백, 현재충실",
"speechLevel": "해체",
"keywords": ["그냥", "뭐", "괜찮아"],
"taboo": ["사랑해", "보고싶어"],
"emotional_baseline": "평온한 무관심",
"triggers": ["과거 언급", "미래 약속"]
}
},
"world": {
"setting": "서울, 현대, 20대 후반 직장인",
"rules": [],
"atmosphere": "도시의 건조함 속 미묘한 온기",
"constraints": [],
"history": ""
},
"relationships": [
{
"id": "rel_001",
"from": "새랑",
"to": "해랑",
"type": "romantic",
"dynamic": "해랑 주도 → 균형",
"speechLevel": "반말",
"evolution": [
{ "timestamp": "...", "change": "첫 만남 - 해랑 일방적 호감", "catalyst": "우연한 만남" },
{ "timestamp": "...", "change": "새랑 거절", "catalyst": "과거 트라우마" },
{ "timestamp": "...", "change": "재회 - 새랑 내적 동요", "catalyst": "옥상에서 재회" }
],
"notes": "새랑의 불신 vs 해랑의 기다림",
"created": "..."
}
],
"scenes": [
{
"id": "scene-001",
"title": "옥상 재회",
"characters": ["새랑", "해랑"],
"location": "회사 옥상",
"cuts": ["해랑 먼저 발견", "새랑 굳은 표정", "침묵", "해랑 먼저 말 걸기"],
"narration_tone": "건조체",
"emotional_tag": "긴장+그리움",
"purpose": "재회의 어색함과 남은 감정 암시",
"before_after": "새랑: 무관심 -> 동요"
}
],
"themes": [
{
"name": "포기하지 않는 사랑",
"expression": "해랑의 일관된 태도",
"scenes": ["옥상 재회", "마지막 고백"],
"character_links": ["해랑"],
"author_intent": "집착이 아닌 믿음의 사랑"
}
],
"synopsis": {
"protagonist_attitude": "새랑은 상실을 예방하기 위해 먼저 포기하는 사람",
"relationship_structure": "기다리는 자와 도망치는 자의 줄다리기",
"emotional_theme": "사랑받을 자격에 대한 의심",
"genre_contrast": "로맨스지만 본질은 자기수용 서사",
"ending_aftertaste": "불완전하지만 따뜻한 선택의 여운"
}
}
文件结构
.writer-memory/
├── memory.json # 主记忆文件
├── backups/ # 修改前的自动备份
│ ├── memory-2024-01-15-090000.json
│ └── memory-2024-01-20-143000.json
└── exports/ # Markdown 导出
└── export-2024-01-20.md
给作家的提示
- 从角色开始: 在场景前构建角色记忆
- 在关键场景后更新关系: 积极跟踪演变
- 写作时使用验证: 早期捕捉声音不一致
- 在困难场景前查询: 让系统提醒您上下文
- 定期摘要: 定期生成以检查主题连贯性
- 主要更改前备份: 在重大故事转折前使用
/backup
故障排除
记忆未加载？
- 检查
.writer-memory/memory.json是否存在 - 验证 JSON 语法有效
- 运行
/writer-memory status诊断
验证太严格？
- 审查禁忌列表中的意外条目
- 考虑角色是否在成长（弧线进展）
- 对于戏剧性时刻，有意识破模式是有效的
查询未找到上下文？
- 确保相关数据在记忆中
- 尝试更具体的查询
- 检查角色名称是否完全匹配