Agent skill

Git Changes Reporter

by No-Trade-No-Life in No-Trade-No-Life/Yuan

生成结构化 git 变更报告(JSON + Markdown)。使用此技能当用户提到"git 变更"、"commit 摘要"、"代码审查"、"release note"、"近期改动"、"每日摘要",或需要分析指定 commit 区间的代码变更。包含三元组结构(设计意图、核心代码、影响范围)的语义化报告,适用于代码审查、发布说明、团队同步、CI/CD 等场景。

MITAuto-check passedDevelopment

Install Git Changes Reporter

skills CLI
$ npx skills add No-Trade-No-Life/Yuan --skill git-changes-reporter -a claude-code

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

GitHub CLI
$ gh skill install No-Trade-No-Life/Yuan git-changes-reporter --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/No-Trade-No-Life/Yuan.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/git-changes-reporter .claude/skills/git-changes-reporter && 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
git-changes-reporter
GitHub stars
352
Token cost
~1.2k tokens
SKILL.md length
225 words
Files
9 (incl. scripts, references)
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

生成结构化 git 变更报告(JSON + Markdown)。使用此技能当用户提到"git 变更"、"commit 摘要"、"代码审查"、"release note"、"近期改动"、"每日摘要",或需要分析指定 commit 区间的代码变更。包含三元组结构(设计意图、核心代码、影响范围)的语义化报告,适用于代码审查、发布说明、团队同步、CI/CD 等场景。

  • Works in 4 steps: 分段读取 JSON 文件(按需读取,避免超出 token 限制) → 理解变更的技术意图和业务影响 → 选择重要的代码片段展示 → …
  • Tasks that involve Git workflow
  • SKILL.md covers 何时使用本 Skill, 核心原则, 工作流程 and 报告模板与关键要求, plus 2 more sections
  • Runs JavaScript and Shell scripts from its folder; calls git

What it does

Git Changes Reporter is an agent skill from No-Trade-No-Life/Yuan. 生成结构化 git 变更报告(JSON + Markdown)。使用此技能当用户提到"git 变更"、"commit 摘要"、"代码审查"、"release note"、"近期改动"、"每日摘要",或需要分析指定 commit 区间的代码变更。包含三元组结构(设计意图、核心代码、影响范围)的语义化报告,适用于代码审查、发布说明、团队同步、CI/CD 等场景。

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including scripts and reference files (for example `references/bad-examples.md`, `references/report-template.md` and `scripts/README.md`).

It sits in Development, covering Git workflow, Changelog and release notes and Commit messages. It works with Git and npm. The repository describes itself as: Yuan - Personal Investment Operating System. The licence is MIT.

When your agent uses it

  • Tasks that involve Git workflow
  • Tasks that involve Changelog and release notes
  • Tasks that involve Commit messages

Example prompts

  • “git 变更”
  • “commit 摘要”
  • “release note”
  • “/git-changes-reporter”

Requirements

  • Python 3
  • Node.js
  • A Bash shell

