用途
zudoesa-articlify 用于把当前对话内容转换为 esa 文章。它本身不直接写作,而是先整理出一份详细的写作简报,再委派给 zudoesa-writer 子代理完成文章撰写。该技能强调:仅在用户明确要求时才调用,绝不主动提议使用。
主要能力
从对话历史中提取写作所需素材,包括:讨论的主题、尝试过的多种方案(A、B、C 等)、哪些可行哪些不可行、关键技术细节、代码片段与命令、最终结论或采用方案、表达过的观点与洞察。
支持 --conversation 模式。当 $ARGUMENTS 中包含 --conversation 时,文章必须原样保留真实对话:绝不总结对话,忠实再现实际对话流程;保留「なるほど」「ふーん」「どう思う?」「OK」「hum...」等口语化表达,作为对话质感的一部分;仅做错别字修正与轻度格式化,不重构、不压缩、不改写用户措辞。必须保留原始语言,不翻译:对话是英文则保持英文,是日文则保持日文,混合语言则原样保留。翻译会破坏用户想保留的原始素材。文章 frontmatter 标题与极少量脚手架标题可以使用日文,但对话正文必须保持原语言。
处理对话中的图片:根据主题确定文章 slug(例如 20260209-package-json-organization),在 esa 仓库中创建图片目录,复制图片并使用描述性文件名,记录图片路径供写作简报使用。Markdown 引用格式为
。
生成写作简报:产出一份详尽、自包含的提示词,让子代理在没有任何对话上下文的情况下也能完成写作。简报需包含文章主题、背景、故事线、技术细节(具体代码、命令、配置、错误信息)、需覆盖的要点清单、图片及其 markdown 路径与说明、结论、语气指引。简报应做到零上下文的人也能据此写出完整文章。
委派子代理:使用 Agent 工具以 run_in_background: true 启动 zudoesa-writer 子代理,避免写作期间阻塞用户。子代理会读取仓库写作风格指南,按 esa 惯例写作(默认日文,指定 --conversation 时保留原始语言),使用公式 999999999999 - YYYYMMDDHHMM 设置 sidebar_position 以保证新文章靠前,保存到文章目录并运行格式检查。
校验与回报:子代理完成后,读取生成的文章文件,校验 frontmatter 中是否包含 sidebar_position,且其值符合 999999999999 - YYYYMMDDHHMM 公式;若缺失或错误则直接修正。最后报告文章文件路径与内容摘要。
使用方式
调用时可通过 $ARGUMENTS 提供额外指引,用于指定聚焦点或写作角度;包含 --conversation 时进入对话保留模式。
适用场景
把技术讨论、问题排查过程、多方案对比或日常交流沉淀为 esa 文章。尤其适合需要在保留原始对话质感的前提下生成文章的场合。
限制与注意事项
写作简报是子代理收到的唯一上下文,因此必须详尽。简报中应包含真实代码片段、错误信息与命令输出。若对话涉及多个主题,应向用户询问要写成文章的是哪一个。图片必须在委派之前复制,因为子代理看不到对话中的图片;简报中需包含完整的 markdown 图片引用路径。费用、价格、平台等其它信息资料未提供。