菜单
Manages git operations: worktree creation, branch management, commits, PRs, and semantic versioning (shim over release_lib.semver). Use when: Creating branches/worktrees, committing, pushing, versioning Triggers: create worktree, commit, push, rebase, version, PR
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Run academic literature searches on Google Scholar Labs through the user's own authenticated Chrome, then extract the papers and citations found. Use this whenever the user wants to search Google Scholar, find peer-reviewed sources or citations for a claim, answer a research question with the literature, or gather academic evidence, even if they don't name "Scholar Labs" explicitly. Especially important because Scholar Labs has a strict ~3-queries-per-day quota: this skill prevents wasting queries on malformed searches and on re-reads that cost nothing. Do NOT use for general web search, fetching one known URL, or reading a PDF the user already has.
Autonomously drive a Python repo's release end to end through the contrib -> develop -> release -> main branch topology, with review/CI gates and an explicit human confirm before promoting to production. Use when the user says "cut a release", "ship this", "run the release pilot", "release vN.N.N", or asks to drive a PR through to main. Derives all phase/progress from git state -- no TODO files, no state database.
Shared utilities for file deprecation, directory structure creation, archive management, skill scaffolding, pre-commit hooks, version validation, and VCS abstraction (GitHub/Azure DevOps via release_lib.vcs). Used by all other skills. Use when: Need shared utilities, deprecating files, archiving files, creating skill scaffolds, running VCS operations. Triggers: deprecate, archive, create directory, create skill, VCS operations
Meta-skill (Phase 0) for bootstrapping new repositories with workflow system. Interactive callable tool that copies skills, documentation, and standards from source repository. Use when: Starting a new project that needs the workflow system Triggers: "initialize new repository", "bootstrap workflow", "replicate workflow system"
Detects Python project configuration and provides commands for testing, building, coverage, and containerization. Use when: Starting workflow, detecting project stack, need TEST_CMD Triggers: detect stack, what commands, initial setup Outputs: TEST_CMD, BUILD_CMD, COVERAGE_CMD, COVERAGE_CHECK, MIGRATE_CMD
Audit and enforce the CLAUDE.md discipline rubric introduced in stharrold-templates v8.9. Finds low-value stub files, oversized CLAUDE.md files, and dated section headers; reports actionable cleanup suggestions; optionally fails CI when thresholds are exceeded. Use when: starting work on CLAUDE.md files, before tagging a release, or as a periodic docs-hygiene check in CI. Triggers: audit CLAUDE.md, lint CLAUDE.md, find CLAUDE.md stubs, check CLAUDE.md discipline Outputs: a report listing files by category (stubs, oversized, dated, clean) and their line counts. Exits non-zero when thresholds are exceeded.
| name | git-workflow-manager |
| version | 5.1.0 |
| description | Manages git operations: worktree creation, branch management, commits, PRs, and semantic versioning (shim over release_lib.semver). Use when: Creating branches/worktrees, committing, pushing, versioning Triggers: create worktree, commit, push, rebase, version, PR |
# Create feature worktree
uv run python .claude/skills/git-workflow-manager/scripts/create_worktree.py \
feature <slug> contrib/<user>
# Semantic version (shim -> release_lib.semver)
uv run python .claude/skills/git-workflow-manager/scripts/semantic_version.py develop <current-version>
Handles all git operations following git-flow + GitHub-flow hybrid model.
main ← Production (tagged vX.Y.Z)
↑
release/vX.Y.Z ← Release candidate
↑
develop ← Integration branch
↑
contrib/<gh-user> ← Personal contribution branch
↑
feature/<timestamp>_<slug> ← Isolated feature (worktree)
hotfix/vX.Y.Z-hotfix.N ← Production hotfix (worktree)
CRITICAL: This skill manages git operations and MUST enforce branch protection rules.
Protected branches (NEVER delete, NEVER commit directly):
main - Production branch (tagged releases only)develop - Integration branch (PR merges only)All scripts in this skill comply with:
main (except tag operations)developScript validation:
scripts/ directory are validated for compliancetests/test_branch_protection.py verifies no unintended main/develop commitsCreates feature/release/hotfix worktree.
python .claude/skills/git-workflow-manager/scripts/create_worktree.py \
<feature|release|hotfix> <slug> <base_branch>
Arguments:
workflow_type: feature, release, or hotfixslug: Short descriptive name (e.g., 'json-validator')base_branch: Branch to create from (e.g., 'contrib/username')Archives TODO file, removes worktree, prints branch-deletion commands.
python .claude/skills/git-workflow-manager/scripts/cleanup_feature.py <slug>
Backward-compat shim that re-exports from release_lib.semver (issue #240).
python .claude/skills/git-workflow-manager/scripts/semantic_version.py \
<base_branch> <current_version>
Version bump logic:
Removed in #242 (superseded by release-pilot skill + release_lib):
create_release.py, tag_release.py, backmerge_workflow.py,
cleanup_release.py, daily_rebase.py, generate_work_items_from_pr.py,
release_workflow.py, pr_workflow.py.
<type>(<scope>): <subject>
<body>
<footer>
Types: feat, fix, docs, style, refactor, test, chore
Example:
feat(validator): add JSON schema validation endpoint
Implements REST API endpoint for validating JSON against schemas.
Uses jsonschema library for validation logic.
Implements: impl_003
Spec: specs/json-validator/spec.md
Tests: tests/test_validator.py
Coverage: 85%
Refs: TODO_feature_20251022T143022Z_json-validator.md
# Feature → contrib/<gh-user>
gh pr create \
--base "contrib/<gh-user>" \
--head "<feature-branch>" \
--title "feat: <description>" \
--body "See TODO_feature_*.md for details"
# After user merges in GitHub UI:
# Contrib → develop
gh pr create \
--base "develop" \
--head "contrib/<gh-user>" \
--title "feat: <description>" \
--body "Completed feature: <name>"
Other skills call these scripts:
import subprocess
# Create worktree
result = subprocess.run([
'python',
'.claude/skills/git-workflow-manager/scripts/create_worktree.py',
'feature', 'my-feature', 'contrib/user'
], capture_output=True, text=True)
# Calculate version
result = subprocess.run([
'python',
'.claude/skills/git-workflow-manager/scripts/semantic_version.py',
'develop', 'v1.0.0'
], capture_output=True, text=True)
new_version = result.stdout.strip()