commit
Compose the semantic commit message from immutable evidence. Let `ai-commit` own deterministic preparation, commit, index reconciliation, and push mechanics.
PaulRBerg · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add PaulRBerg/agent-skills --skill commit技能说明
argument-hint: "[--all] [--staged] [--natural] [--push] [--close <issue_numbers>] [--finding <finding_ids>]" compatibility: Requires Git and ai-commit with automatic ai-coord stale-dirt baseline discovery on PATH. effort: medium name: commit description: "Commit staged or intended changes: compose a Conventional Prefix or Natural Language message, then use ai-commit — with --all, --staged, --close, --finding, or --push."
Git Commit
Compose the semantic commit message from immutable evidence. Let ai-commit own deterministic preparation, commit,
index reconciliation, and push mechanics.
Run every command from the target repository cwd. Do not surround ai-commit with extra git status, git log, or
git diff calls: preparation provides the complete evidence for this workflow. Use --porcelain only in deterministic
automation that explicitly parses its stable TSV records; the normal skill flow consumes the human-readable sections.
1. Parse Arguments
Arguments: $ARGUMENTS
ai-commitselects the message format from repository config; pass--naturalor--conventionalonly as an explicit one-off override, never to reproduce repository policy.--all: capture all worktree and index changes. This intentionally risks including another agent's work.--staged: capture exactly the current index; do not add session paths. It conflicts with--all.--natural: force Natural Language Format for this commit.--conventional: force Conventional Prefix Format for this commit.--push: request a push after commit. Otherwise push only when standing instructions authorize it.--close <issue_numbers>: append oneCloses #Ntrailer per positive decimal issue number; accept comma- or space-separated input.--finding <finding_ids>: append oneFinding-ID: <id>trailer per ledger finding this commit fixes; accept comma- or space-separated input. Also infer a finding from context when this session's commit fixes a specific ledger finding. Never include or resolve findings the commit does not actually fix.- In Conventional Prefix Format, a positional type keyword overrides the inferred type. In Natural Language Format, a positional verb or category keyword overrides the inferred verb. Quoted positional text overrides the inferred description or subject.
If the requested operation is only to push a clean branch that is already ahead, skip preparation and run
ai-commit push.
2. Prepare Once
Run one preparation command:
ai-commit prepare [--all | --staged] [--natural | --conventional] --diff full \
[--exclude-baseline '<path>=<oid>']... [-- <session-modified-paths>...]
- Default mode requires every path edited in this session. For a rename, include both old and new names, including case-only file or directory renames.
- Before default-mode preparation, run
ai-coord touchedwhen available and reconcile its output against the session path list: add missed session-edited paths, but ignore paths this session did not semantically change because touched paths are best-effort evidence, not authority. Skip this cross-check silently when the command is unavailable or the session is unrecognized. --allaccepts no explicit paths and captures all tracked, untracked, modified, deleted, and staged changes.--stagedaccepts neither explicit paths nor baseline exclusions and captures the shared index exactly.ai-commit prepareautomatically applies this session's ai-coord stale-dirt baselines. Auto-applied exclusions appear in the preparation evidence and must be disclosed unchanged. Explicit--exclude-baselineremains available for overrides, and--no-auto-baselinedisables discovery for deterministic automation. Never revert unrelated changes. If coordination re-entry records this session's completed edits as a baseline, compare its blob IDs with retained session or preparation evidence. Use--no-auto-baselineonly when every selected file's entire delta is attributable to the authorized task; preserve exclusions for mixed ownership or uncertain attribution.
Preparation pins the exact tree and delta under the printed transaction ID without changing the shared index. Keep that ID. The later commit reuses the transaction instead of recomputing intended content from the mutable worktree or shared index. It applies that immutable delta to the locked current branch and fails safely if intervening branch movement conflicts. If preparation fails before issuing a transaction ID, correct the evidenced argument, attribution, or input problem and retry preparation within the authorized scope.
3. Analyze and Compose
Analyze the single prepared full diff. Do not replace a valid preparation merely to get different evidence. Oversized
per-file sections arrive cut with a DIFF_TRUNCATED disclosure; their name-status and shortstat evidence still governs
the message.
- Use the printed message format and message-format rules.
ai-commitis the source of those rules; do not load a separate Conventional or Natural reference. - Apply positional overrides, detect breaking changes, infer scope or context from the code, and include a body only when it adds material rationale.
- Add
Closes #Ntrailers from--closeand from transcript issue references only when this commit actually resolves them. De-duplicate issue numbers. - Add one
Finding-ID: <id>trailer per finding supplied by--findingor inferred from context that this commit actually fixes. De-duplicate finding IDs. - Append the exact
Agent-Session:line from the preparation trailer section when present.ai-commithas already validated it; do not synthesize or repair a missing or malformed trailer.
Compose one subject paragraph, an optional body paragraph, and one final trailer paragraph containing all issue and Agent-Session lines.
ai-commit receives every -m value verbatim and rejects a literal \\n; write real line breaks