Agent skill

Change Verification Gate

by fengshao1227 in fengshao1227/ccg-workflow

Analyzes a code diff for documentation sync, test coverage and impact scope, warning when docs or tests lag behind a design-level change or a large edit.

MITAuto-check: notesDevelopment

SKILL.md written in Chinese; this summary is our English description.

Install Change Verification Gate

skills CLI
$ npx skills add fengshao1227/ccg-workflow --skill verify-change -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install fengshao1227/ccg-workflow verify-change --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/fengshao1227/ccg-workflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/dsh-ccg/skills/verify-change .claude/skills/verify-change && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
verify-change
GitHub stars
5.9k
Token cost
~511 tokens
SKILL.md length
89 words
Files
2 (incl. scripts)
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

Analyzes a code diff for documentation sync, test coverage and impact scope, warning when docs or tests lag behind a design-level change or a large edit.

  • Works in 4 steps: 读取 README.md — 理解模块定位 → 读取 DESIGN.md — 理解现有决策 → 评估影响范围 — 此变更影响哪些部分 → …
  • Checking whether a code change needs a documentation update
  • SKILL.md covers 核心原则, 自动分析, 检测能力 and 变更前置检查, plus 5 more sections
  • Runs JavaScript scripts from its folder; calls node

What it does

A bundled Node script classifies working-tree or staged changes by file type (code, docs, tests, config), identifies which modules are affected, and checks whether documentation and tests were updated alongside the code. It raises warnings for specific thresholds: more than 50 changed lines without a matching DESIGN.md update, more than 30 lines without a test update, a new file with no README update, or an unrecorded configuration change, plus an informational note when a deleted file's references need confirming.

Before touching any module the agent is expected to read its README and DESIGN.md to understand its role and existing decisions, and after a change to update both files, recording new or changed design decisions with their reasoning in a dated changelog section. The gate runs automatically on design-level changes, completed refactors, edits over 30 lines, and before commits, producing a structured verification report of the change overview and findings.

When your agent uses it

  • Checking whether a code change needs a documentation update
  • Verifying a refactor left no stale README or design notes
  • Reviewing a diff before committing for undocumented decisions

Example prompts

  • “检查一下这次变更的文档同步情况怎么样”
  • “提交前帮我检查一下这个 diff 有没有问题”
  • “Run the change analyzer on my staged changes and report what's missing.”

Requirements

  • Node.js 18 or newer to run scripts/change_analyzer.js
  • Compatibility (from SKILL.md): node>=18
  • Pre-approved tools (allowed-tools): Bash, Read, Grep

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. 读取 README.md — 理解模块定位
  2. 读取 DESIGN.md — 理解现有决策
  3. 评估影响范围 — 此变更影响哪些部分
  4. 确认变更理由 — 为什么要改

What it can do on your machine

Read from SKILL.md and the folder at commit f349e3d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    node>=18

    From compatibility in the SKILL.md frontmatter.

Context cost

Change Verification Gate loads about 511 tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 89 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~25
When it runs · the whole SKILL.md, loaded when a task matches
~511

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Grep

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from fengshao1227/ccg-workflow at commit f349e3d, republished under its MIT licence (© fengshao1227). 89 words, ~511 tokens.

Download SKILL.mdSave it as .claude/skills/verify-change/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
verify-change
description
变更校验关卡。分析代码变更,检测文档同步状态,评估变更影响范围。当用户提到变更检查、文档同步、代码审查、提交前检查、diff分析时使用。在设计级变更、重构完成时自动触发。
allowed-tools
Bash, Read, Grep
compatibility
node>=18
license
MIT
user-invocable
true
disable-model-invocation
false
argument-hint
--mode working|staged|committed

⚖ 校验关卡 · 变更校验

核心原则

变更 = 代码改动 + 文档更新 + 理由记录
无理由的变更是隐患,无记录的变更是灾难
每一次变更都是历史,每一个决策都要留痕

自动分析

运行变更分析脚本(跨平台):

bash
# 在 skill 目录下运行
node scripts/change_analyzer.js                    # 分析工作区变更(默认)
node scripts/change_analyzer.js --mode staged      # 分析暂存区变更
node scripts/change_analyzer.js --mode committed   # 分析已提交变更
node scripts/change_analyzer.js -v                 # 详细模式
node scripts/change_analyzer.js --json             # JSON 输出

检测能力

