JCM Article Writing

这个 skill 用于把文章写作前的素材、规则和写作方向整理清楚，尤其适合“金尘马式 AI 干货写作”：面向小白、讲人话、解决具体问题，最后交付能收藏、能照着做的文章素材和结构。

核心原则：

素材来源必须明确。
写作规则必须匹配文章类型。
资料整理只保留当前有效结果，不记录讨论过程。
大纲协作只保留当前有效结构和约束，不记录来回讨论过程。
没有用户明确给出的素材地址时，先问地址，不自作主张。
没有用户明确给出的保存目录时，默认使用用户当前项目目录下的 jcm-article-writing-workspace/articles/。
公开版默认读取本 skill 内的公开参考文件；如果用户有自己的风格文档，可以使用用户当前项目目录下的 jcm-article-writing-workspace/style/ 保存和读取。
不要把用户生成的素材、索引、大纲、初稿、改稿或个人风格文档写入 skill 安装目录。

能力边界

本 skill 当前负责：

确认文章选题和写作目标。
明确本次写作使用的素材来源。
根据用户提供的素材地址读取本地资料。
按需要进行联网检索并整理资料。
生成素材卡和素材索引。
基于素材和用户反馈协作生成或更新结果态大纲。
在 AI 干货写作场景下读取公开文风参考。
为后续大纲、初稿、改稿提供干净素材基础。
初稿完成后，在用户确认下做一次基于公开文风参考的独立审稿。

本 skill 不默认完成：

直接生成完整成稿。
自动进入改稿。
自动发布到任何平台。
自动选择某个本地目录作为素材来源。
在用户未确认前自动启动审稿。
做社交媒体传播标注。

如果用户要求大纲、初稿、改稿、配图或发布，可以继续协助，但必须先确认素材来源和输出目标。

适用场景

使用本 skill 处理这些任务：

用户有一个文章选题，想先整理素材。
用户要求搜索攻略、教程、案例或资料并保存。
用户提供了一篇笔记、一个目录、一个素材索引或一组链接，希望整理成写作素材。
用户已经有素材，想讨论标题、结构、章节取舍、写作角度或大纲。
用户要写 AI 干货文章，尤其强调面向小白、讲人话、能实操、有收藏价值。
用户正在为 AI 干货文寻找文风、结构、低 AI 味或写作约束资料。

不要用本 skill 处理这些任务：

把素材转成社交媒体短内容候选池。
发布到 X、公众号、Substack、LinkedIn。
整理日记、笔记或任务清单。

素材来源规则

进入素材整理、大纲、初稿或改稿前，必须先确认本次使用哪份素材。

素材来源可以是：

单篇笔记路径。
目录路径。
素材索引路径。
用户粘贴的原始文本。
用户提供的一组链接。
用户要求联网检索得到的来源。

如果用户要求基于已有素材写作，但没有明确给出素材地址，必须先问：

这次写作要基于哪份素材？请给我笔记路径、目录路径、素材索引路径，或者直接粘贴原始素材。

如果用户要求“全网检索”“先搜素材”“找资料”，这本身就是素材来源，不需要再追问本地素材地址，直接进入检索。

不要自行猜测已有素材来源。

不要默认读取任何本地私人目录。

不要因为标题相似就自动选择已有文件。

默认项目工作区

公开版提供默认项目工作区，用来降低普通用户的使用门槛。

默认工作区位置在用户当前项目目录下：

./jcm-article-writing-workspace/

这里的 ./ 指用户当前正在工作的项目目录，不是本 skill 的安装目录。如果无法判断当前项目目录，先询问用户希望把写作项目保存到哪里。

默认结构：

jcm-article-writing-workspace/
  articles/
    {选题目录}/
      素材/
        00-素材索引.md
        01-{来源或主题简名}.md
      01-文章大纲.md
      02-文章初稿.md
  style/
    user-writing-style.md

使用规则：

如果用户提供了保存目录，优先使用用户提供的目录。
如果用户没有提供保存目录，默认在用户当前项目目录下创建 jcm-article-writing-workspace/articles/{选题目录}/。
{选题目录} 使用选题标题生成，去掉不适合作为文件名的符号，保持简短可读。
素材卡默认保存到 jcm-article-writing-workspace/articles/{选题目录}/素材/。
素材索引默认保存为 jcm-article-writing-workspace/articles/{选题目录}/素材/00-素材索引.md。
大纲默认保存为 jcm-article-writing-workspace/articles/{选题目录}/01-文章大纲.md。
初稿默认保存为 jcm-article-writing-workspace/articles/{选题目录}/02-文章初稿.md。
如果用户想加入自己的文风规则但没有现成路径，默认让用户把规则写入或粘贴到 jcm-article-writing-workspace/style/user-writing-style.md。
如果默认工作区或子目录不存在，可以直接创建，不需要再次询问。
不要在 skills/jcm-article-writing/ 下创建用户文章项目。

