ChatGPT 技术文档风格检查技能:找长段落、标题和超长命令行
EnglishChatGPT 安装步骤
- 打开固定提交的 .claude/skills/find-style-issues/SKILL.md,核对原文的输入和输出。
- 在 ChatGPT 打开「插件 → 技能 → 创建 → 使用编辑器创建」。
- 按下面的工作流程填写技能规则。提供文档路径、摘录、实测长度和已有 Vale 结果。
- 保存技能,在新对话输入本页的虚构示例并核对结果。
中文摘要
按项目设定的阈值审查文档片段,标出过长段落、疑似标题大小写问题和 shell 行过长。可纳入现有 Vale 报告,汇总优先级。
SKILL.md 中文导读
可复现示例
虚构检查规则是段落超过 600 个可读字符、shell 行超过 65 字符。A 文档有 670 字符段落,B 有 72 字符命令和一个包含 API 的标题。请排审查清单。工作步骤
- 按阈值归纳已确认的命中。
- 复核大小写和专有词的例外。
- 按文档给可验证的修订建议和优先级。
验收方法
A 与 B 各保留一项已确认阈值命中。标题单独核对项目写法,保留 API 缩写并注明缺少进一步风格报告。
GitHub 原文 · 更新日期
适用环境
需要启用了技能创建的 ChatGPT 工作区。这里使用基于 GitHub 原文编写的文本改编。
常见问题
标题检测命中后能一律改成全小写吗?
检查专有名词、品牌和代码标识。自动检测只提供候选,按项目样式规范判断该标题。