engineering-handbook
AIを活用した多言語(Java/Python/TS/React/Vue)のコーディングにおいて、本リポジトリのエンジニアリングハンドブックTier0ルールを注入するSkill。
📜 元の英語説明(参考)
把本仓库的工程手册 Tier0 规则注入到 AI vibe coding(跨语言:Java/Python/TS/React/Vue)。
🇯🇵 日本人クリエイター向け解説
AIを活用した多言語(Java/Python/TS/React/Vue)のコーディングにおいて、本リポジトリのエンジニアリングハンドブックTier0ルールを注入するSkill。
※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。
下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o engineering-handbook.zip https://jpskill.com/download/6583.zip && unzip -o engineering-handbook.zip && rm engineering-handbook.zip
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/6583.zip -OutFile "$d\engineering-handbook.zip"; Expand-Archive "$d\engineering-handbook.zip" -DestinationPath $d -Force; ri "$d\engineering-handbook.zip"
完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。
💾 手動でダウンロードしたい(コマンドが難しい人向け)
- 1. 下の青いボタンを押して
engineering-handbook.zipをダウンロード - 2. ZIPファイルをダブルクリックで解凍 →
engineering-handbookフォルダができる - 3. そのフォルダを
C:\Users\あなたの名前\.claude\skills\(Win)または~/.claude/skills/(Mac)へ移動 - 4. Claude Code を再起動
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 このSkillでできること
下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。
📦 インストール方法 (3ステップ)
- 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
- 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
- 3. 展開してできたフォルダを、ホームフォルダの
.claude/skills/に置く- · macOS / Linux:
~/.claude/skills/ - · Windows:
%USERPROFILE%\.claude\skills\
- · macOS / Linux:
Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。
詳しい使い方ガイドを見る →- 最終更新
- 2026-05-17
- 取得日時
- 2026-05-17
- 同梱ファイル
- 1
📖 Skill本文(日本語訳)
※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。
エンジニアリングハンドブック(AI Vibe Coding 用 Tier0)
使用場面
- デフォルト:あらゆるコーディング、リファクタリング、レビュータスク。
- 特に適用:AI に「受け入れ可能で、ロールバック可能で、契約が明確で、境界が明確な」最小限の可逆的変更を生成させたい場合。
Tier0 ルール(常に適用)
- IN-001:外部から見えるあらゆる変更には、verify + rollback(expected vs actual)を提示する必要があります。
- AR-001:コアロジックは不安定な詳細(DB/ネットワーク/フレームワークタイプ/時間/ランダム/env)に依存してはなりません。port + adapter を介して注入します。
- CT-001:境界をまたぐビジネス構造では、裸の dict/map/object を契約として使用してはなりません。明示的な DTO/type を使用する必要があります。
- AR-002 + BD-001:モジュール間の依存関係は、公開された出口(facade/public API)のみを介して行い、内部ディレクトリ/パッケージへの深層 import は禁止します。
- MD-001:境界アセットは自己記述的である必要があります。フィールドレベルのデータには data_classification が必要です。ログ/エラー/エクスポート/埋め込みは最小限に公開します。
必須出力形式
-
まず出力:my understanding + acceptance。
-
変更を実行する場合:まず goal / scope(files/modules/paths) / budget / verify / rollback を出力します(scope にリストされていないものは変更できません)。
-
不明な点は TODO/ASSUMPTION/IMPACT でマークし、変更の拡散を避けます(smallest diff first)。
オンデマンド参照(トリガーされた場合のみ読み取り)
- ルール SSOT:universal/rules.md
- 方法論と十問:universal/method.md
- 境界契約実践:practices/boundary-contracts.md
- リファクタリングレシピ(smallest diff):playbooks/refactoring-playbook.md
- 言語マッピング(スタックに応じて選択して読み取り):mappings/python.md, mappings/typescript.md, mappings/jvm.md, mappings/go.md, mappings/dotnet.md, mappings/sql.md
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
Engineering Handbook (Tier0 for AI Vibe Coding)
When to Use
- 默认:任何编码/重构/评审任务。
- 特别适用:你希望 AI 产出“可验收、可回滚、契约清晰、边界清晰”的最小可逆变更。
Tier0 Rules (Always Apply)
- IN-001:任何对外可见变化必须给出 verify + rollback(expected vs actual)。
- AR-001:核心逻辑不得依赖不稳定细节(DB/网络/框架类型/时间/随机/env);通过 port + adapter 注入。
- CT-001:跨边界业务结构不得使用裸 dict/map/object 作为合同;必须使用显式 DTO/type。
- AR-002 + BD-001:跨模块依赖只能通过公开出口(facade/public API),禁止深层 import 内部目录/包。
- MD-001:边界资产必须自描述;字段级数据需要 data_classification;日志/错误/导出/埋点最小化暴露。
Required Output Format
-
先输出:my understanding + acceptance。
-
若要执行改动:先输出 goal / scope(files/modules/paths) / budget / verify / rollback(scope 未列出不得改)。
-
不确定处用 TODO/ASSUMPTION/IMPACT 标记,避免扩散改动(smallest diff first)。
On-demand References (Read Only When Triggered)
- 规则 SSOT:universal/rules.md
- 方法论与十问:universal/method.md
- 边界契约实践:practices/boundary-contracts.md
- 重构配方(smallest diff):playbooks/refactoring-playbook.md
- 语言映射(按栈选读):mappings/python.md, mappings/typescript.md, mappings/jvm.md, mappings/go.md, mappings/dotnet.md, mappings/sql.md