mcpField
E
engineering-excellence

engineering-excellence

github.com/heyeddi-com開発086 回インストール1 日前に更新
リポジトリ

engineering-excellence について

コーディングエージェント向けの常時有効なスキルで、計画、実装、文書化、エンジニアリング監査を支援します。再利用とシンプルな設計を重視し、成果物を `.heyeddi/docs/` に集約します。

主な機能

  1. 01コーディング前の計画チェック
  2. 02エンジニアリング文書の初期化
  3. 03再利用カタログの確認
  4. 04変更後のエンジニアリング監査
  5. 05意思決定記録の作成

活用シーン

  1. 01コード変更の計画
  2. 02エンジニアリング文書の初期化
  3. 03アーキテクチャやリファクタリングのレビュー
  4. 04引き継ぎ前の変更監査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/heyeddi-com/heyeddi-skills --skill engineering-excellence

インストール後、Claude Code で/engineering-excellenceを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

manifest.json
context/
ANTI_PATTERNS.md
EXAMPLES.md
PROSE_ANTI_SLOP.md
VOCABULARY.md
reference/
engineering-always-on.md
subagents.md
scripts/
_heyeddi_paths.py
_skill_cli.py
append_decision.py
audit_engineering.py
check_engineering_plan.py
init_engineering_docs.py
README.md

詳細

エンジニアリングの卓越性

拡張性のあるシンプルなソリューション：次のエージェントが過剰に作り込んだり、作業を繰り返したりしないように文書化します。

コードの計画または変更を行うすべてのチャットで常時有効です。reference/engineering-always-on.md とハブの docs/always-on-skills.md を参照してください。

すべての成果物は .heyeddi/docs/ に置きます：リポジトリのルートには置かないでください。

使用するタイミング

  • 実装計画を提案する、またはコードを編集するすべてのチャット
  • 機能のリリース後：その仕組みを記録する
  • 抽象化を追加する前：再利用カタログを確認する
  • リファクタリング／アーキテクチャレビュー：KISS、YAGNI、SOLID
  • ユーザーから「過剰に設計しないで」「システムを文書化して」「エンジニアリングノート」と依頼されたとき

サブエージェント（デフォルト）

reference/subagents.md を参照してください。audit_engineering.py、check_engineering_plan.py、ドキュメントの初期化は Task shell に委任します。メインチャットで調査結果を解釈し、更新され続けるドキュメントを更新します。

パイプライン

check_engineering_plan  → plan gate (docs + optional plan smells)
init_engineering_docs   → .heyeddi/docs/engineering/{architecture,reuse-catalog,decisions}.md
implement / refactor
audit_engineering       → .heyeddi/docs/engineering-audit-<date>.md (--check = errors fail)
append_decision         → ADR when trade-off is non-obvious

手順

  1. 計画ゲート（各チャットでコーディング前に実行）： python scripts/check_engineering_plan.py --project-root <root> --check（文書化された計画がある場合は --plan-file を追加します）。
  2. プロジェクトで初めて実行するとき： python scripts/init_engineering_docs.py --project-root <root>
  3. コーディング中： 新しいコンポーネント／コンポーザブル／サービスを追加する前に、reuse-catalog.md を読みます
  4. 重要な変更の後： architecture.md のモジュールマップを更新し、再利用項目を追加します
  5. 自明でないトレードオフ： append_decision.py --title … --context … --decision …
  6. 変更ゲート（各チャットで編集後に実行）： audit_engineering.py --check（エラーは失敗として扱い、警告は参考情報です）。警告によるブロックをユーザーが求めた場合に限り、--strict を使用します。

原則（適用方法）

原則スキルの動作
KISS大きすぎるファイルに警告し、極端な場合はエラーにします。フラットなモジュールを優先します
YAGNI明確な再利用の根拠がない抽象化名を検出します。再利用の引用がない新しい Factory／Manager は計画ゲートでエラーにします
DRYreuse-catalog.md を維持し、UI では @no-duplicate-ui を連携します
SOLID肥大化したルーターに警告します。ビューは薄く、サービスは厚くします
テスト可能性スモークテストの仕様がないビューを指摘します

.heyeddi/ の出力

パス目的
.heyeddi/docs/engineering/architecture.mdシステムマップ、データフロー、境界
.heyeddi/docs/engineering/reuse-catalog.md既存のもの：再構築しないでください
.heyeddi/docs/engineering/decisions.mdエンジニアリング ADR（設計ログではありません）
.heyeddi/docs/engineering-audit-<date>.md特定時点の監査レポート

設計上の決定は .heyeddi/design.md の Decision log に記録します。混在させないでください。

連携

  • @heyeddi：タスクが曖昧な場合、このスキルの前に常時有効なルーターとして実行します
  • @project-engineering：最初にスキャフォールドします
  • @composable-patterns ／ @backend-type-bridger：アーキテクチャノートができてから実行します
  • @pre-merge-gate：最終 CI。audit_engineering --check を含みます

タスク完了時：次に使うスキルを提案する

このスキルに関するユーザーの依頼を完了したとき（ツール呼び出しやサブエージェントのフェーズごとではありません）、次に実行する内容を提案します：

  1. 実行します：

    python .agents/skills/heyeddi/scripts/suggest_next_skill.py --current-skill engineering-excellence --project-root .

    特定のルートを作業した場合は --route /path を追加します。

  2. ### Next step ブロックをスクリプトから取得し、最終返信に含めます。ユーザーは Prompt の行をコピーしてチャットに入力します（例：@visual-auditor review and fix /settings）。

変更ゲートの監査を終えた直後は --mode audit を渡します。

@heyeddi → reference/next-skill-handoff.md を参照してください。

コメント

Markdown 対応