Home / kingxiaozhe / cm-workflow · skills/cm-doc-syncer/SKILL.md · GitHub

cm-doc-syncer skillA

cm-doc-syncer is agent-read markdown (skill) from kingxiaozhe/cm-workflow: 文档同步 Skill,开发完成后自动更新 README、.claude/ 配置、specs CHANGELOG,保持文档与代码一致.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# cm-doc-syncer — 文档同步器

在所有开发任务完成后,自动同步更新项目文档。确保文档和代码保持一致。

## 触发条件

由 `/cm-ai` 在最后任务的独立审查前调用;收口阶段只核验已审文档。

## 输入

- specs 文件夹路径
- 代码项目路径(可多个)
- LESSONS.md 中积累的架构决策
- 本 specs 批次全部 feature/task 的原始改动证据、开工快照和最后任务的批准文档写范围

## 执行步骤

### 1. 扫描变更

对每个代码项目,先读其 CLAUDE.md「版本控制」字段,按值选变更识别方式(显式分支,不得自行发明):

- `remote` / `local` → `git diff {基线}..HEAD` 获取已提交候选;基线先取上一份 CHANGELOG 的 `base-commit`,无则取已确认的 scaffold/初始 commit。无法确认时记录基线缺口,改用下述本批次任务证据,不把全量文件当变更集
- `none` 或项目无 `.git` → 用本批次 handoff/diff 和开工快照定位文件,再核实当前内容;tasks 只确定任务清单,不能仅凭勾选项推断真实改动
- 字段缺失但有 `.git` → 按 `local` 处理

**本轮范围是当前 specs 批次的全部 feature/task,恢复后仍按同一批次;不等于最后一个任务。**
从有效批准清单、tasks 和各任务已有 handoff/diff 记录汇总变更路径;旧任务只读已绑定记录,
最后任务使用正在定稿的真实 diff。不能只凭 checkbox、时间、文件名或任意旧 Review 认定归属。

将本轮已提交差异与所有任务尚未提交的 staged、unstaged、新建/删除文件合并,按当前代码净变化去重。
早期任务已完成却仍未提交的改动属于本轮,不能因它出现在最后任务的开工快照里就当作用户原改动排除。
对照各任务开工快照和实际 diff 按片段排除用户原有改动;同文件混有他人修改、来源或批次不明时只报告缺口,不猜归属。

汇总仅用于读取;最后任务仍只写事先批准的文档范围,不重新修改旧任务源码、状态或凭证。
没有可信证据时明确“同步范围待确认”,不得按全量文件清单替代变更归属证明或宣称全部同步。

随后(与版本控制方式无关):

- 识别新增的目录、模块、API、数据模型
- 从 specs 的 requirements.md 获取功能描述;requirements.md 缺失 → 该 feature 跳过描述提取并在最终输出中上报「specs 不完整」,不得凭 tasks.md 猜功能描述
- 从 LESSONS.md 获取架构决策和踩坑记录;文件不存在 → 按 0 条处理,不报错不中断
…

Read the whole file at its exact version.

How to install

