用途
ux-writing 是一个重写辅助技能，用于在界面已有文案、需要进一步打磨时使用。判定文案是否达标由 design 技能的 quality bar 负责（G6 文案、G8 暗黑模式），本技能负责“如何修改”——不在两处重复定义同一规则，这里只处理重写原则、流程与 before/after 示例。
产出始终是建议。在真正修改代码或文案文件之前，必须获得用户确认——未经确认不得批量替换字符串。
何时使用
- 界面上已有文案，想打磨成更好的文案时。
- design 技能的质量判定中 G6（文案）出现“需要调整”，需要实际动手修改时。
调用方式：
/ait:ux-writing [화면 또는 파일]
# 口语：“이 화면 문구를 UX 라이팅 기준으로 다듬어줘”
也可以不指定对象直接调用——第 1 步会先浏览当前项目的界面文案，一并确认对象列表。
文案原则
按以下维度检查并修改文案。括号内标注对应 design 技能 references/quality-bar.md 中的判定项——本技能只引用该标准，不重新定义。
- 以用户所做的事为主语——不用“系统正在处理中”这类被动句，而是写用户此刻在等待什么、在做什么。（非判定项——重写视角，quality-bar 中无对应项。）
- 用“获得”来表达——不使用刺激损失与不安的框架（“错过就吃亏”）（G6-6）。
- 用可确认的事实来写——不替用户断言其情绪（G6-7）。
- 拆分句子——不把条件、数值堆进一个句子（G6-8）。
- 不重复——同一主张不在标题、副标题、正文中换着说法反复表达（G6-9）。
- 同时说明原因与下一步行动——错误文案不能以“发生错误”收尾（G6-2）。
- 按钮说明结果——不用“确认”“完成”这类模糊标签，而是在标签中写明按下后会发生什么。（非判定项——重写视角，quality-bar 中无对应项。）
- 保持语气一致——敬语级别、数字单位写法在整个界面统一（G6-1）。
- 不混用语言——同一界面内不混用韩语与其他语言（G6-4）。
- 不逼迫用户——不使用扭曲选择或催促的文案。模式层面（假按钮、关闭陷阱等）的判定由 G8 负责——这里只看文案表达层面。
工作流程
- 全量收集——从目标界面的代码、设计稿中梳理用户文案，按界面整理成表：界面 | 位置（文件·组件） | 原文。
- 逐维度检查——将上述“文案原则”各维度与原文对照，指出违规。若无违规，该维度标记为通过。
- before/after 建议——为每条违规文案制作替代文案，并用一句话附上改了什么。
- 用户确认后应用——以表格展示建议，仅将用户批准的项目实际反映到代码、文案文件中。未经批准不得推进。
- 交回 design G6 重新判定——反映完成后交给 design 技能重新给 G6 打分（见下文“与 design 的关系”）。
before/after 示例
以下示例由本技能新写（并非照搬真实产品文案）。实际目标界面中，按第 3 步流程制表提出建议。
语气本身不是本技能的维度——语气（습니다体/해요体等）只判定整个界面的一致性（G6-1），以下示例所用语气为任意。部分示例在修正框架的同时语气也变成了 해요体，但本技能实际判定与建议的维度是框架、结构、信息完整性，而非语气本身。
加载
- Before：“시스템이 데이터를 처리하고 있습니다.”
- After：“쿠폰을 불러오는 중이에요.”
- 改了什么：以系统为主语的被动句 → 以用户等待的对象为主语。
结果 0 条（空状态）
- Before：“검색 결과가 없습니다.”
- After：“조건에 맞는 쿠폰이 아직 없어요. 지역이나 기간을 넓혀서 다시 찾아보세요.”
- 改了什么：在仅告知事实的文案上补充下一步行动（与 G6-9 的单纯重复不同，不止于告知信息缺失，还给出替代方案）。
网络失败（Before/After 均为 해요体——保持语气不变、只改框架的示例）
- Before：“오류가 발생했어요.”
- After：“네트워크 연결을 확인할 수 없어요. Wi-Fi나 데이터 연결을 확인한 뒤 다시 시도해주세요.”
- 改了什么：没有原因与下一步行动的笼统错误文案 → 同时写明原因与下一步行动（G6-2）。语气（해요体）未变。
权限拒绝（Before/After 均为 해요体——保持语气不变、只改框架的示例）
- Before：“위치 권한이 거부되어 이 기능을 사용할 수 없어요.”
- After：“주변 매장을 보려면 위치 권한이 필요해요. 설정에서 위치 접근을 허용해주세요. 권한 없이도 지역을 직접 검색해 매장을 찾을 수 있어요.”
- 改了什么：死胡同式告知 → 说明需要权限的原因 + 即使拒绝也可用的替代路径。语气（해요体）未变。
提交 CTA
- Before：“확인”
- After：“쿠폰 신청하기”
- 改了什么：按下后会发生什么不明确的标签 → 具体说明结果的标签。
条款同意
- Before：“동의하지 않으면 서비스를 이용할 수 없습니다. 지금 동의하지 않으면 나중에 혜택을 놓칠 수 있습니다.”
- After：“위치 정보 제공에 동의하면 주변 매장 추천을 받을 수 있어요. 동의하지 않아도 매장을 직접 검색해 이용할 수 있어요.”
- 改了什么：去除损失框架（“놓칠 수 있다”）→ 说明同意能获得什么，并一并告知不同意时的替代方案（G6-6）。
金额·期限说明
- Before：“이 쿠폰은 1000원 할인이며 최소 주문 금액 10000원 이상 구매 시, 참여 매장에서만, 이번 달 말일까지 사용 가능하고 1인당 1회만 사용할 수 있습니다.”
- After（不是一行字符串，而是界面上实际渲染为多行列表的形态）：
1,000원 할인 쿠폰이에요.
· 최소 주문 금액: 10,000원
· 사용 기간: 이번 달 말일까지
· 사용 매장: 참여 매장 한정
· 사용 횟수: 1인당 1회
- 改了什么：把挤在一个句子里的 4 个条件按条目拆分（G6-8）。
与 design 的关系
判定由 design 技能的 quality bar 负责——界面文案是否符合 G6（文案）、G8（暗黑模式）标准，以通过/需要调整来打分。重写由本技能负责——把该判定转化为实际替代文案。两者双向交接：
- design 是直接创建和修改界面代码的技能，布局、token、状态、图标全归其负责。本技能只处理界面中写死的文案字符串，即使打开同一文件，也不触碰字符串以外的内容。重写完成后交回 design 的原因是：文案一变，行数与长度随之改变，不仅要重看 G6，还要重看 G7（换行、重叠、截断）。
- design 在 G6 发现“需要调整”时，转到本技能制作具体的 before/after。
- 本技能完成文案反映后，再交回 design 重新判定 G6。
/ait:design # 文案反映后重新判定 G6
# 口语：“카피 고쳤으니 디자인 품질 다시 점검해줘”
不在范围内（本技能不做的事）
- ❌ 品牌文案政策判断——属 design 技能的 G0（品牌·IP 安全）范畴。
- ❌ 法律、审核文案的合法性判断——官方文档为准，没有把握时不要编造，用 docs MCP（searchDocumentation/getPage）确认。
- ❌ 未经用户确认的大量字符串替换——建议始终以表格展示，仅应用已批准的项目。
参考
- 配对技能：design——负责界面代码生成与修改及判定（quality bar G6·G8），也负责注册图片资产的产出。
- 判定标准全文参见 design 技能的 references/quality-bar.md（G0~G8 项目表）——本技能不重新抄录该表。
- 需要查阅文档的文案（审核标准、法律标注等）用 docs MCP 查询。