用途:按文本所属语域审查散文,找出并解释偏离写作标准之处,只做审查,不代改。输入 $ARGUMENTS 可为文件路径、目录、glob 或粘贴文本,也可显式指定 register=docs 或 register=voice 覆盖自动检测;无参数时审查工作树中最近修改的散文文件并说明所选文件,若含糊或没有散文类改动则先询问。
语域与阈值:docs 覆盖规格、提案、报告、正式与技术文档、README、参考资料、API 文档,规则见 ../define/references/DOCS-STYLE-REFERENCE.md;voice 覆盖文章、博客、营销与社交文案、通讯、叙事、创意写作,规则见 ../define/references/WRITING-REFERENCE.md。两者互斥,PASS 均要求无 MEDIUM 或更高等级发现。两语域共享 ../define/references/PROSE-FLOOR-REFERENCE.md 的底线规则(含无障碍与包容性语言),底线发现与语域发现同等评级报告,无单独只跑底线的调用。每次只加载底线加一个语域文件,绝不同时加载两个语域文件。路径缺失时按名称搜索,确实找不到就说明并只报告有依据的发现。
检测语域:文档用于指导或规定,价值在于被遵循;人声写作用于说服、叙事或娱乐,价值在于被阅读。混合文本取主体语域并说明理由,不拆分;检测均衡时说明并询问;显式 register= 优先。
优先级:项目自带样式表或 AUTHOR_VOICE.md 高于随附参考,冲突时以项目规则为准,报告中说明所用样式来源。
报告:每条发现含严重度与规则领域、原文引用与位置、规则要求及失败原因、具体修改建议;按严重度再按位置排序。干净文本应直接说明并停止,不堆砌边缘发现;同一模式多处出现时报告一次并给两三个例子与计数;属判断取舍的说明而非判为缺陷。
范围:按用户指定审查任意语域散文;不涉及 review-code 的散文价值维度(后者针对 diff 中的注释与仓库文档,判断其是否值得存在)。用户看到报告后要求应用修改,属另行请求与普通编辑。