| name | source-to-commit-workflow |
| description | 一键执行「新闻源整理 → 延伸并入正文 → 改动说明与提交」全流程。依次执行 news/source.md 多篇整理到 files/source/、docs 内延伸与参考并入正文、根目录中文改动说明 MD、英文 commit，可选 push。当用户说「一键执行」「三个 skill 一起跑」「全流程」时使用。 |
新闻源 + 延伸并入正文 + 提交 一键工作流
按固定顺序依次执行三阶段，无需用户分步触发。执行前确认：news/source.md 存在且为当前要处理的源；工作区为项目根。
总览
Phase A 新闻源整理 news/source.md → Plan → 逐篇整理 → files/source/*.md → 检查
Phase B 延伸并入正文 扫描 docs 含「延伸与参考」的 MD → 每条入对应小节末 → 删文末块
Phase C 改动说明与提交 写根目录改动说明 MD（中文）→ 英文 commit → 若用户说上传则 push
Phase A：新闻源整理（对应 news-pdf-integration）
-
Plan（必做）
- 读取
news/source.md 全文。
- 识别多篇文章边界（主标题、END、下一篇文章标题、留言等为界）。
- 列出：序号、标题/主题、建议输出文件名
files/source/<主题简写>.md。
- 确认共 N 篇。
-
逐篇整理
- 对每篇：截取该篇正文 → 原创归纳（核心观点、术语、结论、数据），不逐段抄录 → 写入
files/source/<主题简写>.md。
- 单篇结构：标题、整理说明、分节正文、可选「—— 整理自 Xbotics 具身智能学习指南 | 供学习参考」。
-
检查
- 每篇：内容与原文核心一致、无实质遗漏或偏差；主产出均在
files/source/。
-
可选
- 若本次新增内容需进文档：在
files/papers/ 或 files/interviews/ 做索引/摘要，并在 docs 相应小节加延伸链接（见 news-pdf-integration 第七、八节）。
Phase B：延伸并入正文（对应 docs-extensions-inline）
-
扫描
- 在
docs/ 下查找含「### 延伸与参考」「### 延伸阅读」「### 参考」的 .md 文件。
-
对每个文件
- 列出该块内每条链接及主题。
- 按主题选定目标小节末尾（概念→核心节末；视频/VAM→视频生成节末；机器人/VLA→机器人节末；产业→应用场景节末）。
- 在目标小节末插入「延伸：显示文本（说明）」；删除「### 延伸与参考」到该块最后一条之间的全部内容；保留文末导航。
-
路径
- 相对路径以当前 MD 所在目录为基准（如
../../files/source/xxx.md）。
Phase C：改动说明与提交（对应 commit-changelog-workflow）
-
写改动说明 MD（必须）
- 位置：仓库根目录，文件名
改动说明-XXX.md（如 改动说明-新闻源整理与文档skill更新.md）。
- 语言：中文。
- 内容须含：
- 一、知识库新增/更新总览：表格（类型、名称、路径、说明），覆盖本次 Phase A 新增的
files/source/*.md、Phase B 修改的 docs 文件、以及本次若有 Step 3 的 papers/interviews 与 docs 链接。
- 二、逐条说明：每条「知识库位置」「内容概要」「链接」（仓库内 GitHub 链接 + 可选外部）。
- 三、小结：共新增/修订 X 项。
- 便于直接摘编为公众号。
-
提交
git add：包含本次改动的所有文件（含新增的 files/source/*.md、修改的 docs、根目录 改动说明-XXX.md）。若用户明确说「改动说明不上传」，则把该文件名加入 .gitignore 且不要 add 该文件。- Commit 信息：英文，概括本次操作，例如
docs: source digests, inline extensions, and changelog 或 docs: news integration + extensions inline + changelog。
- Push：仅当用户明确说「上传」「push」时执行
git push；否则只做到 commit。
执行顺序与检查清单
若某阶段无工作可做（例如 source.md 无新文章、或 docs 已无「延伸与参考」块），可跳过该阶段，但 Phase C 的改动说明与 commit 仍要执行，用于记录本次其他改动。
与原子 Skill 的关系
- 本工作流覆盖「news-pdf-integration」「docs-extensions-inline」「commit-changelog-workflow」在本项目中的连续执行；三者仍可单独调用。
- 细节（如单篇 MD 模板、延伸放置原则、改动说明固定格式）以各原子 skill 为准，此处仅给出执行顺序与最小必要步骤。
