关于 editor
用于审阅或编辑文件,减少刻意模仿 AI 的文风和其他冗余表达。默认可通过 Codex 使用 GPT,也支持指定其他模型,并可在当前会话中快速清理。
主要功能
- 01审阅文件并列出问题
- 02改写或简化文件内容
- 03选择列出的模型别名
- 04在当前会话中快速清理
- 05应用写作风格规范
适用场景
- 01删去文档中的冗余表达
- 02只审阅文件而不改写
- 03简化或重组技能文件
- 04快速清理一份文件
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ dwmkerr/ editor --skill editor安装后在 Claude Code 中输入/editor确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
AGENTS.md.gitignoredispatch.shLICENSEMakefileCLAUDE.mdREADME.mdpackage.jsondocs/troubleshooting.mdcustomisation.mdreferences/code-style.mdeffective-shell-style.mdhacker-news-effective-shell.mdoutput-style.mdobnoxious-humility.mdlinkedin-effective-shell-posts.mdlinkedin-post-examples.mdreview-examples.mdsubstack-signal-noise-example.mdcute-labels.mdwriting-style.mdscripts/hero-demo.txthero-play.shhero.tape详细介绍
编辑器
编辑或审阅文件,去除过度程式化的 AI 惯用表达和其他增加噪音或认知负担的模式。默认情况下,此技能会通过 Codex 使用 GPT 执行审阅,这有助于发现当前会话所用模型可能忽略的结构性模式。
示例
/editor "clean this up"
/editor gpt "what are the top 10 things you'd rewrite in qb-scholar. dont change"
/editor gpt "how would you rewrite the skill md"
/editor "don't rewrite, tell me what is wrong"
/editor claude "simplify section 6"
/editor gpt "restructure this file into Forbidden/Discouraged/Preferred. writing-style.md"
/editor quick
目标文件通常可从对话上下文中确定,或在指令中指定。模型默认为 gpt。
参数
/editor [model] "<instructions>"
- model - 选择模型。默认为
gpt。可用选项:gpt、luna、o3、claude。如果第一个词与模型别名不匹配,则将其视为指令的开头,并使用gpt。 - quick - 在当前会话中清理文件,详见下文的“快速模式”。不接受模型参数。
- instructions - 要执行的操作。如果指令中包含“list”“check”“review”或“don't rewrite”,则只返回问题。否则,重写文件。
回复风格也要符合要求
这些规则不仅适用于你正在处理的文件,也适用于你自己的文字。审阅、摘要和改写都只能使用标准键盘上的字符:破折号用 -,引号用 " 和 ',箭头用 ->,省略号用 ...。如果审阅指出了长破折号,却在回复中使用了长破折号,那这次审阅就不合格。
说明由谁完成
每种模式下的每条回复都必须以单独一行结尾,写明所用的 harness、运行方式和确切模型。模型应取自 dispatch.sh 传给 CLI 的标志。切勿猜测。
Editor: Codex, dispatched as a new process, model gpt-5.6-sol
Editor: Claude, current session, model claude-opus-5
写明实际运行所用的 harness。quick 始终在当前会话中运行,因此应报告当前的 harness 和模型。
快速模式
/editor quick 用于快速处理:文案不必完美,只需去掉最严重的噪音。在当前会话中使用正在运行的模型和 harness,不要分派任务。
- 阅读
references/writing-style.md的 Forbidden 部分。跳过其他参考资料。 - 修复文件中的违规内容,以及明显的填充语。
- 保留需要判断的内容,并用一行说明。
写入文件,并用一行总结删去了哪些内容,然后写 harness 行。如需仔细处理,请使用默认的 /editor。
操作步骤
以下步骤适用于审阅和编辑模式。quick 模式请参阅上文。
-
确定目标文件,依据是指示或对话上下文。
-
编写提示词文件。 将文件写入暂存目录。包含以下内容:
-
此技能
references/目录中writing-style.md、review-examples.md、cute-labels.md和obnoxious-humility.md的内容。 -
当目标是代码时,包含
code-style.md的内容(源文件,或 diff 中记录代码的注释等文档)。 -
仅当指示中提到该语气时,才包含
effective-shell-style.md的内容。 -
目标文件的内容。对于代码目标,包含代码本身,绝不要只包含提取出的注释行:评判注释时,需要查看它所注释的代码。
-
用户的指示。
-
以下附注:
对于编辑模式:
应用禁止规则:修正每一处违规。仅当不推荐规则中的模式明显构成噪声时才应用。仅在确信修改能改善文本时,才应用首选规则。
对于审阅模式:
标出每一处违反禁止规则的内容,并注明行号、问题和修正方法。当不推荐模式会造成噪声时,予以标出。若首选改进能增强文本,则提出建议。
对于两种模式,均追加:
回复中只能使用标准键盘上的字符。无论是你自己的文字还是改写的文本,都不要使用长破折号、短破折号、弯引号、箭头或省略号字符。
对于编辑模式下的代码目标,追加:
应用代码风格规则:修正每一处违规。
对于审阅模式下的代码目标,追加:
标出每一处违反代码风格规则的内容,并注明行号、问题和修正方法。
-
-
分派任务。
- 如果模型是
claude,则直接在当前会话中运行,无需使用分派脚本。 - 否则,从此技能目录运行
dispatch.sh:
分派脚本会处理各类运行环境特定的 CLI 细节。要添加新模型或运行环境,请编辑dispatch.sh <model> <prompt-file>dispatch.sh。
- 如果模型是
-
呈现结果。
- 审阅模式: 显示编号的问题列表,其中包含行号/引文、问题和修正方法。
- 编辑模式: 使用相关的修改前后示例简要总结。如果用户批准修改,则写入文件。
最后附上运行环境行,格式如上文所述。