Latest version
mdr add kingxiaozhe/cm-workflow/cm-doc-syncer@git:20260916.9ebbf71
Exact content
mdr add kingxiaozhe/cm-workflow/cm-doc-syncer@sha256:cf71c54ee07f30ec

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_kh5hy3rrko7v732q.svg)](https://markdownregistry.com/a/art_kh5hy3rrko7v732q)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260916.9ebbf71 latest2026-09-16 9ebbf71 8,777 BA view · diff
git:20260723.03144052026-07-23 0314405 7,141 BA view · diff
git:20260716.39c4c872026-07-16 39c4c87 7,087 BA view · diff
git:20260709.b8d73be2026-07-09 b8d73be 3,543 BA view · diff
git:20260707.60332da2026-07-07 60332da 3,155 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8777 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

kingxiaozhe/cm-workflow · 29 stars · license MIT · pushed 2026-09-24 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_kh5hy3rrko7v732q
GET https://markdownregistry.com/api/v1/resolve?ref=kingxiaozhe/cm-workflow/cm-doc-syncer
GET https://markdownregistry.com/api/v1/blob/cf71c54ee07f30ecca2f05a64f91fa96b0642d5fa45f5c02a69562582786d2fd

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from kingxiaozhe/cm-workflow

CLAUDE.md@.claude claude
kingxiaozhe/cm-workflow · .claude/CLAUDE.md
git:20260917.8e7a8ed · audit A · 29 stars
AGENTS.md agents
kingxiaozhe/cm-workflow · AGENTS.md
git:20260924.3f79f65 · audit A · 29 stars
cm-ai skill
kingxiaozhe/cm-workflow · skills/cm-ai/SKILL.md · 用户明确说“规格已确认,开始实现”或要求按已审批 CM specs 开发时使用。新任务默认由 JS workflow 驱动 N1-N8,完成开发、独立审查、QA 与文档同步;模糊点子、未审规格和单独一句“继续”不能触发编码批准。
git:20260924.056a6a9 · audit A · 29 stars
cm-backend-engineer skill
kingxiaozhe/cm-workflow · skills/cm-backend-engineer/SKILL.md · 后端 API 工程师 Skill,执行服务端 API 层开发(路由、业务逻辑、鉴权中间件、缓存、队列),自动适配语言和框架
git:20260723.0314405 · audit A · 29 stars
cm-check skill
kingxiaozhe/cm-workflow · skills/cm-check/SKILL.md · 用户说“检查工作流是否安装正确”“为什么找不到 cm 命令”时使用。默认查询 npm 稳定版,有新版自动升级已管理的 CM 安装,再检查插件、核心 Skills、兼容包装与模板引用;不测试或修改业务代码。
git:20260920.38ea993 · audit A · 29 stars
cm-contract-engineer skill
kingxiaozhe/cm-workflow · skills/cm-contract-engineer/SKILL.md · 智能合约工程师 Skill,执行合约开发、测试、部署,自动适配 EVM/Solana/Move 等链和开发框架
git:20260723.0314405 · audit A · 29 stars
cm-database-engineer skill
kingxiaozhe/cm-workflow · skills/cm-database-engineer/SKILL.md · 数据库工程师 Skill,执行数据模型设计、migration、查询优化,自动适配 ORM 和数据库类型
git:20260723.0314405 · audit A · 29 stars
cm-devops-engineer skill
kingxiaozhe/cm-workflow · skills/cm-devops-engineer/SKILL.md · 发布/运维工程师 Skill,执行 staging 部署、冒烟验证、发布记录与生产发布待决清单编制,自动适配部署栈;生产发布与基础设施变更强制人工确认
git:20260804.c914f1d · audit A · 29 stars
cm-finance-expert skill
kingxiaozhe/cm-workflow · skills/cm-finance-expert/SKILL.md · 金融专家 Skill,覆盖 Web3 与证券/资产/交易领域的正确性审核、营销合规红线识别、合规问题清单生成、业务验收协同;把关型角色,只举旗不定性
git:20260723.0314405 · audit A · 29 stars
cm-fix skill
kingxiaozhe/cm-workflow · skills/cm-fix/SKILL.md · 用户说“修复这个可复现 bug”或要求根据失败报告修代码时使用。执行红灯测试、根因定位、最小修复、独立审查和回归;尚未确认的问题先用 cm-test,新功能和架构重设计转交 cm-prd。
git:20260924.9116423 · audit A · 29 stars
cm-frontend-engineer skill
kingxiaozhe/cm-workflow · skills/cm-frontend-engineer/SKILL.md · 前端工程师 Skill,执行前端开发任务,自动适配项目技术栈(React/Vue/Svelte/Next.js 等),支持 Figma/Stitch 设计稿还原
git:20260723.0314405 · audit A · 29 stars
cm-idea skill
kingxiaozhe/cm-workflow · skills/cm-idea/SKILL.md · 用户说“我有个点子”“帮我梳理产品”或需要先聊清目标时使用。通过逐题访谈整理为可交给 cm-prd 的 PRD;已有明确需求文档时改用 cm-prd,不写代码、不拆开发任务。
git:20260918.eae0cf7 · audit A · 29 stars

Every file in kingxiaozhe/cm-workflow

Browse by kind, by grade A, or by owner.