韩语文档风格一致性检查：在多作者或项目文档中统一语调、术语…

适用于审查韩语文档或项目，发现并统一同一文档/项目内的写作风格不一致。

适用场景

解决思路

1. 执行时使用允许的工具：Read、Write、Edit、Grep、Glob、AskUserQuestion；文件路径用 Read 加载，修改用 Write/Edit，搜索用 Grep/Glob，需用户选择时用 AskUserQuestion。
2. 先读取文本：文件路径用 Read 工具加载；文本在对话上下文中则抽取；多个文件则做项目级一致性检查。
3. 明确只检查同一文档或同一项目内的写作风格一致性，不检查拼写/语法错误，例如 되요 → 돼요 不处理。
4. 遵循一致性优先原则：当同一表达有多种正确选择时，在文档内保持单一选择。
5. 根据文档类型（商务/学术/技术/营销）提出匹配语境的风格建议。
6. 提出建议时给出依据，参考权威标准（政府/学术/实务）。
7. 优先应用品牌语气或项目规则。
8. 对文本执行 7 类风格一致性分析。
9. 识别同一文档内或项目内的风格冲突。
10. 提出符合语境的统一方案。
11. 提供用统一风格重写后的文本。
12. 先确定文档类型，再进入检查。
13. 文档类型判定优先级 1：用户显式指定优先，如「学术论文」「商务报告」「技术文档」「博客文章」。
14. 文档类型判定优先级 2：自动估计，依据前 300 字符的语调（~합니다 vs ~이다 vs ~해요）、术语密度、引用格式、呼格使用等推断。
15. 文档类型判定优先级 3：若置信度低（文本短、语调模糊、混合形式），用 AskUserQuestion 让用户在 4 类中选择。
16. 使用 4 种文档类型定义：商务/公文（正式、标准术语、统一日期格式）；学术论文（严格引用、专业术语、正式语调）；技术文档（IT 术语统一、代码块风格、简洁表达）；营销/博客（品牌语气、读者友好、灵活表达）。
17. 按优先级检查 7 类：1 语调与敬语（最高）——敬语混用（입니다 ↔ 이에요 ↔ 임）、主语不一致（우리 ↔ 저희）、文体冲突（正式 ↔ 口语）。
18. 优先级 2：术语统一——同一概念不同表达（사용자 ↔ 유저 ↔ 이용자）、外来语拼写（웹사이트 ↔ 웹 사이트）、缩略语使用（데이터베이스 ↔ DB）。
19. 优先级 3：数字/单位、列表——数字写法（3개 ↔ 세 개）、单位空格（10 개 ↔ 10개）、列表符号（1. ↔ - ↔ •）、列表结尾（합니다 ↔ 함 ↔ 省略）。
20. 优先级 4：引用、日期、链接——引号（双引号 ↔ 单引号 ↔ 「」）、日期格式（2026년 1월 27일 ↔ 2026.01.27）、链接样式（여기 클릭 ↔ [제목](URL)）。
21. 发现某类不一致时，加载对应详细参考文件：references/tone-consistency.md、references/terminology.md、references/numbering-units.md、references/list-structure.md、references/quotation-emphasis.md、references/datetime-reference.md。
22. 需要全面分析时加载所有参考文件。
23. 用户提到特定标准（例如「政府公文标准」）时，加载对应参考。
24. 文本已经一致时跳过加载参考文件。
25. 应用 7 类 × 4 文档类型的 genre matrix 做差异化检查；矩阵未覆盖的细节用多数原则。
26. 按 genre matrix 的单元格标准执行：商务/公文用 ~합니다、标准韩语术语、阿拉伯数字+单位空格、完整句结尾+1./2.、双引号+保守加粗、YYYY년 MM월 DD일+24小时制、显式链接文本；学术用 ~이다/한다体、学术术语+英语原文、严格 3명、名词短语或 ~함、APA/MLA、韩文日期、脚注/参考文献；技术用 ~합니다+~한다混用、IT 术语/英文缩写、自由数字格式、自由列表、行内代码优先、YYYY-MM-DD ISO+24小时制、[제목](URL) 行内；营销/博客用 ~해요/~다自由、品牌术语+友好表达、自由数字、自由列表+emoji、自由引号/emoji 强调、自由日期、自由链接+图片嵌入。
27. genre matrix 的单元格建议是默认值；用户显式品牌/项目指南优先。
28. 混合文档类型：输入横跨两类时，采用更正式一方的标准，例如商务+营销合本 → 商务标准。
29. 差异化优先级：营销/博客中优先级 1（语调一致性）可放宽；学术中优先级 4（引用格式）应与优先级 1 一样严格检查。
30. 权威标准与矩阵冲突时：用户指定的权威标准（如 APA、政府指南）优先于矩阵单元格。
31. 对每个检测到的不一致计算频率：统计各表达在文档中出现的次数。
32. 用多数原则：以使用最多的表达为基准提出统一。
33. 考虑语境：判断哪种表达更符合文档类型。
34. 引用权威来源：适用时参考标准指南（政府/学术/实务）。
35. 提出统一方案时：以多数原则为基准；标准优先（公文用政府标准，论文用学术惯例）；用户偏好优先；选择实务中通行的方式而非过度严格。
36. 输出结果使用指定 Markdown 模板，包含：文档类型分析（判断、决定路径、依据、适用标准）。
37. 输出发现的不一致总数，并按类别列出：每个不一致列出模式 A 使用次数、模式 B 使用次数、建议、依据。
38. 输出统一风格重写后的完整文本。
39. 输出可选的项目级风格指南摘要，包含语调、术语、格式等规则清单。
40. 若文本已经一致，输出「该文本保持了一致风格」的结果；如有细小改进项则提及。
41. 重要指南：应用多数原则，例如 사용자（10次） vs 유저（2次） → 统一为 사용자。
42. 按文档类型考虑语境：商务/公文用正式体（입니다, 합니다）、标准术语（사용자, 데이터베이스）、YYYY년 MM월 DD일；学术论文用正式体（이다, 하다）、专业术语、统一引用格式（APA、MLA 等）；技术文档用简洁表达、IT 术语统一（API、SDK）、代码块风格一致；营销/博客用友好语调、品牌术语优先、读者参与型表达。
43. 参照权威来源：政府标准（국립국어원 公文写作指南、行政业务运营规定、公共语言改善指南）；学术标准（大学学位论文写作指南、APA/MLA 引用格式）；实务标准（大企业风格指南如 Kakao、Naver、业界最佳实践）。
44. 用户偏好最优先：用户说明品牌指南或项目规则时遵循，例如「我们公司使用 유저」→ 统一为 유저。
45. 实用性优先：不要强推过严标准；承认实务中广泛通行的方式；忽略细小不一致，只指出明显模式。
46. 避免过度统一：不要强制统一有意强调/对比、引用文/专有名词、文学表达/修辞、代码/专业术语。
47. 多文件检查时：先分析各文件模式；在项目整体应用多数原则；按文件整理修改项；提出项目整体风格指南。
48. 品牌语气维护：用户提供品牌指南时，优先应用品牌术语表；保持 tone and manner；保留品牌特有表达。
49. 多语言文档：只对韩语部分做一致性检查；保留英语专有名词和术语；外来语拼写遵循韩语标准。
50. 代码和技术文档：不检查代码块内容；只检查注释和文档化部分；技术术语遵循业界标准。
51. 非常短的文本（1-2 段）：输出时注明模式分析受限，只简要列发现的不一致。
52. 结束前最终确认：文档类型判断是否正确、7 类是否都检查、是否应用多数原则、建议是否符合语境、是否参考权威来源、是否提供统一版本、是否避免过度统一。
53. 使用 examples/ 目录中的示例辅助：inconsistent.md、consistent.md、business-style.md、academic-style.md、tech-style.md、blog-style.md；每个示例含发现的不一致、分析、统一方案、风格指南。
54. 输出时以帮助文档保持风格一致、给读者专业可信印象、提高内容可信度、强化品牌身份、改善读者体验为目标。

适用边界 · 注意事项

• 不要用于检查拼写或语法错误，例如 되요 → 돼요，它不是语法检查器。
• 不要强制统一有意强调/对比、引用文、专有名词、文学表达/修辞、代码或专业术语。
• 若没有任何文档文本或上下文可读取，则无法执行；非常短的文本只能做有限分析。