自动检测项
检测项说明
文件分类自动识别代码/文档/测试/配置文件
模块识别识别受影响的模块
文档同步检测代码变更是否同步更新文档
测试覆盖检测代码变更是否有对应测试
影响评估评估变更规模和影响范围
触发警告的情况
  • ⚠️ 代码变更 > 50 行但 DESIGN.md 未更新
  • ⚠️ 代码变更 > 30 行但无测试更新
  • ⚠️ 新增文件但 README.md 未更新
  • ⚠️ 配置文件变更未记录
  • ℹ️ 删除文件需确认引用已清理

变更前置检查

在修改任何模块前,必须:

  1. 读取 README.md — 理解模块定位
  2. 读取 DESIGN.md — 理解现有决策
  3. 评估影响范围 — 此变更影响哪些部分
  4. 确认变更理由 — 为什么要改

变更后置检查

代码修改完成后,必须:

README.md 更新检查
  • 模块职责是否变化 → 更新职责描述
  • 依赖关系是否变化 → 更新依赖说明
  • 使用方式是否变化 → 更新示例代码
DESIGN.md 更新检查
  • 新增设计决策 → 记录决策及理由
  • 修改现有设计 → 记录变更及原因
  • 引入新限制 → 更新已知限制
  • 添加变更记录 → 更新变更历史

变更记录格式

在 DESIGN.md 的变更历史中添加:

markdown
## 变更历史

### [日期] - [变更标题]

**变更内容**: 简述改了什么

**变更理由**: 为什么要改

**影响范围**: 影响哪些功能/模块

**决策依据**: 为何选择此方案(如适用)

自动触发时机

场景触发条件
设计级变更修改架构、接口、数据结构
重构完成重构任务完成时
代码变更 > 30 行较大规模代码修改
提交前代码提交前检查

校验流程

1. 运行 change_analyzer.js 自动分析
2. 识别变更文件和受影响模块
3. 检查文档同步状态
4. 评估变更影响
5. 输出变更校验报告

校验报告格式

## 变更校验报告

### 变更概览
- 变更文件数: N
- 代码变更行数: +X / -Y
- 受影响模块: [模块列表]

### 文档同步状态
- README.md: ✓ 已同步 / ⚠️ 需更新
- DESIGN.md: ✓ 已同步 / ⚠️ 需更新

### 测试覆盖
- 测试文件变更: ✓ 有 / ⚠️ 无

### 结论
可提交 / 需补充文档后提交

© fengshao1227, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in dsh-ccg/skills/verify-change of fengshao1227/ccg-workflow.

  • SKILL.md
  • scripts/change_analyzer.js

Open the folder on GitHubat commit f349e3d

Compare with similar skills

Change Verification Gate next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Change Verification Gate compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Change Verification Gate this skillfengshao1227/ccg-workflow5.9k—~511Automated safety check: NotesMIT
Review Implement Phaseprisma/orm48k—~1.7kAutomated safety check: PassApache-2.0
Pretty Mermaid Rendererimxv/Pretty-mermaid-skills1.5k—~2kAutomated safety check: PassMIT
Post Draft Reviewagent-substrate/substrate4.7k—~2.8kAutomated safety check: PassApache-2.0
Docs GuardamElnagdy/guard-skills1.3k—~2.1kAutomated safety check: PassMIT
Review PRGEOLYTIX/xyz133—~4.1kAutomated safety check: PassMIT

Similar skills

  • Official

    Implements triaged pull request review actions, commits focused fixes, posts status replies on GitHub and resolves the threads.

    48k GitHub stars~1.7k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Pretty Mermaid Renderer

    imxv/Pretty-mermaid-skills

    Writes and renders Mermaid diagrams as themed SVG, PNG or terminal ASCII and Unicode art with a bundled Node.js CLI that needs no browser.

    1.5k GitHub stars~2k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Post Draft Review

    agent-substrate/substrate

    Posts pull request review findings as GitHub draft (pending) inline comments for a human to edit and submit, instead of publishing them straight to the PR author.

    4.7k GitHub stars~2.8k tokensUpdated today
    DevelopmentAuto-check passed
  • Docs Guard

    amElnagdy/guard-skills

    Checks generated or edited documentation against the source code, flagging invented symbols, outdated samples and unverifiable claims before publishing.

    1.3k GitHub stars~2.1k tokensUpdated 3 mo ago
    DevelopmentAuto-check passed
  • Review PR

    GEOLYTIX/xyz

    A skill your agent uses when reviewing a pull request, a branch, or uncommitted working changes in the XYZ/MAPP repository — whether the user asks to "review this PR", "check my changes before I…

    133 GitHub stars~4.1k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Routes development, troubleshooting, review and documentation tasks on the Codex Proxy RS repository to the right section of its docs, instead of loading the whole architecture or contributing guide.

    780 GitHub stars~618 tokensUpdated today
    DevelopmentAuto-check passed

