mcpField
E
editor

editor

github.com/dwmkerr文档处理1546 次安装3 周前更新
代码仓库

关于 editor

用于审阅或编辑文件,减少刻意模仿 AI 的文风和其他冗余表达。默认可通过 Codex 使用 GPT,也支持指定其他模型,并可在当前会话中快速清理。

主要功能

  1. 01审阅文件并列出问题
  2. 02改写或简化文件内容
  3. 03选择列出的模型别名
  4. 04在当前会话中快速清理
  5. 05应用写作风格规范

适用场景

  1. 01删去文档中的冗余表达
  2. 02只审阅文件而不改写
  3. 03简化或重组技能文件
  4. 04快速清理一份文件

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/dwmkerr/editor --skill editor

安装后在 Claude Code 中输入/editor确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

AGENTS.md
.gitignore
dispatch.sh
LICENSE
Makefile
CLAUDE.md
README.md
package.json
docs/
troubleshooting.md
customisation.md
references/
code-style.md
effective-shell-style.md
hacker-news-effective-shell.md
output-style.md
obnoxious-humility.md
linkedin-effective-shell-posts.md
linkedin-post-examples.md
review-examples.md
substack-signal-noise-example.md
cute-labels.md
writing-style.md
scripts/
hero-demo.txt
hero-play.sh
hero.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 模式请参阅上文。

  1. 确定目标文件,依据是指示或对话上下文。

  2. 编写提示词文件。 将文件写入暂存目录。包含以下内容:

    • 此技能 references/ 目录中 writing-style.md、review-examples.md、cute-labels.md 和 obnoxious-humility.md 的内容。

    • 当目标是代码时,包含 code-style.md 的内容(源文件,或 diff 中记录代码的注释等文档)。

    • 仅当指示中提到该语气时,才包含 effective-shell-style.md 的内容。

    • 目标文件的内容。对于代码目标,包含代码本身,绝不要只包含提取出的注释行:评判注释时,需要查看它所注释的代码。

    • 用户的指示。

    • 以下附注:

      对于编辑模式:

      应用禁止规则:修正每一处违规。仅当不推荐规则中的模式明显构成噪声时才应用。仅在确信修改能改善文本时,才应用首选规则。

      对于审阅模式:

      标出每一处违反禁止规则的内容,并注明行号、问题和修正方法。当不推荐模式会造成噪声时,予以标出。若首选改进能增强文本,则提出建议。

      对于两种模式,均追加:

      回复中只能使用标准键盘上的字符。无论是你自己的文字还是改写的文本,都不要使用长破折号、短破折号、弯引号、箭头或省略号字符。

      对于编辑模式下的代码目标,追加:

      应用代码风格规则:修正每一处违规。

      对于审阅模式下的代码目标,追加:

      标出每一处违反代码风格规则的内容,并注明行号、问题和修正方法。

  3. 分派任务。

    • 如果模型是 claude,则直接在当前会话中运行,无需使用分派脚本。
    • 否则,从此技能目录运行 dispatch.sh:
      dispatch.sh <model> <prompt-file>
      
      分派脚本会处理各类运行环境特定的 CLI 细节。要添加新模型或运行环境,请编辑 dispatch.sh。
  4. 呈现结果。

    • 审阅模式: 显示编号的问题列表,其中包含行号/引文、问题和修正方法。
    • 编辑模式: 使用相关的修改前后示例简要总结。如果用户批准修改,则写入文件。

最后附上运行环境行,格式如上文所述。

评论

支持 Markdown