Communitygithub.com

claudianus/toss-ux-writing-skill

非官方的 Toss 风格韩语 UX 写作智能体技能与代码检查工具

toss-ux-writing-skill 是什么?

该技能帮助开发者以 Toss 风格生成、改写或审查韩语产品文案,重点在于应用可复用的模式:友好的해요체、主动动词、正面优先框架、随意敬语以及清晰的例外处理。它支持多种平台(如 Claude Code、Cursor、Codex),并提供了从文案分类到改写、异常检查再到可审计结果输出的完整工作流。核心规则包括:强制使用해요체、避免被动语态、正面优先表达、降低敬语层级、将名词堆叠转为动词。同时,该技能严格遵循例外原则,例如在涉及法律/政策限制、服务终止、过期等场景下允许被动或否定句式。工具内置了引用文档(如 `references/vocabulary.md`、`references/decision-tree.md`)和本地启发式检查脚本,确保改写结果符合品牌语调。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add claudianus/toss-ux-writing-skill

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Toss UX Writing

使用此技能生成、改写或审查 Toss 风格的韩语产品文案。目标不是模仿 Toss 或复制其示例,而是应用可重复的模式:友好的 해요체、主动动词、正面优先框架、随意敬语和清晰的例外处理。

核心约定

改进韩语 UX 文案时:

  1. 全程使用 해요체。 避免正式的 합니다/됩니다/하십시오,也避免 반말。
  2. 优先使用主动语态。 让用户、产品或对象执行动作,而不是依赖 되다/됐어요/되어요。
  3. 正面优先表达。 先说用户可以做什么以及什么条件下可以做,再说限制条件。
  4. 保持敬语随意。 去除过度的 ~시겠어요、시나요、셨나요、께、계시다、여쭙다,除非有例外情况。
  5. 去名词化。 将僵硬的 {名词}+{名词} 和汉字词名词替换为动词、原因和具体动作。
  6. 尊重例外。 当法律/政策需要清晰性、用户安抚、服务终止/到期或需要说明后果时,不要强行使用正面或主动语态。

工作流程

1. 分类文案表面

确定文案出现的 UI 位置:

  • 按钮或 CTA
  • 对话框 / 确认弹窗
  • 弹窗 / 底部通知
  • 错误 / 恢复消息
  • 空状态
  • 表单标签、帮助文本、验证
  • 福利资格或奖励通知
  • 政策/法律限制
  • 通知/推送
  • 隐私、同意、录制、数据使用

使用 references/surface-patterns.md 获取特定表面的默认模式。

2. 按五种主要转换规则改写

按顺序应用转换规则:

  1. 语体: 转为 해요체。
  2. 主动性: 将被动/静态句式转换为主动语态。
  3. 情感倾向: 将可避免的否定句转换为可能的条件句。
  4. 距离: 降低敬语级别,同时保持尊重。
  5. 动词化: 将名词堆叠转换为动词或原因从句。

使用 references/vocabulary.md 获取替换模式。

3. 检查异常门

在最终确定前,询问:

  • 这是硬性的法律/政策/产品限制吗?如果是,否定表述可能更清晰。
  • 这是关于服务 종료、기간 만료、연체、해지、적용、기록、녹음 或 정보 수집 吗?如果是,被动表述可能更清晰。
  • 问题是否涉及用户的真实背景、推测情况,或征求善意/意见?如果是,시나요/셨나요 可能被允许。
  • 正面表述是否会让用户误解整个服务不可用?如果是,请具体说明受影响的福利/功能。

使用 references/decision-tree.md。

4. 返回可审计的结果

对于改写任务,返回以下表格:

원문개선안적용 규칙예외 여부

对于生成任务,按表面分组:

  1. 主要文案
  2. 次要/帮助文案
  3. CTA 标签
  4. 错误/空状态/恢复文案(如相关)
  5. 关于风险、异常或缺失背景的备注

对于审核任务,返回:

  1. 总体评价:좋음、수정 필요 或 위험
  2. 按严重程度列出的发现
  3. 建议的改写
  4. 规则引用

硬性规则

  • 不要输出 되어요;如果故意允许被动,请使用 돼요。
  • 在对话框中,优先选择左侧按钮 닫기 而非 취소,除非该操作确实取消用户发起的操作。
  • 如果动作可以被命名,避免使用泛型 CTA 如 확인、진행、제출。
  • 不要责备用户。优先提供系统/产品限制和后续步骤。
  • 不要用愉快的措辞掩盖政策/法律限制。
  • 不要声称生成的文案是“官方 Toss 文案”。
  • 不要重新分发或引用完整的 Toss 指南。总结模式并在需要时引用来源。

快速模式

카드를 해지하시겠어요?      → 카드를 해지할까요?
알림이 설정됐어요          → 알림을 설정했어요
보호자가 허락하기 전에는 가입할 수 없어요 → 보호자가 허락하면 가입할 수 있어요
잔액 부족으로 결제 실패    → 잔액이 부족해서 결제하지 못했어요
자동차를 가지고 계시나요?  → 자동차가 있나요?

何时使用

  • 韩语 App/网页产品文案需要 Toss 式的语调。
  • 错误、对话框、按钮、福利、新手引导、表单、通知或政策通知的 UX 文案感觉僵硬。
  • PR 中添加了韩语 UI 字符串,需要进行风格审查。
  • 您需要友好 해요체 的多个变体。
  • 您需要解释为什么某个韩语短语显得过于正式、被动、否定或名词化。

何时不使用

  • 法律条款必须逐字复现。
  • 品牌语调故意使用正式的 합니다체。
  • 受众需要机构或政府级别的敬语。
  • 文案不是韩语。
  • 您被要求克隆 Toss 的专有 UI 或复制完整的官方示例。

参考资料

  • references/tone-model.md — 对语调模型的深入分析。
  • references/decision-tree.md — 异常优先的决策门。
  • references/vocabulary.md — 替换模式和反模式。
  • references/surface-patterns.md — UI 表面特定的文案食谱。
  • references/examples.md — 合成的前后对照示例。
  • references/review-rubric.md — 审核评分标准。
  • scripts/toss_style_lint.py — 本地启发式代码检查脚本。

相关技能