Communitygithub.com

cdcoonce/Portfolio_Website

従来のコミットスタイルに従ったGitコミットワークフロー。Claudeが変更のステージングやコミット、コミットメッセージの作成を行う場合や、ユーザーがコミット、コミットの作成、作業の保存を依頼した場合に使用します。一貫したコミットメッセージ形式、適切なスコープ指定、プロジェクト全体でのアトミックコミットを保証します。

Portfolio_Website とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)がGitリポジトリ内で従来のコミットスタイルに従ったアトミックコミットを実行するためのワークフローを提供します。コミットメッセージの形式(`<type>(<scope>): <summary>`)を厳格に守り、タイプ(feat、fix、refactor、style、docs、test、chore、perf、ci)を適切に選択し、スコープでコンテキストを絞り込みます。また、変更のレビュー、CIチェックの実行、ファイルの個別ステージング、マルチラインコミットの作成、機密情報や生成成果物のコミット防止、`--no-verify`の回避など、堅牢な開発プラクティスを適用します。主なユースケースは、AIエージェントがユーザーの指示に基づいてコード変更を整理し、一貫性のあるコミット履歴を維持することです。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cdcoonce/Portfolio_Website/tree/HEAD/.claude/skills/commit

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

コミットスキル

従来のコミットスタイルとアトミックコミットの原則に従って、変更をステージングおよびコミットします。

コミットメッセージ形式

<type>(<optional scope>): <short summary>
  • すべて小文字 — タイプ、スコープ、要約
  • 要約の末尾にピリオドは付けない
  • 命令形 — 「add feature」と記述し「added feature」や「adds feature」とはしない
  • 要約行は最大50文字(ソフトリミット、ハードリミット72文字)
  • 要約は何をしたかではなくなぜしたかを説明する(差分が何を示すかはdiffが示す)

タイプ

タイプ使用タイミング例
feat新機能または機能feat: add user authentication flow
fixバグ修正fix: resolve null pointer on empty input
refactorバグ修正でも機能追加でもないコード変更refactor: extract parser into standalone module
style書式設定、空白、セミコロン — ロジック変更なしstyle: apply formatter to config files
docsドキュメントのみdocs: add API usage examples to readme
testテストの追加または更新test: add edge case coverage for validator
choreビルドプロセス、ツール、依存関係、設定chore: update dependency lockfile
perfパフォーマンスの改善perf: cache repeated database lookups
ciCI/CDパイプラインの変更ci: add lint step to PR workflow

スコープ(任意)

タイプだけでは曖昧な場合に、スコープを使用してコンテキストを絞り込みます。スコープはプロジェクトのディレクトリ構造やドメイン領域から導出します:

feat(auth): add OAuth2 token refresh
fix(api): handle timeout on large payloads
docs(contributing): add setup instructions

ワークフロー

  1. 変更を確認 — git status と git diff(ステージング済み+未ステージング)を実行して、何が変更されたかを把握する
  2. 最近の履歴を確認 — git log --oneline -10 を実行して、プロジェクトの既存のコミットスタイルに合わせる
  3. 意図を確認 — 変更が単一の論理単位を形成しているか確認し、そうでない場合は複数のコミットに分割することを提案する
  4. CIチェックを実行 — ステージング前に、プロジェクトのリンター、フォーマッター、テストスイートを実行して早期に問題を発見する。package.json のスクリプト、Makefile、またはCI設定から利用可能なコマンドを確認する。障害は修正してから次に進む。
  5. ファイルをステージング — ファイルを名前で指定して追加する(git add file1 file2)、git add -A や git add . は使用しない
  6. メッセージを作成 — 正しいタイプを選択し、必要に応じてスコープを追加し、命令形の要約を書く
  7. コミット — ヒアドキュメントを使用してメッセージをクリーンにフォーマットする
  8. 確認 — コミット後に git status を実行してコミットが成功したことを確認する

マルチラインコミット

本文が必要なコミット(稀です — 簡潔な1行メッセージを優先):

<type>(<scope>): <summary>

<body explaining why, not what>
  • 要約と本文の間に空行を入れる
  • 本文は72文字で折り返す
  • 要約だけでは理由を伝えきれない場合にのみ本文を使用する

ルール

  • アトミックコミット — コミットごとに1つの論理変更。機能とそのテストは1つのコミットにできる。無関係なフォーマット修正は別のコミットにする。
  • 機密情報なし — .env、認証情報、APIキー、トークンを決してコミットしない。これらがステージングされている場合はユーザーに警告する。
  • 生成成果物なし — ビルド出力、依存関係ディレクトリ、コンパイル済みファイルをコミットしない。ステージング前に .gitignore のカバレッジを確認する。
  • 新規コミットのみ — 常に新しいコミットを作成する。ユーザーが明示的に依頼しない限り、決して修正(amend)しない。
  • フックをスキップしない — 決して --no-verify を使用しない。フックが失敗した場合は、根本的な問題を修正する。
  • 共同著者行 — Claudeが変更を作成または共同作成した場合、共同著者フッターを追加する:
Co-Authored-By: Claude <[email protected]>

例

# 機能 — 新機能
feat: add webhook notification system

# スコープ付き機能
feat(api): add rate limiting middleware

# 修正 — バグ修正
fix: prevent crash on malformed JSON input

# スタイル — フォーマットのみ
style: apply consistent indentation across modules

