workflow-article
workflow-article(零背景可复现专栏)
用途:把“已经跑通的自动化流程”整理成一篇普通读者也能复现的专栏文章。
适用场景:
- 你想公开分享某个方案,但不想暴露私密配置
- 你想让普通用户照着文章也能复现
- 你希望文章有基本叙事,不是纯操作清单
触发方式(自然语言)
你不需要提供 workflow ID,直接说目标即可:
帮我写一篇可复现专栏:RSS -> AI 摘要 -> 保存到笔记
也支持类似表达:
- 写教程
- 写一篇分享文章
- 复现这套工作流
- 把这个方案整理成别人能照做的文档
默认产出结构
生成 Markdown 专栏,默认包含:
- 开场场景(1-2 段)
- 这篇能帮你做到什么
- 核心流程图(文字版)
- 准备条件(依赖、账号、环境变量)
- 分步实践(每步都写可见结果)
- 成功标准
- 常见问题与第一排障点
- 下一步建议(自动化/定时化/沉淀)
模式
zero-to-reproduce(默认)- 不假设读者在看代码
- 正文不出现仓库路径、源码文件名、函数名
repo-linked(用户明确要求时)- 可在附录补实现路径
未明确说明时,始终使用 zero-to-reproduce。
脱敏规则(必须)
文章里只允许出现模板值,不允许出现真实凭据:
- 用
<YOUR_API_KEY>替代真实 key - 用
<YOUR_BASE_URL>替代真实服务地址(如需公开) - 用
<YOUR_OUTPUT_PATH>替代本机私有路径
如果源文件中含明文敏感信息,文章只描述“需要配置此项”,不原样复制。
术语规则
- 术语首次出现格式:
术语(一句话解释) - 需要时补 1-3 个权威链接(优先官方文档)
- 若名称不便公开,使用中性代称并补功能描述
禁止项
- 禁止默认引用仓库路径、源码文件名、函数名
- 禁止假设读者正在浏览项目代码
- 禁止把正文写成纯参数表或纯命令堆砌
- 禁止输出真实敏感信息
发布前自检
- 不看代码能否独立复现?
- 是否只讲清一件事?
- 主线是否可在 10 分钟读完?
- 每一步是否都有“看到什么算完成”?
可直接复制的提需求模板
帮我把这套流程写成可复现专栏:
- 目标读者:普通用户
- 不要引用仓库路径
- 重点:讲清一件事 + 步骤可复现
- 输出:Markdown 正文 + 一份“最低可运行命令集”
默认落盘与发布
- 默认落盘:
<REDACTED_TOKEN> - 默认发布:通过
<REDACTED_TOKEN>从 Obsidian 发布到<REDACTED_TOKEN> - 不需要发布时,可仅保留在 Obsidian