Classical Chinese (Wenyan) Commit Message Generator for Openclaw

An AI coding agent skill that translates your code diffs into elegant, grammatically accurate Classical Chinese (Wenyan) git commit messages.

xing-lin
v1.0.1
May 20, 2026
2
1.3k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install wenyan-commit-message-skill

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install wenyan-commit-message-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Classical Chinese (Wenyan) Commit Message Generator?

The Wenyan Commit Message skill is a highly specialized developer tool designed to translate codebase changes into elegant, grammatically correct Classical Chinese (文言文). By analyzing raw diffs, this tool produces concise, historically accurate literary phrasing that replaces modern technical jargon with elegant single-character verbs and balanced syntax. It is a unique stylistic addition to the ecosystem of Openclaw Skills, allowing developers to bring classic aesthetics into their version control histories without sacrificing grammatical integrity.

This skill enforces strict formatting rules and classical linguistic principles, ensuring messages avoid modern vernacular habits or redundant punctuation. It preserves technical terms like variable names, files, and APIs as-is while translating structural actions into classical verbs like 增 (add), 删 (delete), and 改 (modify).

Classical Chinese (Wenyan) Commit Message Generator Use Cases

  • When a developer specifically requests a Classical Chinese commit message using keywords like "用文言文", "文言", "古文", or "classical chinese".
  • When the user specifies an elegant, literary style, such as "雅驯" (Yaxun) or "骈俪" (Pianli) for git commits.
  • When a project repository defines a classical style preference in its .gitmessage template.
  • When developers want to maintain an elegant, ancient Chinese thematic aesthetic in their git history.

How Classical Chinese (Wenyan) Commit Message Generator Works

  1. Read Diff: The skill reads the currently staged diff by running git diff --cached. If no files are staged, it falls back to analyzing unstaged modifications via git diff.
  2. Analyze Changes: The core logic summarizes the primary intent of the modifications into a single cohesive theme.
  3. Apply Classical Syntax: It translates the technical actions using prioritized classical verbs, removing redundant punctuation, applying proper verb-object inversion (e.g., "于 X 增 Y"), and formatting structural components.
  4. Generate Optional Body: For complex changes, it constructs a multi-layered body structure initiated by traditional markers like "凡" (every), "先" (first), or "后" (then).
  5. Stream Pure Text: The skill outputs raw, unadorned commit message text ready to be piped directly into git commit commands.

Classical Chinese (Wenyan) Commit Message Generator Setup

To enable this skill in your environment, clone or configure it within your local agent ecosystem:

# Standard setup command for Openclaw Skills
openclaw install wenyan-commit-message

Ensure that you have your repository configured so the AI agent has permissions to read staged git diffs:

git add .

To explicitly invoke the skill during a commit sequence, ask your agent:

# Example invocation
"用文言文写这篇 commit"

Classical Chinese (Wenyan) Commit Message Generator Data Schema & Taxonomy

This skill processes structured git metrics and outputs unformatted plain text. The table below details how data properties are parsed and structured:

Property Format / Rules Example Output
Subject (Title) Single line, <= 50 Chinese chars 修 login 跳转之谬
Body (Optional) Wrapped to <= 72 chars per line 凡鉴权之事,旧混于路由之中,今别为一层。
Proper Nouns Retained in English/Original README, API, 1.2.0
Command Pipe Plaintext, no markdown wrappers Ready for git commit -F -

Crucially, formatting rules completely discard standard commit prefixes (like feat: or fix:) to maintain authentic ancient grammar.

Classical Chinese (Wenyan) Commit Message Generator Advanced Features

  • Direct Pipe-to-Commit Integration: Outputs raw, unadorned plain text without markdown wrappers, enabling flawless shell pipelines like git commit -F -.
  • Complex Rhetoric Sequencing: Automatically handles multi-layered logic structures utilizing classical rhetoric hooks (e.g., "凡...先...后...其二...") to explain complex technical changes.
  • Technical Term Preservation: Maintains absolute precision by selectively protecting English APIs, variable names, files, and version indicators from awkward phonetic translations.
  • Sophisticated Vocabulary Mapping: Leverages a highly curated dictionary based on traditional ancient Chinese lexical usage, prioritizing single-character verbs over modern compound equivalents.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*