ECC article-writing 技能详解：用一份 SKILL.md 约束 Agent 写出没有 AI 味的长文

ECC article-writing 技能详解用一份 SKILL.md 约束 Agent 写出没有 AI 味的长文【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC本文基于 ECC 仓库中 .cursor/skills/article-writing/SKILL.md 展开完整拆解这个文章写作技能的激活条件、核心规则、声音捕捉工作流、禁用模式与质量门禁并结合 skills/article-writing/SKILL.md、skills/brand-voice/SKILL.md 等仓库源码说明同一技能在不同 Agent Harness 间的分发与演进差异。读完后你能理解 ECC 如何用一份纯 Markdown 技能文件为 Claude Code、Cursor 等编码 Agent 装配可复用的长文写作能力以及如何为自有项目编写类似的结构化写作技能。技能定位写给 Agent 的编辑手册ECC 的定位是 Agent harness 性能优化系统其中 Skills 是核心资产之一。按照 docs/SKILL-DEVELOPMENT-GUIDE.md 的定义Skill 是基于上下文自动激活的被动知识模块context-based, automatic与需要显式委派的 Agent、用户触发的 Command、事件触发的 Hook 相区分组件用途激活方式Skill知识库上下文匹配自动Agent任务执行者显式委派Command用户动作用户调用/commandHook自动化事件触发article-writing就是一个典型的写作领域知识技能它不含可执行代码而是把一整套长文写作的编辑规范、工作流和质量门禁沉淀为 Agent 可在会话中直接消费的指令集。技能文件采用 YAML frontmatter Markdown 正文的标准结构frontmatter 字段在 docs/SKILL-DEVELOPMENT-GUIDE.md 中有完整说明name与description必填origin、tags、version可选。.cursor/skills/下这份文件的 frontmatter 如下引自 SKILL.md--- name: article-writing description: Write articles, guides, blog posts, tutorials, newsletter issues, and other long-form content in a distinctive voice derived from supplied examples or brand guidance. Use when the user wants polished written content longer than a paragraph, especially when voice consistency, structure, and credibility matter. origin: ECC ---注意两个细节description字段同时承担了技能是什么和何时该激活两个职责——它明确写出 Use when the user wants polished written content longer than a paragraph这正是技能自动激活的匹配依据origin: ECC是平铺写法而主目录 skills/article-writing/SKILL.md 使用嵌套的metadata: { origin: ECC }。两份文件内容并不完全相同这一点后文会专门展开。技能开篇用一句话定调Write long-form content that sounds like a real person or brand, not generic AI output.写听起来像真人或真实品牌的内容而不是泛泛的 AI 输出。全文所有规则都服务于这个目标。何时激活四类触发场景技能中 When to Activate 一节列出了 Agent 应加载此技能的四个场景起草博客文章、随笔、发布帖、指南、教程或 newsletter 期刊把笔记、转录稿或调研素材整理成润色后的文章从既有示例中匹配某位创始人、运营者或品牌的写作声音收紧已有长文的结构、节奏与论据密度。第四点值得注意该技能不仅服务于从零写作也覆盖对既有长稿的结构化修订——这使它更像一份可反复套用的编辑流程而非一次性的生成提示词。核心规则五条硬约束Core Rules 一节给出了五条写作铁律是全文最短但约束力最强的部分先给具体的东西以例子、输出结果、轶事、数字、截图描述或代码块开头解释放在例子之后而不是之前优先使用短而直接的句子而非填充式的长句有来源的具体数字优先可用且可溯源时使用精确数字绝不虚构传记事实、公司指标或客户证据。这五条规则的本质是把可信度前置第 1、2 条保证信息传递效率证据先行第 3 条保证可读性第 4、5 条划定事实边界。对 Agent 写作而言第 5 条尤其关键——它直接禁止了 LLM 最常见的失败模式编造履历、杜撰数据、虚构客户证言。声音捕捉工作流如何复刻一种写作声音这是.cursor版本中最具操作性的章节Voice Capture Workflow。当用户要求某种特定声音时工作流分三步第一步收集语料。收集以下材料中的一种或多种已发布的文章newsletterX / LinkedIn 帖子文档或内部备忘录一份简短的风格指南第二步提取风格特征。从语料中显式抽取五个维度句长与节奏sentence length and rhythm声音基调正式、口语化还是锋利偏好的修辞手法括号、列表、碎片句或设问对幽默、观点、反直觉表述的容忍度格式习惯标题、项目符号、代码块、引用块的用法第三步确定默认值。如果没有提供任何声音参照默认采用直接的运营者风格direct, operator-style voice具体、务实、少炒作。从源码结构看这套提取五维度的做法与 skills/brand-voice/SKILL.md 中 What to Extract 一节的思路高度同构后者提取的是节奏、压缩度、大小写规范、括号使用、设问频率、断言锋利度等更细的维度并额外要求记录作者从不做什么。也就是说.cursor版本把声音捕捉逻辑内联在技能内部而主目录版本把它外置给了brand-voice技能——这是同一能力在不同 Harness 中的两种装配方式。禁用模式一份必须删除重写的黑名单Banned Patterns 一节给出了五类必须删除并重写的语言模式泛化的开场白如 In todays rapidly evolving landscape在当今快速变化的格局下填充式连接词如 Moreover、Furthermore炒作短语如 game-changer、cutting-edge、revolutionary没有证据支撑的模糊断言未由提供上下文支撑的传记或资历声明。这份黑名单的价值在于它把反模式写成了可逐条核对的检查项Agent 在交付前可以逐项扫描正文。对比主目录 skills/article-writing/SKILL.md 的 Hard Bans 清单可以看到同一约束的演进主版本删除了 Moreover/Furthermore 一类连接词条目转而新增 fake vulnerability arcs虚假示弱弧线、heres why this matters 作为孤立桥句、为刷互动而加的结尾设问、拖住论点的一般性 AI 开场白等更具体的条目——黑名单从句式层面下沉到了叙事结构层面。五步写作流程Writing Process 一节规定了从选题到成稿的标准流程明确受众与目的建立骨架大纲每个小节只承担一个目的每个小节以证据、例子或场景开头只在下一句话值得占据这个位置时才展开删除一切听起来模板化或自吹自擂的内容。第 2 条一节一目的与第 4 条句子准入制是控制长文冗余的核心机制第 5 条则对应前文 Core Rules 中解释在后的落地检查。结构指引三类长文各有一套骨架Structure Guidance 按文体分了三套结构规范技术指南开篇先说读者能带走什么open with what the reader gets每个主要章节使用代码或终端示例以具体的 takeaways 收尾而不是软性的总结。随笔 / 观点文以张力、矛盾或锐利观察开头每节保持单一条论证线用配得上该观点的例子来支撑观点。Newsletter第一屏首屏保持有力洞见与更新混合呈现而非日记式填充使用清晰的章节标签和便于略读的结构。三套骨架的共同点是都规定了开头必须是什么和结尾不能是什么把文体差异压缩成了可执行的开头/结尾约束而不是抽象的写作建议。质量门禁交付前的五项检查Quality Gate 一节要求交付前完成五项自检对照提供的来源核验事实性声明删除填充语与企业腔确认声音与提供的示例匹配确保每个章节都贡献了新信息检查排版是否符合目标发布平台。这条门禁与 Core Rules 第 5 条不虚构首尾呼应写作过程中禁止虚构交付前再核验一次事实来源形成双重保险。源码级观察同一技能的双版本分发与技能协作网络.cursor/skills/目录是 ECC 面向 Cursor Harness 的技能分发位。通过逐行对比可以确认两份SKILL.md是有意分叉而非简单拷贝主要差异有四处声音处理架构不同。.cursor版本内置完整的 Voice Capture Workflow 章节如上文详述主版本改为 Voice Handling明确要求若用户要求特定声音先运行brand-voice并复用其VOICE PROFILE不要在此重复第二遍风格分析。也就是说主版本把声音建模收敛为单一事实源single source of truth避免两个技能各自维护一套风格分析逻辑frontmatter 结构不同。.cursor版本用平铺的origin: ECC主版本用嵌套的metadata: { origin: ECC }表述强度不同。.cursor版本的默认声音是 concrete, practical, and low on hype主版本收紧为 concrete, unsentimental, usefulCore Rules 第 3 条也从偏好短句变为除非源声音刻意舒展否则保持句子紧凑即主版本对源声音的还原度要求更高禁用清单不同。如前所述主版本删除了连接词条目、新增了叙事结构层面的反模式。从分发机制看skills/article-writing被收录在 manifests/install-modules.json 中约第 506 行说明它属于模块化安装体系中的可安装组件用户可按 profile 选择性安装。在仓库内部该技能与若干内容类技能构成协作关系skills/brand-voice/SKILL.md 是声音画像的规范层其 Downstream Use 一节明确列出 article writing 为下游消费方skills/content-engine/SKILL.md多平台内容引擎声明brand-voice是规范声音层并要求在多次输出、对风格敏感的场景先运行它skills/skill-scout/SKILL.md 的技能清单表中将article-writing定位为起草文章与指南并提示它不包含发布说明release notes场景——这种技能边界说明帮助用户在多个写作类技能之间做选择。从这套引用关系可以推断ECC 的写作能力被拆成了声音画像brand-voice→ 长文写作article-writing→ 平台分发content-engine的分层结构article-writing处于中间层向上承接声音画像向下为多平台复用提供成稿。可落地的要点总结技能文件的可执行性来自可核对article-writing的价值不在于写作理论而在于每条规则都能被 Agent 逐条扫描执行——五条 Core Rules、五项 Banned Patterns、五项 Quality Gate 都是检查项式的约束声音捕捉是可迁移的方法收集语料 → 提取句长节奏 / 语气 / 修辞 / 容忍度 / 格式习惯 → 无参照时回退默认声音这套流程可直接移植到任何需要模仿特定写作风格的提示词工程中同一技能在不同 Harness 中可以有意的分叉.cursor/skills/内联声音工作流、主目录版本委托brand-voice说明技能装配应按目标 Agent 的能力面裁剪而不必强求单一副本编写自有技能时可对照的标准参照 docs/SKILL-DEVELOPMENT-GUIDE.md 的 frontmatter 规范与 When to Activate / 核心规则 / 反模式 / 相关技能 的章节骨架即可产出结构等价的领域写作技能。【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考