Share

外观
风格

workflow-article

2026年2月7日 · 工具

workflow-article(零背景可复现专栏)

用途:把“已经跑通的自动化流程”整理成一篇普通读者也能复现的专栏文章。

适用场景:

  1. 你想公开分享某个方案,但不想暴露私密配置
  2. 你想让普通用户照着文章也能复现
  3. 你希望文章有基本叙事,不是纯操作清单

触发方式(自然语言)

你不需要提供 workflow ID,直接说目标即可:

帮我写一篇可复现专栏:RSS -> AI 摘要 -> 保存到笔记

也支持类似表达:

  • 写教程
  • 写一篇分享文章
  • 复现这套工作流
  • 把这个方案整理成别人能照做的文档

默认产出结构

生成 Markdown 专栏,默认包含:

  1. 开场场景(1-2 段)
  2. 这篇能帮你做到什么
  3. 核心流程图(文字版)
  4. 准备条件(依赖、账号、环境变量)
  5. 分步实践(每步都写可见结果)
  6. 成功标准
  7. 常见问题与第一排障点
  8. 下一步建议(自动化/定时化/沉淀)

模式

  • zero-to-reproduce(默认)
    • 不假设读者在看代码
    • 正文不出现仓库路径、源码文件名、函数名
  • repo-linked(用户明确要求时)
    • 可在附录补实现路径

未明确说明时,始终使用 zero-to-reproduce


脱敏规则(必须)

文章里只允许出现模板值,不允许出现真实凭据:

  • <YOUR_API_KEY> 替代真实 key
  • <YOUR_BASE_URL> 替代真实服务地址(如需公开)
  • <YOUR_OUTPUT_PATH> 替代本机私有路径

如果源文件中含明文敏感信息,文章只描述“需要配置此项”,不原样复制。


术语规则

  1. 术语首次出现格式:术语(一句话解释)
  2. 需要时补 1-3 个权威链接(优先官方文档)
  3. 若名称不便公开,使用中性代称并补功能描述

禁止项

  1. 禁止默认引用仓库路径、源码文件名、函数名
  2. 禁止假设读者正在浏览项目代码
  3. 禁止把正文写成纯参数表或纯命令堆砌
  4. 禁止输出真实敏感信息

发布前自检

  1. 不看代码能否独立复现?
  2. 是否只讲清一件事?
  3. 主线是否可在 10 分钟读完?
  4. 每一步是否都有“看到什么算完成”?

可直接复制的提需求模板

帮我把这套流程写成可复现专栏:
- 目标读者:普通用户
- 不要引用仓库路径
- 重点:讲清一件事 + 步骤可复现
- 输出:Markdown 正文 + 一份“最低可运行命令集”

默认落盘与发布

  • 默认落盘:<REDACTED_TOKEN>
  • 默认发布:通过 <REDACTED_TOKEN> 从 Obsidian 发布到 <REDACTED_TOKEN>
  • 不需要发布时,可仅保留在 Obsidian