Workflow steps

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

  1. 分段读取 JSON 文件(按需读取,避免超出 token 限制)
  2. 理解变更的技术意图和业务影响
  3. 选择重要的代码片段展示
  4. 按照下方模板格式输出最终 Markdown 报告

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 6 files in scripts/ (JavaScript and Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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.

Context cost

Git Changes Reporter loads about 1.2k tokens when it runs, and up to ~6.8k if it reads all its reference files. Until then it costs about 50 tokens; SKILL.md has 225 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~50
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.8k

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 passed

The automated check found no risky patterns in SKILL.md.

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 No-Trade-No-Life/Yuan at commit 10695de, republished under its MIT licence (© No-Trade-No-Life). 225 words, ~1,185 tokens.

Download SKILL.mdSave it as .claude/skills/git-changes-reporter/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.
name
git-changes-reporter
description
生成结构化 git 变更报告(JSON + Markdown)。使用此技能当用户提到"git 变更"、"commit 摘要"、"代码审查"、"release note"、"近期改动"、"每日摘要",或需要分析指定 commit 区间的代码变更。包含三元组结构(设计意图、核心代码、影响范围)的语义化报告,适用于代码审查、发布说明、团队同步、CI/CD 等场景。

Git Changes Reporter

何时使用本 Skill

满足以下任一条件时,应使用本 Skill:

  • 需要为人类工程师生成可读的变更摘要(团队同步、代码审查、发布说明)
  • 需要为 Agent 提供完整 git 变更上下文以回答后续问题
  • CI/CD 流水线中需要存储和分析变更记录
  • 用户提到"近期改动"、"commit 摘要"、"release note"等需求

不要使用本 Skill 的情况:

  • 仅需列出 commit 列表(直接用 git log)
  • 单个 commit 的详细分析(直接用 git show)

核心原则

Agent 主导判断
  • 脚本:只负责数据收集,不做内容选择
  • Agent:阅读数据,判断重要性,选择展示内容,撰写分析
简洁至上

上下文是共享资源。报告应该:

  • 聚焦意图:不仅说"做了什么",更要说"为什么"
  • 代码片段优先:5-15 行核心代码胜过长篇解释
  • 结构化呈现:用列表和表格而非段落堆砌
渐进式披露

三个分析深度级别:

  • Level 1 (基础):统计信息、目录热度、贡献者分析
  • Level 2 (中级):含代码片段、风险识别、领域聚类(默认)
  • Level 3 (深度):含调用关系、完整风险评估、详细影响分析

工作流程

阶段一:生成结构化 JSON

目的:收集原始数据,自动提取代码片段和风险指标

bash
.claude/skills/git-changes-reporter/scripts/generate-json.js <old_commit> <new_commit> [output_path] [options]

选项:

选项说明默认值
--markers=FILE1,FILE2,...项目边界特征文件(用于 monorepo 分析)package.json,Cargo.toml,go.mod,...

Monorepo 项目检测:

脚本会自动扫描仓库中的特征文件(如 package.json、Cargo.toml)来识别项目边界,支持任意深度的嵌套结构:

bash
# 默认使用常见特征文件检测项目
generate-json.js HEAD~10 HEAD

# 指定特定的特征文件(如纯 Python 项目)
generate-json.js HEAD~10 HEAD --markers=pyproject.toml,setup.py

输出内容:

  • directoryAnalysis:目录热点分析
    • topLevel[]:顶层目录统计(如 apps, libraries)
    • projects[]:项目级别统计(如 apps/vendor-okx, libraries/protocol)
      • project:项目路径
      • fileCount:变更文件数
      • marker:检测到的特征文件(如 package.json)
    • markersUsed:使用的特征文件列表
  • commits[]:每个 commit 的详细信息
    • short:短哈希(用于引用)
    • subject:提交主题
    • conventionalCommit:解析的 feat/fix/refactor 等类型
    • files[]:变更文件列表
      • path:文件路径
      • changeType:added/modified/deleted/renamed
      • codeSnippets[]:自动提取的函数/类/接口定义(最多 15 行)
  • analysis.domains[]:自动识别的技术领域
  • analysis.riskIndicators[]:风险指标(breaking_change/large_refactor/no_tests/api_change)
  • contributors[]:贡献者统计
阶段二:Agent 阅读 JSON 并生成报告

Agent 职责:

  1. 分段读取 JSON 文件(按需读取,避免超出 token 限制)
  2. 理解变更的技术意图和业务影响
  3. 选择重要的代码片段展示
  4. 按照下方模板格式输出最终 Markdown 报告

读取策略(JSON 文件可能较大):

bash
# 读取概览信息
Read JSON offset=0 limit=100  # meta, contributors, analysis 部分

# 按需读取具体 commit
Read JSON offset=X limit=200  # 特定 commit 的详细信息
阶段三:质量验证

目的:确保报告符合质量要求,防止胡编乱造

第一次验证:基础检查

验证报告格式和结构完整性:

bash
.claude/skills/git-changes-reporter/scripts/validate-report.js <markdown_file>

检查内容:

  • 必需章节(概览、核心变更、贡献者、风险评估)
  • 代码片段格式
  • 文件引用格式
  • Commit hash 格式
  • 设计意图完整性
第二次验证:严格模式(默认启用)

验证报告内容真实性,防止胡编乱造:

bash
# 严格模式已默认启用(提供 --json 即可)
.claude/skills/git-changes-reporter/scripts/validate-report.js <markdown_file> \
  --json <json_file>

严格模式自动检查:

  • ✅ Commit 覆盖率:确保 100% 覆盖 JSON 中所有 commits,无遗漏
  • ✅ 文件引用真实性:验证所有文件路径存在于仓库(通过 git ls-files)
  • ✅ Commit hash 真实性:验证所有 commit hash 存在于仓库(通过 git cat-file)

如需仅做格式检查(不推荐):

bash
# 使用 --basic 禁用严格验证
.claude/skills/git-changes-reporter/scripts/validate-report.js <markdown_file> \
  --json <json_file> \
  --basic
第三次验证:人工复查清单(可选)

生成二次确认清单供 Agent 逐项复查:

bash
.claude/skills/git-changes-reporter/scripts/validate-report.js <markdown_file> \
  --json <json_file> \
  --checklist

清单内容:

  • 列出所有应覆盖的 commits
  • 统计代码片段数量
  • 显示文件引用列表

工作流建议:

  1. 首次生成报告:先运行基础验证,修复格式问题
  2. 内容完善后:运行严格模式(默认启用,只需提供 --json),确保内容真实性
  3. 提交前:使用 --checklist 进行人工复查

重要:严格验证已默认启用,Agent 无法跳过真实性检查,有效防止胡编乱造。

报告模板与关键要求

Agent 必须使用三元组结构 + 提交明细输出每个核心变更:

  1. 设计意图(为什么做,至少 50 字)
  2. 核心代码(5-15 行代码片段 + 文件引用)
  3. 影响范围(影响的模块和注意事项)
  4. 提交明细(每个 commit 一句话:hash: 做了什么)

⚠️ 全覆盖要求:核心变更章节必须涵盖所有提交,不能遗漏任何一个 commit。

完整模板、示例和详细要求:见 references/report-template.md > 避免常见错误:见 references/bad-examples.md

故障排除

问题解决方案
JSON 文件太大无法一次读取分段读取:先读 meta/analysis,再按需读具体 commit
不确定哪些变更重要优先看 riskIndicators 和 conventionalCommit 类型
Commit 数量太多按领域分组,相似变更合并描述

参考资源


版本:3.0.0 上次更新:2025-12-06

© No-Trade-No-Life, 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 8 other files (scripts, references) in .claude/skills/git-changes-reporter of No-Trade-No-Life/Yuan.

  • SKILL.md
  • references/bad-examples.md
  • references/report-template.md
  • scripts/README.md
  • scripts/create-daily-report-pr.sh
  • scripts/generate-github-links.js
  • scripts/generate-json.js
  • scripts/get-daily-commit-range.sh
  • scripts/validate-report.js

Open the folder on GitHubat commit 10695de

Compare with similar skills

Git Changes Reporter 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.

Git Changes Reporter compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Git Changes Reporter this skillNo-Trade-No-Life/Yuan352—~1.2kAutomated safety check: PassMIT
Version Bump and ReleaseescapeWu/perplexity-ai171—~528Automated safety check: PassMIT
Git Workflow and Versioningaddyosmani/agent-skills105k2 repos~3.5kAutomated safety check: NotesMIT
Verdaccio Pull Request Workflowverdaccio/verdaccio18k—~1.9kAutomated safety check: PassMIT
Hunk Release Workflowmodem-dev/hunk9.6k—~3.8kAutomated safety check: PassMIT
AionUi Version BumpiOfficeAI/AionUi33k—~2.1kAutomated safety check: PassApache-2.0

Similar skills

  • Version Bump and Release

    escapeWu/perplexity-ai

    Bumps a project version, updates both changelogs, builds the frontend, then commits, tags and pushes the release.

    171 GitHub stars~528 tokensUpdated 13 days ago
    DevelopmentAuto-check passed
  • Git Workflow and Versioning

    addyosmani/agent-skills

    Sets git habits for every change: short-lived branches, atomic commits with descriptive messages, clean pull requests, plus versioning, tagging and changelogs for releases.

    105k GitHub starsUsed in 2 repos~3.5k tokens
    DevelopmentAuto-check: notes
  • Takes a change through a verdaccio pull request: branch, local checks, changeset, title and body, labels, CI and review rounds, and ports to other release lines.

    18k GitHub stars~1.9k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Hunk Release Workflow

    modem-dev/hunk

    Maintainer workflow for preparing, publishing, verifying and curating Hunk releases, with confirmation gates before tags, publishes and public edits.

    9.6k GitHub stars~3.8k tokensUpdated today
    DevelopmentAuto-check passed
  • AionUi Version Bump

    iOfficeAI/AionUi

    Automates an AionUi release: checks the latest AionCore release and its artifacts, updates package.json, writes the changelog, opens a PR and tags the release.

    33k GitHub stars~2.1k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Worktrunk Release Workflow

    max-sixty/worktrunk

    Walks a maintainer through cutting a Worktrunk release: sync the release branch, pass two test gates, review the changes, then publish.

    9.2k GitHub stars~7.5k tokensUpdated today
    DevelopmentAuto-check passed

More from No-Trade-No-Life/Yuan

  • Vendor Implementation

    No-Trade-No-Life/Yuan

    基于Hyperliquid成功实现经验,为新交易所供应商提供Yuan框架集成指南。使用此技能当需要为新的交易所创建供应商实现,包括项目结构设计、API集成、核心服务实现和最佳实践。适用于交易所API集成、金融系统开发、微服务架构设计。

    352 GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Context Management

    No-Trade-No-Life/Yuan

    在多轮对话和多 Agent 协作场景下,帮助模型管理指令、项目状态和长上下文。通过外部文档与会话笔记实现可控的“记忆”、指令冲突检测和高质量交接。适用于任务跨多次调用、跨 Agent、需要稳定行为规范时使用。

    352 GitHub stars~1.4k tokensUpdated 5 mo ago
    Auto-check passed

Works with

Categories

Questions about Git Changes Reporter

What does Git Changes Reporter do?

生成结构化 git 变更报告(JSON + Markdown)。使用此技能当用户提到"git 变更"、"commit 摘要"、"代码审查"、"release note"、"近期改动"、"每日摘要",或需要分析指定 commit 区间的代码变更。包含三元组结构(设计意图、核心代码、影响范围)的语义化报告,适用于代码审查、发布说明、团队同步、CI/CD 等场景。. Git Changes Reporter is an agent skill from No-Trade-No-Life/Yuan.

When should I use Git Changes Reporter?

Git Changes Reporter fits situations like: tasks that involve Git workflow; tasks that involve Changelog and release notes; tasks that involve Commit messages.

How do I install Git Changes Reporter in Claude Code?

Run `npx skills add No-Trade-No-Life/Yuan --skill git-changes-reporter -a claude-code`. Or copy the skill folder (.claude/skills/git-changes-reporter in No-Trade-No-Life/Yuan) into .claude/skills/git-changes-reporter in your project. Claude Code loads it when a task matches its description.

How do I install Git Changes Reporter in Codex?

Run `npx skills add No-Trade-No-Life/Yuan --skill git-changes-reporter -a codex`. Or copy the skill folder (.claude/skills/git-changes-reporter in No-Trade-No-Life/Yuan) into .agents/skills/git-changes-reporter in your project. Codex loads it when a task matches its description.

Can I use Git Changes Reporter 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 No-Trade-No-Life/Yuan --skill git-changes-reporter -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/git-changes-reporter, .gemini/skills/git-changes-reporter, .github/skills/git-changes-reporter and .opencode/skills/git-changes-reporter in your project.

What does Git Changes Reporter need to run?

Going by SKILL.md and its folder, Git Changes Reporter needs JavaScript and a shell for the scripts in its folder and the command-line tools its instructions call (git). Our summary lists: Python 3; Node.js; A Bash shell.

Does Git Changes Reporter access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Git Changes Reporter safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. 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 Git Changes Reporter use?

Git Changes Reporter is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Git Changes Reporter use?

About 1.2k tokens (SKILL.md is roughly 4.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.6k tokens, read only when the agent opens those files.

What are the alternatives to Git Changes Reporter?

Skills that share tags, products or a category with Git Changes Reporter: Version Bump and Release (escapeWu/perplexity-ai, 171 stars), Git Workflow and Versioning (addyosmani/agent-skills, 105k stars), Verdaccio Pull Request Workflow (verdaccio/verdaccio, 18k stars) and Hunk Release Workflow (modem-dev/hunk, 9.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Git Changes Reporter?

No-Trade-No-Life (a GitHub organization) maintains it in No-Trade-No-Life/Yuan, which has 352 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on April 29, 2026.

Source: No-Trade-No-Life/Yuan on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.