用途:对 Markdown 文档进行文章校对,基于指南文件检测文体层面的问题并提示修改方案。
主要能力与流程:
- 确定对象文件:指定文件路径则以该文件为对象;按分支差异校对时执行 git diff --name-only main...HEAD -- '*.md' 找出变更的 Markdown 文件;无参数时通过 AskUserQuestion 询问指定方式。找不到对象文件则报告并结束。
- 读取与 SKILL.md 同目录下的 GUIDELINES.md,作为校对规则来源。
- 逐文件检测违规:只提出能在不改变语义前提下自然改善且高置信度的建议,拿不准则跳过。排除对象包括 code fence 内的代码、inline code、URL、frontmatter、引用文本,以及作为反面示例给出的句子。无违规时报告「ガイドライン違反は見つかりませんでした」并结束。
- 逐条提示与确认:每个违规用一次 AskUserQuestion,question 中标明规则编号、名称与所在行,preview 展示修改方案;修改方式有多种时拆成不同选项,最后一项固定为「スキップ」。用户同意后用 Edit 工具应用,选择跳过则处理下一处。
- 完成后报告已修改与已跳过数量。
适用场景:需要对 Markdown 文档按既定文体规范做人工确认式校对时。
限制:依赖同目录 GUIDELINES.md 的存在;仅处理文体问题,不改动代码、URL、frontmatter 等排除内容;仅在用户确认后应用修改。