执行流程

1. 确认写作目标

先确认这次要写什么，以及写给谁。

如果用户已经说清楚选题和目标读者，直接进入下一步。

如果选题不清楚，只问一个问题：

这篇文章的选题标题你想暂定为什么？

2. 确认素材来源

检查用户是否已经提供素材地址、原始文本或链接。

如果没有，先询问素材来源。

如果用户要求全网检索，先把选题拆成 2-5 个检索方向，再搜索。

常见检索方向：

官方功能和产品规则。
实操教程和小白步骤。
案例、模板、提示词。
风险、限制、隐私和常见误区。
研究论文或行业背景。

3. 读取或检索素材

本地素材按用户给出的路径读取。

联网检索采用“先 Web Search，后 XCrawl”的分层策略：

先用自身 Web Search / 普通网页打开能力检索和读取来源。
如果 Web Search 能搜到结果，也能打开并获得足够正文，就直接基于 Web Search 整理素材，不额外调用 XCrawl。
如果 Web Search 只能看到搜索摘要、打不开正文、正文为空、遇到动态渲染页面、反爬/验证页、脚本片段、登录墙、地区限制，或无法确认关键事实，则升级使用 xcrawl。
使用 xcrawl 时，优先抓取具体 URL，而不是重新泛搜；输出格式优先用 markdown、summary、links，必要时再用 json 抽取结构化信息。
如果 xcrawl 仍无法获取正文，要在素材卡或素材索引的「写作注意」里说明：普通 Web Search / XCrawl 分别卡在哪里，当前判断来自搜索摘要、其他交叉来源，还是仍需人工浏览器验证。

联网检索时遵守这些优先级：

官方文档、帮助中心、开发者文档、产品公告。
权威媒体、研究论文、可信行业报告。
高质量个人教程、实践案例、工具指南。
社区讨论只作为补充，不能作为唯一依据。

对会变化的产品功能、价格、入口、模型能力，必须核验最新来源。

不要保存低质量 SEO 拼贴文章。

不要大段复制受版权保护的网页内容。

4. 确认或创建保存位置

保存素材卡或索引前，检查用户是否提供保存目录。

如果用户已经提供保存目录，使用用户指定的位置。

如果用户没有提供保存目录，默认创建并使用：

./jcm-article-writing-workspace/articles/{选题目录}/素材/

不要因为用户没给保存目录就卡住流程。

5. 保存素材卡

每个有效来源保存为一篇 Markdown 素材卡。

文件命名：

NN-{来源或主题简名}.md

素材卡 Front Matter：

---
created: YYYY-MM-DD HH:mm:ss
title: {素材卡标题}
categories: []
tags: []
source: {来源方}
source_url: {来源链接}
---

如果来源是用户粘贴文本或本地文件，source_url 可以省略，正文要注明来源类型。

素材卡正文结构：

# {素材卡标题}

## 来源信息

- 来源：{来源方}
- 链接：{URL}
- 适用章节：{这条素材适合支撑文章哪个部分}

## 核心信息

用自己的话概括来源内容。不要整段复制网页原文。

## 对选题有用的点

列出这条素材能支撑的判断、步骤、例子或反面提醒。

## 可转化成文章段落

写 1-3 段可直接启发后续写作的中文表达。可以给示例说法，但不要冒充最终成稿。

## 小白操作提示

如果来源适合教程化，整理成步骤、模板或 checklist。不适合教程化时可以省略本节。

## 写作注意

记录来源限制、版本差异、隐私风险、需要二次核验的信息。

6. 保存素材索引

素材索引用于快速判断后续怎么写，不记录中间讨论过程。

索引文件命名：

00-素材索引.md

Front Matter：

---
created: YYYY-MM-DD HH:mm:ss
title: {选题}：素材索引
categories: []
tags: []
content_role:
  - 选题
---

正文结构：

# {选题}：素材索引

## 选题定位

用 2-5 句话说明这篇文章面向谁、解决什么问题、核心切入点是什么。

