cm-doc-syncer SKILL.md skillA

cm-doc-syncer from kingxiaozhe/cm-workflow is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add kingxiaozhe/cm-workflow/cm-doc-syncer@git:20260916.9ebbf71

Pins git:20260916.9ebbf71 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
kingxiaozhe/cm-workflow
Path
skills/cm-doc-syncer/SKILL.md
Versions recorded
5
Latest version
git:20260916.9ebbf71, committed Sep 16, 2026
First version recorded
Jul 7, 2026
Size
8,777 bytes
Repository stars
97
License
MIT

文档同步 Skill,开发完成后自动更新 README、.claude/ 配置、specs CHANGELOG,保持文档与代码一致.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file 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

The exact contents, by fingerprint
mdr add kingxiaozhe/cm-workflow/cm-doc-syncer@sha256:cf71c54ee07f30ec

The line at the top of this page pins the label git:20260916.9ebbf71, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

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

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Jul 7, 2026 and Sep 16, 2026, about one every 18 days.

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. Fixed automatic checks with no AI involved, so the same checks give the 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 · 97 stars · license MIT · pushed 2026-11-03 · 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 AI assistant 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.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from kingxiaozhe/cm-workflow

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

Every file in kingxiaozhe/cm-workflow

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