MCP HubMCP Hub
Retour aux compétences

commit-changes

pjt222
Mis à jour 5 days ago
29 vues
17
2
17
Voir sur GitHub
Métageneral

À propos

Cette fonctionnalité met en scène, valide et modifie les changements en utilisant des messages de commit conventionnels. Elle permet la mise en scène sélective, la rédaction de messages descriptifs via le format HEREDOC et la vérification de l'historique des commits. Utilisez-la pour sauvegarder une unité de travail logique dans le contrôle de version ou pour modifier un commit récent.

Installation rapide

Claude Code

Recommandé
Principal
npx skills add pjt222/agent-almanac -a claude-code
Commande PluginAlternatif
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternatif
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/commit-changes

Copiez et collez cette commande dans Claude Code pour installer cette compétence

Documentation

提交變更

擇文件入列,書簡明之辭以提交,驗其錄之可徵。

用時

  • 納一完整之勞於版控乃用
  • 以合範之辭立提交乃用
  • 修最近之提交(辭或其內)乃用
  • 提交之前察已入列者乃用

  • 必要:一或數已變之文件
  • 可選:提交之辭(若闕則代擬之)
  • 可選:是否修前提交
  • 可選:合著者之署

第一步:察當前之變

察工作樹之狀、閱其差異。

# See which files are modified, staged, or untracked
git status

# See unstaged changes
git diff

# See staged changes
git diff --staged

得:凡已改、已列、未錄之文件皆了然。

敗則:若 git status 敗,驗所處是否為 git 庫內(git rev-parse --is-inside-work-tree)。

第二步:擇文件入列

宜擇名而入之,勿濫用 git add .git add -A,以防誤納密物或無關之變。

# Stage specific files by name
git add src/feature.R tests/test-feature.R

# Stage all changes in a specific directory
git add src/

# Stage parts of a file interactively (not supported in non-interactive contexts)
# git add -p filename

提交之前,察已入列者。

git diff --staged

得:所入者唯所欲之文件與變,無 .env、無憑據、無巨檔。

敗則:若誤入者,以 git reset HEAD <file> 出之。若密物已列,立時出之,勿提交。

第三步:書提交之辭

依合範之式書之。辭必以 HEREDOC 傳,以全其格。

git commit -m "$(cat <<'EOF'
feat: add weighted mean calculation

Implements weighted_mean() with support for NA handling and
zero-weight filtering. Includes input validation for mismatched
vector lengths.

Co-Authored-By: Claude Opus 4.6 <[email protected]>
EOF
)"

合範之類:

用時
feat新功
fix修訛
docs獨書文檔
test增或更試
refactor變碼而不修不增
chore建構、CI、依賴之更
style修其形、空白(無邏輯之變)

得:提交已立,辭敘其故,不徒述其形

敗則:若提交前掛鈎敗,修其因,以 git add 再入列,立提交(勿用 --amend,蓋敗之提交未嘗立也)。

第四步:修前提交(可選)

唯前提交推至共有之遠端,方可修之。

# Amend message only
git commit --amend -m "$(cat <<'EOF'
fix: correct weighted mean edge case for empty vectors

EOF
)"

# Amend with additional staged changes
git add forgotten-file.R
git commit --amend --no-edit

得:前提交原地已更。git log -1 示其修後之容。

敗則:若提交已推,勿修之。代之以新提交。強推已修之提交於共有之枝,致史分歧。

第五步:驗其提交

# View the last commit
git log -1 --stat

# View recent commit history
git log --oneline -5

# Verify the commit content
git show HEAD

得:提交現於史中,辭正、著者正、文件之變亦正。

敗則:若提交所含之文件有誤,以 git reset --soft HEAD~1 撤之而留其變於列,再正而提之。

  • 所納之文件唯所欲者
  • 無密物(令牌、密碼、.env)入庫
  • 提交之辭合範
  • 辭之本文敘變之
  • git log 示提交附正確之屬
  • 提交前掛鈎(若有)皆過

  • 一提而納過繁:每一提交宜為一邏輯之變。無關之變宜分提之。
  • 盲用 git add .:必先察 git status。宜擇名而入之。
  • 修已推之提交:已推至共枝者,勿修之。此重寫其史,貽害於同工者。
  • 辭之空泛:「修訛」「更之」無所言也。宜述何變、何故。
  • 內容修而忘 --no-edit:補遺檔於前提交,宜用 --no-edit 以存舊辭。
  • 掛鈎敗而用 --amend:掛鈎敗則提交未立。用 --amend 反改提交。掛鈎修後,必立新提交。

  • manage-git-branches — 提交前之枝務
  • create-pull-request — 提交後之下步
  • resolve-git-conflicts — 合併或變基時解其衝突
  • configure-git-repository — 庫之設與其範

Dépôt GitHub

pjt222/agent-almanac
Chemin: i18n/wenyan/skills/commit-changes
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Compétences associées

content-collections

Méta

Cette compétence propose une configuration éprouvée en production pour Content Collections, un outil axé sur TypeScript qui transforme des fichiers Markdown/MDX en collections de données typées de manière sûre avec une validation Zod. Utilisez-la lors de la création de blogs, de sites de documentation ou d'applications Vite + React riches en contenu pour garantir la sécurité de typage et la validation automatique du contenu. Elle couvre tout, de la configuration du plugin Vite et de la compilation MDX à l'optimisation des déploiements et la validation des schémas.

Voir la compétence

polymarket

Méta

Cette compétence permet aux développeurs de créer des applications avec la plateforme de marchés prédictifs Polymarket, incluant l'intégration d'API pour le trading et les données de marché. Elle fournit également une diffusion de données en temps réel via WebSocket pour surveiller les transactions en direct et l'activité du marché. Utilisez-la pour mettre en œuvre des stratégies de trading ou pour créer des outils traitant les mises à jour de marché en direct.

Voir la compétence

creating-opencode-plugins

Méta

Cette compétence aide les développeurs à créer des plugins OpenCode qui s'interconnectent avec plus de 25 types d'événements tels que les commandes, les fichiers et les opérations LSP. Elle fournit la structure du plugin, les spécifications de l'API événementielle et les modèles d'implémentation pour les modules JavaScript/TypeScript. Utilisez-la lorsque vous avez besoin d'intercepter, de surveiller ou d'étendre le cycle de vie de l'assistant IA OpenCode avec une logique personnalisée pilotée par les événements.

Voir la compétence

sglang

Méta

SGLang est un framework de service LLM haute performance spécialisé dans la génération rapide et structurée pour les workflows JSON, regex et agentiques grâce à son cache de préfixe RadixAttention. Il offre une inférence nettement plus rapide, particulièrement pour les tâches avec des préfixes répétés, ce qui le rend idéal pour les sorties complexes et structurées ainsi que les conversations multi-tours. Choisissez SGLang plutôt que des alternatives comme vLLM lorsque vous avez besoin d'un décodage contraint ou que vous construisez des applications avec un partage étendu de préfixes.

Voir la compétence