## 核心写作判断

只保留当前有效判断，不保留被否决的候选。

## 建议行文逻辑

给出适合当前选题的阅读路径。不要写成资料目录。

## 已整理素材

- [[01-...]]
- [[02-...]]

## 可直接复用的模板或清单

如果本选题适合干货写作，整理可收藏、可照抄、可执行的内容。

## 后续动作

说明下一步可以进入大纲、初稿、改稿、配图或发布适配。

7. 大纲协作阶段

当用户开始讨论标题、结构、章节取舍、写作角度、读者定位或大纲时，进入大纲协作阶段。

大纲协作的目标不是一次性生成完美大纲，而是把素材和用户反馈持续收敛成一份结果态大纲。

执行原则：

先读取用户指定的素材索引、素材卡和已加载的写作规则。
如果用户已经给出明确方向，直接更新大纲，不要重复追问。
每轮用户反馈都要吸收进同一份当前大纲。
只保留当前有效标题、定位、结构、写作约束和后续动作。
被否决的标题、章节、角度和判断不要留在正文里。
不要把讨论过程、修改历史、分歧过程写进大纲，除非用户明确要求。

大纲文件建议命名：

01-文章大纲.md

大纲 Front Matter：

---
created: YYYY-MM-DD HH:mm:ss
title: {选题或标题}：文章大纲
categories: []
tags: []
content_role:
  - 大纲
---

大纲正文至少包含：

# {选题或标题}：文章大纲

## 文章定位

说明目标读者、核心问题、文章承诺和不展开的范围。

## 标题

保留当前确认的标题。如果用户明确确认了标题，不要擅自改动。

## 素材双链索引

按用途列出本大纲实际参考的素材卡，方便后续 AI 或人工写作回溯来源。

- {用途}：[[素材卡 1]]、[[素材卡 2]]

## 核心主张

只保留当前有效判断。

## 正文结构

按阅读路径列出章节，每节写清楚要解决的问题、要保留的判断和可用素材。

## 文章可复用组件

只列真正能降低读者行动成本的模板、清单、提示词或流程。不要为了显得“干货”机械堆工具。

## 写作注意

记录用户明确确认或纠正过的标题偏好、语气、表达边界、读者假设和章节取舍原则。

## 后续动作

说明下一步可以进入初稿、继续补素材、改标题或改结构。

大纲协作检查：

目标读者检查：每一节是否服务目标读者和文章主线。
读者负担检查：是否加入了会让目标读者觉得复杂、偏题或暂时用不上的内容。
可复用组件检查：模板、清单、提示词是否真的降低行动成本。
约束继承检查：用户明确纠正过的标题、格式、语气和结构偏好是否已经写进「写作注意」。
素材回溯检查：大纲中的素材双链是否能对应到真实素材卡。

标题协作规则：

当用户讨论标题时，不只评价准确性，还要识别用户想要的标题功能：吸引点击、制造利益感、降低门槛、建立身份认同、突出结果承诺等。
用户明确确认标题后，不要擅自改字、加空格、改标点或替换表达。
主标题（H1 + Front Matter 的 title 字段）默认不在中英文、中文和数字、中文和英文单词之间加空格。例：写「沉淀为skill，让AI替你打工」，不要写「沉淀为 skill，让 AI 替你打工」。正文段落、小标题、代码块仍按一般排版规范加空格。这条偏好的理由是主标题更像标语和传播文本，节奏紧凑、视觉连贯比规范化排版更重要。

暂停点：

大纲确认后先停止，询问是否进入初稿。不要自动从大纲跳到成稿。

8. 质量检查

完成后检查：

用户指定的素材来源都已处理。
用户指定的保存位置已遵守。
所有 Markdown 都有合法 Front Matter。
素材卡都有来源说明。
素材索引中的双链文件名和真实文件名一致。
大纲中的素材双链文件名和真实素材卡一致。
大纲只保留当前有效结构和判断，没有记录被否决的候选或讨论过程。
大纲中的写作注意已吸收用户明确纠正过的偏好和约束。
没有大段复制受版权保护的网页内容。
明确区分“来源确认的信息”和“从资料中推导出的写作判断”。

AI 干货写作规则加载

当用户要写 AI 干货文章，尤其出现以下信号时，先加载写作规则：

面向非技术小白、AI 小白、普通人。
要求讲人话、接地气、不堆术语。
要求不拖泥带水、一针见血。
要求实用、扎实、能照着上手。
要求让读者有收藏欲。
要求降低 AI 味、保留真人判断。

