AgentSkillsCN

constitution-checker

验证是否符合项目宪章要求。在功能实现完毕或创建PR时，对所有Article进行全面检查，确保无任何违规情况。

SKILL.md
--- frontmatter
name: constitution-checker
description: プロジェクト憲法への準拠を検証します。実装完了時やPR作成時に全Articleをチェックし、違反がないことを確認します。
allowed-tools: Read Glob Grep Bash

Constitution Checker スキル

このスキルは、.specify/memory/constitution.md で定義されたプロジェクト憲法への準拠を検証します。

起動条件

以下の状況で起動します：

  1. •実装完了時: 機能実装が完了し、コミット前にチェックが必要な場合
  2. •PR作成前: プルリクエストを作成する前の最終チェック
  3. •コードレビュー時: 他者のコードをレビューする際
  4. •明示的な依頼: ユーザーが憲法準拠チェックを依頼した場合

チェック項目

非交渉的原則（例外なし）

Article 1: Test-First Imperative

  • • テストファイルが実装ファイルより先に作成されているか
  • • テストファイルと実装ファイルが1:1で対応しているか
  • • テストが失敗状態（Red）から開始されているか
bash
# テストファイルの存在確認
uv run pytest --collect-only

Article 5: Code Quality Standards

  • • ruff check がエラーなしで通過するか
  • • ruff format で差分が発生しないか
  • • mypy がエラーなしで通過するか
bash
# 品質チェックの実行
uv run ruff check .
uv run ruff format --check .
uv run mypy .

Article 6: Data Accuracy Mandate

  • • マジックナンバーが直接埋め込まれていないか
  • • ハードコードされた文字列がないか
  • • 暗黙的なフォールバック（= "default" 等）がないか
bash
# ハードコード検出（ヒューリスティック）
grep -rn "= 30\|= 60\|= 100" --include="*.py" src/
grep -rn '= "default"\|= "none"' --include="*.py" src/

Article 7: DRY Principle

  • • 同一ロジックが複数箇所に存在しないか
  • • 類似コードが3回以上繰り返されていないか

Article 9: Python Type Safety Mandate

  • • すべての関数に型アノテーションがあるか
  • • 戻り値に型アノテーションがあるか
  • • Any 型の使用が最小限か
bash
# 型アノテーションなし関数の検出
grep -rn "def .*(" --include="*.py" src/ | grep -v ":"

Article 11: SpecKit Naming Convention

  • • ディレクトリ名が <3桁番号>-<name> 形式か
  • • ブランチ名が同一の命名規則に従っているか

推奨チェック項目

Article 2: Documentation Integrity

  • • 実装が仕様と一致しているか
  • • ドキュメントが最新の状態か

Article 3: MCP Protocol Compliance

  • • MCPツールにスキーマ定義があるか
  • • 入力がPydanticモデルで検証されているか
  • • エラーレスポンスが適切な形式か

Article 10: Python Docstring Standards

  • • 公開関数にdocstringがあるか
  • • Google-style形式を使用しているか

実行プロセス

1. 自動チェック実行

bash
# 全品質チェック
uv run ruff check --fix . && uv run ruff format . && uv run mypy .

# テスト実行
uv run pytest

2. 手動チェック項目の確認

自動化できない項目を目視確認：

  • •コードの重複
  • •仕様との整合性
  • •適切な抽象化

3. レポート生成

チェック結果を以下の形式で報告：

code
## Constitution Compliance Report

### 非交渉的原則
- [✓] Article 1: Test-First Imperative
- [✓] Article 5: Code Quality Standards
- [✓] Article 6: Data Accuracy Mandate
- [✓] Article 7: DRY Principle
- [✓] Article 9: Python Type Safety Mandate
- [✓] Article 11: SpecKit Naming Convention

### 推奨項目
- [✓] Article 2: Documentation Integrity
- [✓] Article 3: MCP Protocol Compliance
- [✓] Article 10: Python Docstring Standards

### 総合判定: PASS / FAIL

違反検出時の対応

  1. •作業を停止: 違反が解消されるまで次工程に進まない
  2. •違反内容を報告: 具体的な違反箇所と修正方法を提示
  3. •修正を支援: 必要に応じて修正コードを提案
  4. •再チェック: 修正後に再度チェックを実行

注意事項

  • •非交渉的原則（Article 1, 5, 6, 7, 9, 11）は例外なく遵守が必要
  • •時間制約、緊急性を理由とした例外は認められない
  • •すべてのチェック項目がPASSするまでコミット・PRは行わない