More from fengshao1227/ccg-workflow

  • Module Completeness Check

    fengshao1227/ccg-workflow

    Scans a module directory for the required README.md and DESIGN.md plus recommended files and reports what is missing, so a module is not delivered incomplete.

    5.9k GitHub stars~473 tokensUpdated 25 days ago
    Auto-check: notes
  • Code Quality Gate

    fengshao1227/ccg-workflow

    Scans code for complexity, long functions, duplicated blocks, naming problems and code smells with a Node script, then reports and suggests refactors.

    5.9k GitHub stars~593 tokensUpdated 25 days ago
    Auto-check: notes
  • Security Verification Gate

    fengshao1227/ccg-workflow

    Scans code with a bundled Node script for injection, secrets, XSS and other risky patterns, ranks findings by severity and checks that security decisions are documented.

    5.9k GitHub stars~621 tokensUpdated 25 days ago
    Auto-check: notes
  • README and DESIGN Generator

    fengshao1227/ccg-workflow

    Generates README.md and DESIGN.md skeletons for a module by scanning its structure with a Node script, then lists what to fill in by hand.

    5.9k GitHub stars~410 tokensUpdated 25 days ago
    Auto-check: notes
  • Ccg Workflow

    fengshao1227/ccg-workflow

    How to run a non-trivial change end to end with the CCG role tools (ccganalyze / ccgdesign / ccgbuild / ccgdebug / ccgoptimize / ccgreview / ccgtest) and the verify- quality gates.

    5.9k GitHub stars~2.3k tokensUpdated 25 days ago
    Auto-check passed

Works with

Categories

Questions about Change Verification Gate

What does Change Verification Gate do?

Analyzes a code diff for documentation sync, test coverage and impact scope, warning when docs or tests lag behind a design-level change or a large edit. A bundled Node script classifies working-tree or staged changes by file type (code, docs, tests, config), identifies which modules are affected, and checks whether documentation and tests were updated alongside the code.md update, more than 30 lines without a test update, a new file with no README update, or an unrecorded configuration change, plus an informational note when a deleted file's references need confirming.

When should I use Change Verification Gate?

Change Verification Gate fits situations like: checking whether a code change needs a documentation update; verifying a refactor left no stale README or design notes; reviewing a diff before committing for undocumented decisions.

How do I install Change Verification Gate in Claude Code?

Run `npx skills add fengshao1227/ccg-workflow --skill verify-change -a claude-code`. Or copy the skill folder (dsh-ccg/skills/verify-change in fengshao1227/ccg-workflow) into .claude/skills/verify-change in your project. Claude Code loads it when a task matches its description.

How do I install Change Verification Gate in Codex?

Run `npx skills add fengshao1227/ccg-workflow --skill verify-change -a codex`. Or copy the skill folder (dsh-ccg/skills/verify-change in fengshao1227/ccg-workflow) into .agents/skills/verify-change in your project. Codex loads it when a task matches its description.

Can I use Change Verification Gate in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add fengshao1227/ccg-workflow --skill verify-change -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/verify-change, .gemini/skills/verify-change, .github/skills/verify-change and .opencode/skills/verify-change in your project.

What does Change Verification Gate need to run?

Going by SKILL.md and its folder, Change Verification Gate needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node). Our summary lists: Node.js 18 or newer to run scripts/change_analyzer.js. Its frontmatter pre-approves these tools: Bash, Read, Grep. Compatibility (from SKILL.md): node>=18.

Does Change Verification Gate access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Change Verification Gate safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Change Verification Gate use?

Change Verification Gate is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Change Verification Gate use?

About 511 tokens (SKILL.md is roughly 2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Change Verification Gate?

Skills that share tags, products or a category with Change Verification Gate: Review Implement Phase (prisma/orm, 48k stars), Pretty Mermaid Renderer (imxv/Pretty-mermaid-skills, 1.5k stars), Post Draft Review (agent-substrate/substrate, 4.7k stars) and Docs Guard (amElnagdy/guard-skills, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Change Verification Gate?

fengshao1227 (a GitHub user) maintains it in fengshao1227/ccg-workflow, which has 5,935 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on September 15, 2026.

Source: fengshao1227/ccg-workflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.