优先读取本 skill 内的公开文风参考：

references/writing-style.md

如果用户有自己的风格文档、平台规范或写作样本，可以让用户额外提供路径；只有用户明确提供时才读取。

如果用户没有现成风格文档，但希望沉淀自己的文风，默认使用：

./jcm-article-writing-workspace/style/user-writing-style.md

当这个文件不存在时，可以在用户当前项目目录下创建一个空模板，让用户后续补充。不要临时猜测私人目录，也不要默认读取本仓库外的任何本地资料。

加载后按“干货小白文”标准判断：

不追求大而全，只讲清楚一个细点。
每篇解决一个具体问题。
优先提供模板、清单、提示词、流程、避坑标准等可收藏内容。
术语第一次出现时必须翻译成人话。
结构服务理解和行动，不写成百科、说明书或培训课件。
改稿时用低 AI 味规则做质检，避免光滑、套路化、虚构读者误解和过度完整。

初稿审稿（用户确认后触发）

初稿完成后，主 agent 必须主动问一次用户是否需要审稿。

可以照抄这句问法：

初稿已经写完。要不要让另一个 agent 独立审一稿，按照公开文风规则做一次质检？

只有用户明确确认后才进入审稿流程。用户没确认或拒绝，跳过本节。

审稿依据

审稿只基于这些材料：

当前 skill 的 references/writing-style.md。
用户提供的素材、素材索引或链接。
当前确认的大纲。
当前初稿。
用户额外提供的风格文档、平台要求，或用户当前项目目录下 jcm-article-writing-workspace/style/user-writing-style.md 中已经填写的规则。

不要读取未由用户提供的本地目录。不要把私人知识库、私有样本或其他未公开文件当作默认审稿依据。

审稿方式

如果环境支持 sub-agent，可以让另一个 agent 做独立审稿；如果不支持，就由当前 agent 按同一套依据自查，但要明确说明审稿依据来自公开文风参考和用户材料。

审稿 prompt 可按下面结构写：

你是一个独立审稿 agent，不参与本文写作过程。请按下面流程做一次审稿：

1. 读当前初稿：{初稿文件路径或用户粘贴的初稿}
2. 读当前 skill 的公开文风参考：references/writing-style.md
3. 读用户提供的素材、素材索引、大纲和额外风格要求。
4. 按公开文风参考自行判断要审查哪些方向。如果遇到具体路径、产品功能、价格、入口、模型能力等需要核验的信息，要么读用户提供的来源核实，要么在报告里标“待核实”，不要凭推测下结论。
5. 关注但不限于这些大方向：
   - 信息取舍与一篇只讲一件事。
   - 小白可执行性、减负原则、操作准确性。
   - 标题、小标题、开头、结尾是否服务读者行动。
   - 低 AI 味信号：空泛、套路、过度完整、假装共情、虚构读者误解。
   - 排版规范：短段落、清晰列表、术语翻译、中文标点统一。
   - 真人判断、取舍理由和真实限制。
6. 返回结构化报告，格式如下：

   ## 审稿结论
   一句话总体评价。

   ## 必改（命中硬规则）
   - 位置：{小节/段落/句子定位}
   - 命中规则：{公开文风参考中的规则}
   - 建议改法：{具体改法}

   ## 建议改（可商榷）
   - 位置：{...}
   - 问题：{...}
   - 建议：{...}

   ## 可保留的判断点
   如果发现有的地方表面上像问题但实际服务表达，列出来说明，避免主 agent 误改。

报告必须具体到段落或句子，不要泛泛说“风格有问题”。每条问题都要给改法建议，不要只指出问题。

收到审稿报告后

主 agent 把报告整理成简洁列表给用户看，按“必改 / 建议改”两类区分。

由用户决定哪些落地，不要在用户没确认前就自己改稿。

如果“可保留的判断点”里有内容，主 agent 要复述给用户看，避免误改用户原本的判断。

输出给用户

最终回复保持简洁，说明：

使用了哪些素材来源。
保存到了哪个目录。
素材卡数量。
覆盖了哪些资料类型。
是否有未能核验或需要后续补查的点。

不要在最终回复里粘贴全部素材正文。

jcm-article-writing

Installation

Summary

Stronger alternatives

Similar popular skills

Agent compatibility

Repository health

Package contents

History

SKILL.md