
ECC Article Writing 技能解析为 Agent Harness 编写长文写作规范的设计与落地【免费下载链接】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 仓库中的 article-writing 技能定义完整拆解这套面向 Agent 的长文写作技能规范它的激活条件、五条核心写作规则、语音voice处理机制、禁用模式清单、五步写作流程、按内容类型的结构指引和交付前质量门。读完你可以理解 ECC 如何把像人写、不像 LLM 写这类模糊要求压缩成一份可被 Agent 直接执行、可被其他技能brand-voice、content-engine、crosspost复用的结构化工作流。技能文件的存放结构与双份副本在 ECC 仓库中技能以目录 SKILL.md的形态组织。article-writing存在两份内容基本一致的副本.agents/skills/article-writing/SKILL.md面向 Agent 加载的技能目录目录下还附有 agents/openai.yaml用于声明该技能在 agent 侧的展示与调用策略skills/article-writing/SKILL.md仓库技能主目录中的同技能副本其 frontmatter 额外带有metadata.origin: ECC标记。两份文件的 frontmatter 均遵循统一的字段约定--- 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. ---这里name是技能标识description同时承担两个职责向人说明技能用途向 Agent 提供何时应该激活的判断依据——描述里明确圈定了边界超过一段的成品文案、且语音一致性、结构、可信度三者重要的场景。Agent 侧的元数据见 openai.yaml其中定义了display_name: Article Writing、short_description: Long-form content in a supplied voicedefault_prompt: Use $article-writing to draft polished long-form content in the supplied voice.即该技能的默认调用提示词模板policy.allow_implicit_invocation: true表示允许在用户未显式点名技能时由 Agent 根据任务语境隐式调用该技能。此外在 install-modules.json 中skills/article-writing被列在第 506 行作为模块路径清单的一部分参与安装体系注册仓库的本地化文档目录中也存在对应的中文译文 docs/zh-CN/skills/article-writing/SKILL.md 与日文译文 docs/ja-JP/skills/article-writing/SKILL.md供多语言读者对照阅读。技能定位一句话定义技能正文的开篇第一句就是它的核心主张Write long-form content that sounds like an actual person with a point of view, not an LLM smoothing itself into paste.直译写出来要像一个有观点的真实的人而不是一个把自己抹平成人造膏状物的 LLM。整个 SKILL.md 的其余章节规则、禁令、流程、结构、质量门都是围绕这一句展开的可执行化拆解。激活条件四种典型触发场景When to Activate一节列出了技能应被调用的四类场景起草博客文章、随笔、产品发布帖、指南、教程或 Newsletter 期数把零散笔记、访谈转录稿、调研材料整理润色成正式文章依据已有样例匹配某个创始人、运营者或品牌的既有写作声音voice对已写完的长文案做结构、节奏与证据链的收紧tightening structure, pacing, and evidence。值得注意的是第 4 条该技能不仅用于从零写也用于改已有稿。这决定了后文的规则中会有大量面向删改而非扩写的指令。核心规则五条以具体物为先的写作纪律Core Rules给出五条硬性规则这是整个技能的方法论骨架Lead with the concrete thing先给具体的东西段落和开头优先放工件artifact、例子、输出、轶事、数字、截图或代码Explain after the example, not before解释放在例子之后而不是之前先展示后解释Keep sentences tight unless the source voice is intentionally expansive除非源声音刻意铺陈否则句子保持紧凑Use proof instead of adjectives用证据替代形容词能拿出数字、机制、产出的就不用强大卓越这类修饰词Never invent facts, credibility, or customer evidence绝不虚构事实、可信度背书或客户证据。五条规则的共同点是证据优先。第 1、2 条规定了信息出现的顺序先物后言第 4、5 条规定了断言的成本断言必须有据且不得编造第 3 条则把紧凑设为默认、把铺陈设为需要源声音显式授权的例外。从规则结构看这份技能刻意把 LLM 长文写作中最常见的三类毛病——开头空转、形容词堆叠、无据断言——逐一映射成了禁止行为。语音处理先跑 brand-voice复用 VOICE PROFILEVoice Handling一节定义了 article-writing 与仓库内 brand-voice 技能的协作契约如果用户要求特定写作声音先运行brand-voice直接复用其产出的VOICE PROFILE除非用户明确要求否则不在此技能内重复做第二轮风格分析Do not duplicate a second style-analysis pass here如果没有提供任何声音参考则回退到默认的sharp operator voice锋利的运营者声音concrete具体、unsentimental不煽情、useful有用。这套协作在仓库中是有对应实现的。brand-voice 技能的输出契约见 references/voice-profile-schema.md要求产出一个结构化、短小、可放进会话上下文复用的VOICE PROFILE文本块字段包括VOICE PROFILE Author: Goal: Confidence: Source Set - source 1 - source 2 - source 3 Rhythm - short note on sentence length, pacing, and fragmentation Compression - how dense or explanatory the writing is Capitalization - conventional, mixed, or situational Parentheticals - how they are used and how they are not used Question Use - rare, frequent, rhetorical, direct, or mostly absent Claim Style - how claims are framed, supported, and sharpened Preferred Moves - concrete moves the author does use Banned Moves - specific patterns the author does not use CTA Rules - how, when, or whether to close with asks Channel Notes - X: - LinkedIn: - Email:Schema 末尾附带的编写准则同样值得注意profile 必须concrete and source-backed具体且有来源支撑、用短 bullet 而非段落、每一条 Banned Move 必须能在来源集中观察到或用户显式要求、来源集内部冲突时要指出分歧而不是平均成糊call out the split instead of averaging it into mush。brand-voice 自身还规定了素材优先级recent X 帖子 文章/备忘录/发布稿 真实外发邮件 产品文档与站点文案以及采集工作流5 到 20 个代表性样本、优先新材料、区分公开发布声音与私人工作声音等。article-writing 通过复用这一 profile避免在每次写作任务里重新推导风格——这正是该技能把声音一致性从一次性模仿变成可复用资产的设计意图。禁用模式清单七种必须删除重写的写法Banned Patterns一节列出了遇到就必须删除并重写的七种模式禁用模式针对的问题In todays rapidly evolving landscape空转的时代背景开场game-changer、cutting-edge、revolutionary无证据的营销级形容词heres why this matters 作为独立桥接句不承载信息的过渡句fake vulnerability arcs伪脆弱叙事弧线为共情而共情的人设表演只为刷互动而加的结尾提问互动诱饵engagement bait与论点推进无关的生平垫料biography padding不推动论证的背景注水延迟切入正题的泛化 AI 式开场白generic AI throat-clearing模板化寒暄这份清单与仓库内相邻技能形成了交叉印证。content-engine 技能 的Hard Bans与 brand-voice 的Hard Bans覆盖了高度重叠的模式同样的 In todays rapidly evolving landscape、同样的 game-changer/revolutionary/cutting-edge 词组、heres why this matters 除非后接具体内容否则禁用、以及禁止用结尾提问刷回复说明 ECC 在多个内容类技能之间维护了一份事实上的共用反模式表article-writing 持有其中面向长文写作场景的子集。五步写作流程Writing Process把起草过程固化为五个有序步骤Clarify the audience and purpose先明确读者是谁、这次写作要完成什么目的Build a hard outline with one job per section搭建硬大纲每个小节只承担一个职责Start sections with proof, artifact, conflict, or example每个小节以证据、工件、冲突或例子开场Expand only where the next sentence earns space只在下一句挣得了空间时才展开——即展开本身需要由内容必要性驱动而非凑篇幅Cut anything that sounds templated, overexplained, or self-congratulatory删掉一切听起来模板化、过度解释或自我表扬的内容。步骤 2 的 one job per section 与步骤 4 的 earns space 是这套流程中约束力最强的两条前者限制了单节信息熵后者把扩写从默认行为变成了需要论证的例外行为。分内容类型的结构指引Structure Guidance一节按三种内容形态给出差异化结构要求而不是给出一套通用模板技术指南Technical Guides开篇直接告诉读者你能得到什么open with what the reader gets主要章节必须使用代码、命令、截图或具体输出use code, commands, screenshots, or concrete output in major sections结尾给可执行的要点actionable takeaways而不是软性的内容回顾soft recap。随笔 / 观点文Essays / Opinion以张力tension、矛盾或一个具体观察开场每个小节只保留一条论证线one argument thread per section观点必须对证据负责make opinions answer to evidence——即每个断言都要能被文内证据或外部来源核对。Newsletter保证第一屏在做实事keep the first screen doing real work即读者不滚动就能看到有效信息不前置日记式填充do not front-load diary filler分节标签section labels只在确实提升可扫读性时才使用。三类指引的共同取向是首屏即产出、结构即论证与核心规则中先给具体物的要求完全同向。质量门交付前的五项检查Quality Gate要求交付前逐项核对事实性断言都有提供的来源支撑factual claims are backed by provided sources泛化 AI 过渡句已清除generic AI transitions are gone声音与提供的样例或约定的VOICE PROFILE一致每个小节都贡献了新信息every section adds something new排版与目标媒介匹配formatting matches the intended medium——同一篇内容投放在博客、Newsletter 或文档体系时格式要求不同。这五项分别对应了前文各节的检查点来源对应核心规则 5过渡句对应禁用模式声音对应 Voice Handling每节新信息对应流程第 2、4 步排版则落实了结构指引中适配媒介的要求。可以说质量门是全文各章节在交付时刻的一次汇总验证。在 ECC 内容管线中的位置从源码结构看article-writing 并非孤立技能而是 ECC 内容生产线中的一个节点上游brand-voice 负责从真实素材提炼VOICE PROFILE是声音这一维度的唯一事实来源brand-voice 文档中明确写道若其他技能已有声音捕获小节以 brand-voice 为准下游content-engine 负责把文章/素材改编成 X、LinkedIn、短视频、YouTube、Newsletter 等平台原生内容其文档中列出了brand-voice声音画像与crosspost平台分发为关联技能crosspost 则负责多平台分发适配并要求分发前同样先检查会话中是否已有VOICE PROFILE、没有就先跑 brand-voice。也就是说ECC 把提炼声音 → 写长文 → 平台化改编 → 跨平台分发拆成了职责单一、彼此通过VOICE PROFILE契约衔接的多个技能article-writing 承担其中写长文这一环。这种拆分让每个技能文件保持短小、规则可枚举、可被 Agent 在单次会话内完整遵守也避免了在单个技能里堆叠全部写作场景导致的规则冲突。快速参考技能主文件.agents/skills/article-writing/SKILL.md同内容副本 skills/article-writing/SKILL.mdAgent 侧接口与调用策略.agents/skills/article-writing/agents/openai.yaml含默认提示词模板与隐式调用开关声音契约来源.agents/skills/brand-voice/SKILL.md 与 VOICE PROFILE schema下游管线skills/content-engine/SKILL.md、skills/crosspost/SKILL.md安装注册manifests/install-modules.jsonskills/article-writing位于第 506 行本地化译文中文、日文。一句话总结article-writing 把好文章这个模糊目标翻译成了 Agent 可执行的检查表——先证据后解释、每节一个职责、声音走统一 profile、七种反模式零容忍、交付前五项质检——并通过与 brand-voice、content-engine、crosspost 的契约衔接成为 ECC 内容管线中可复用、可验证的一环。【免费下载链接】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),仅供参考