diff --git a/document-generate/SKILL.md b/document-generate/SKILL.md index f86bfe9ec..d9e0ddeb8 100644 --- a/document-generate/SKILL.md +++ b/document-generate/SKILL.md @@ -323,6 +323,26 @@ Effort both-scales: when an option involves effort, label both human-team and CC Net line closes the tradeoff. Per-skill instructions may add stricter rules. +12. **Non-ASCII characters — write directly, never \u-escape.** When any + string field (question, option label, option description) contains + Chinese (繁體/簡體), Japanese, Korean, or other non-ASCII text, emit + the literal UTF-8 characters in the JSON string. **Never escape them + as `\uXXXX`.** Claude Code's tool parameter pipe is UTF-8 native + and passes characters through unchanged. Manually escaping requires + recalling each codepoint from training, which is unreliable for long + CJK strings — the model regularly emits the wrong codepoint (e.g. + writes `\u3103` thinking it is 管 U+7BA1, but `\u3103` is + actually ㄃, so the user sees `管理工具` rendered as `㄃3用箱`). + The trigger is long, multi-line questions with hundreds of CJK + characters: that is exactly when reflexive escaping kicks in and + exactly when miscoding is most damaging. Long ≠ escape. Keep + characters literal. + + Wrong: `"question": "請選擇\uXXXX\uXXXX\uXXXX\uXXXX"` + Right: `"question": "請選擇管理工具"` + + Only JSON-mandatory escapes remain allowed: `\n`, `\t`, `\"`, `\\`. + ### Self-check before emitting Before calling AskUserQuestion, verify: @@ -335,6 +355,7 @@ Before calling AskUserQuestion, verify: - [ ] Dual-scale effort labels on effort-bearing options (human / CC) - [ ] Net line closes the decision - [ ] You are calling the tool, not writing prose +- [ ] Non-ASCII characters (CJK / accents) written directly, NOT \u-escaped ## Artifacts Sync (skill start)