# ドキュメント — ドキュメント
docs: add architecture decision records

# 雑務 — ツール/設定
chore: broaden gitignore to cover build artifacts

# スコープ付きテスト
test(auth): add integration tests for token refresh

# スコープ付きリファクタリング
refactor(db): replace raw queries with query builder

参考ドキュメント

  • conventional-commits.md — タイプ選択ガイド、破壊的変更、スコープ戦略、マルチファイルコミットの決定、本文のフォーマット、フッター、よくある間違い

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

cdcoonce/Portfolio_Website

AI-powered code quality analysis for Python, Markdown, and Mermaid diagrams. Use this skill when: (1) reviewing code for quality issues, (2) checking Python files for PEP8 violations, unused code, missing type hints, docstring problems, complexity issues, or potential runtime errors, (3) validating Markdown documentation for broken links, heading structure, or formatting issues, (4) validating Mermaid diagram syntax, (5) the user asks for a "code review" or "quality check", (6) analyzing code snippets pasted in conversation, or (7) suggesting and applying fixes for code quality issues.

cdcoonce/Portfolio_Website

Deploy the portfolio chat agent Lambda function to AWS. Use when the user asks to deploy, redeploy, push to Lambda, update the chat agent, or after updating context files or lambda_function.py. Rebuilds the knowledge base, packages dependencies, and deploys to AWS Lambda.

cdcoonce/Portfolio_Website

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

cdcoonce/Portfolio_Website

Orchestrate the full GitHub-issues-driven development lifecycle. 7-phase pipeline from brainstorm through PR with state tracking and cross-conversation resume. Use when user says "dev cycle", "development workflow", "full development pipeline", or invokes /dev-cycle.

cdcoonce/Portfolio_Website

Production Python coding standards with automatic version detection (3.10-3.13). Use when writing, reviewing, or refactoring Python to ensure adherence to modern type syntax, LBYL exception handling, pathlib operations, ABC-based interfaces, and production-tested patterns. Not Dagster-specific - applies to any Python project.

cdcoonce/Portfolio_Website

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

cdcoonce/Portfolio_Website

GitHub CLI (gh) integration for managing issues, pull requests, branches,

cdcoonce/Portfolio_Website

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

cdcoonce/Portfolio_Website

Explore a codebase to find opportunities for architectural improvement, focusing on making the codebase more testable by deepening shallow modules. Use when user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more AI-navigable.

cdcoonce/Portfolio_Website

CEO/founder-mode plan review. Rethink the problem, find the 10-star product, challenge premises, expand scope when it creates a better product. Three modes: SCOPE EXPANSION (dream big), HOLD SCOPE (maximum rigor), SCOPE REDUCTION (strip to essentials). Use when the user asks for a plan review, CEO review, mega review, or wants a plan challenged/stress-tested before implementation.

cdcoonce/Portfolio_Website

Break a PRD into independently-grabbable GitHub issues using tracer-bullet vertical slices. Use when user wants to convert a PRD to issues, create implementation tickets, or break down a PRD into work items.

cdcoonce/Portfolio_Website

Turn a PRD into a multi-phase implementation plan using tracer-bullet vertical slices, saved as a local Markdown file in docs/plans/. Use when user wants to break down a PRD, create an implementation plan, plan phases from a PRD, or mentions "tracer bullets".

cdcoonce/Portfolio_Website

Generate or update the `.claude/docs/project.md` file that gives Claude project-specific context. Use this skill when the user asks to create, update, regenerate, or refresh project context, or says things like "update project.md", "generate project context", "this repo needs a project.md", or "Claude doesn't know about this project". Also trigger when onboarding Claude to a new repository for the first time.

cdcoonce/Portfolio_Website

Generate comprehensive, high-quality README.md files for code repositories. Use this skill whenever the user asks to create, write, generate, update, or improve a README for any project or repository. Also trigger when the user says things like "document this project", "write docs for this repo", "this repo needs a README", "help me onboard developers to this codebase", or asks for project documentation in markdown. Even if the user just says "README" or "readme" in the context of a codebase, use this skill.

cdcoonce/Portfolio_Website

Create a detailed refactor plan with tiny commits via user interview, then file it as a GitHub issue. Use when user wants to plan a refactor, create a refactoring RFC, or break a refactor into safe incremental steps.

cdcoonce/Portfolio_Website

Set up pre-commit hooks for the current repo. Use when user wants to add pre-commit hooks, configure commit-time linting, formatting, type checking, or testing. Triggers on "pre-commit", "git hooks", "linting hooks", or /setup-pre-commit.

cdcoonce/Portfolio_Website

Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.

cdcoonce/Portfolio_Website

Triage a bug or issue by exploring the codebase to find root cause, then create a GitHub issue with a TDD-based fix plan. Use when user reports a bug, wants to file an issue, mentions "triage", or wants to investigate and plan a fix for a problem.

cdcoonce/Portfolio_Website

Rewrites the prose sections of wiki pages in-place. Reads source files to understand current context, then updates only the content inside <!-- claude:prose --> ... <!-- claude:prose:end --> markers. Never touches <!-- generated:start --> ... <!-- generated:end --> blocks. Supports targeting a single page with /update-wiki {PageName}.

cdcoonce/Portfolio_Website

Create a PRD through user interview, codebase exploration, and module design, then submit as a GitHub issue. Use when user wants to write a PRD, create a product requirements document, or plan a new feature.

関連スキル