four-elements skill
✓ 検証済みリファクタリング、デバッグ、アーキテクチャ設計における意思決定をガイドするため、4つの要素に分類された24のエンジニアリング原則を提供します。
- GitHubスター
- 113
- ファイル
- 25
- 最終コミット
- 2026年11月1日
- ライセンス
- MIT
- 許可されたツール
- —
four-elements skillは何をしますか
リファクタリング、デバッグ、アーキテクチャ設計における意思決定をガイドするため、4つの要素に分類された24のエンジニアリング原則を提供します。
skillのSKILL.mdから生成された要約。
four-elements skill について
このSKILLは、構造化された原則を通じて、開発者やAIエージェントのエンジニアリングにおける意思決定を支援します。Air、Water、Earth、Fireの4つの要素カテゴリに整理された、24の明確な原則を提供します。エージェントがコードのリファクタリング、複雑なシステムのデバッグ、新しいアーキテクチャの設計、または技術的負債の管理を行う際に、このSKILLをロードする必要があります。
特定の原則を検索することで、エージェントは複雑さを減らすべきか、新しい要件に適応すべきか、規律によって安定性を維持すべきか、あるいは実行を通じて進展を促すべきかを判断できます。このSKILLは、各原則の詳細を定義する一連のMarkdownリファレンスに基づいています。エージェントがタスクに原則を適用すると、使用した特定の原則を明示し、その原則が技術的な選択にどのように影響したかを説明する、論理的な意思決定を出力します。このアプローチにより、不要な抽象化の追加、デバッグ時の根本原因の特定失敗、あるいは長いセッション中のコンテキストウィンドウの肥大化といった、よくある落とし穴を防ぐことができます。
エージェントができること
- 1リファクタリングと複雑さの軽減エージェントはAirの原則を使用して、新しい抽象化を追加すべきか、あるいは単にデッドコードを削除すべきかを判断できます。
- 2デバッグと根本原因分析複数の修正が失敗する場合、エージェントは根本的な前提に立ち向かう原則を適用できます。
- 3堅牢なデータ構造の設計開発者はEarthの原則を使用して、型システム内で不正な状態が発生しないように設計できます。
skill の SKILL.md から作成されています。すべてのユースケースは、その引用と照合されています。
four-elements skillのインストール方法
各コマンドはskillフォルダをクライアントのskillsディレクトリにコピーします。読み込むには、クライアントを再起動するか新しいセッションを開始してください。プラグインにfour-elements skillをインストールする
/plugin marketplace add tmcfarlane/team-avatar /plugin install team-avatar@team-avatar
Claude Codeにfour-elements skillをインストールする
~/.claude/skills/four-elements/SKILL.md
$ npx degit tmcfarlane/team-avatar/plugins/team-avatar/skills/four-elements ~/.claude/skills/four-elementsClaude Code (project)にfour-elements skillをインストールする
.claude/skills/four-elements/SKILL.md
$ npx degit tmcfarlane/team-avatar/plugins/team-avatar/skills/four-elements .claude/skills/four-elementsCodexにfour-elements skillをインストールする
~/.agents/skills/four-elements/SKILL.md
$ npx degit tmcfarlane/team-avatar/plugins/team-avatar/skills/four-elements ~/.agents/skills/four-elementsGemini CLIにfour-elements skillをインストールする
~/.gemini/skills/four-elements/SKILL.md
$ npx degit tmcfarlane/team-avatar/plugins/team-avatar/skills/four-elements ~/.gemini/skills/four-elementsClaude.aiにfour-elements skillをインストールする
npx degit tmcfarlane/team-avatar/plugins/team-avatar/skills/four-elements four-elements && zip -r four-elements.zip four-elements # claude.ai → Customize → Skills → + → Create skill → Upload a skill → four-elements.zip
自動チェック
実行日 2026年11月14日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。エージェントに実行させる前にスクリプトを読んでください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能tmcfarlane/team-avatar/plugins/team-avatar/skills/four-elements is public and reachablegithub.com/tmcfarlane/team-avatar/tree/HEAD/plugins/team-ava ↗合格
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit 2026-11-01github.com/tmcfarlane/team-avatar/commits ↗合格
- スクリプトにダウンロード実行や認証情報の窃取がないNo scripts in the skill folder合格
- SKILL.md に隠れた指示がないNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/tmcfarlane/team-avatar/blob/HEAD/plugins/team-ava ↗合格
- 事前許可ツールが限定されているNo pre-approved tools; the agent asks before using onegithub.com/tmcfarlane/team-avatar/blob/HEAD/plugins/team-ava ↗合格
- SKILL.md が Agent Skills の形式に従っているValid name and description; says when to use it; 55 linesgithub.com/tmcfarlane/team-avatar/blob/HEAD/plugins/team-ava ↗合格
SKILL.md
GitHubで表示The four elements
Each element is a stance. Read the element the moment calls for. Each bullet names when its principle applies and links the principle in full.
Read the linked reference in full before you apply a principle. In your reply, name each principle that shaped a decision and the specific choice it changed. Cite only principles whose reference you read this session.
Air: subtract
The Air Nomads carry nothing they do not need. Lightness is the discipline.
- Laziness Protocol. Refactoring, sizing a diff, or tempted to add abstractions, layers, or signal threading. Make the smallest change that solves it, and give a repeated decision one source of truth.
- Subtract Before You Add. Sequencing an addition, refactor, or rewrite. Delete dead code, stale flags, and speculative guards first. Design for observed usage. Then build on the simpler base.
- Minimize Reader Load. Reviewing or shaping code that is hard to trace. Count layers and hidden state, inline one-caller wrappers, and shrink mutable scope.
- Attack the Premise. Two or more fixes that share one premise have failed the same gate. Write the premise down and test it directly before another fix. Aang found a third option when everyone said there were two.
- Experience First. Product, UX, or feature-scope tradeoffs. Choose user delight over implementation convenience. Ship fewer, polished features.
- Exhaust the Design Space. A novel interaction or architectural decision with no precedent. Build two or three competing prototypes with
scouting-flightand compare before committing.
Water: adapt
Water takes the shape of what holds it and still finds the lowest point.
- Foundational Thinking. Before writing logic. Get the core types and data structures right, do scaffold before features, and ask what concurrent actors share.
- Model the Domain. Stateful logic, or code that branches a lot or repeats a shape assumption across files. Encode the domain in a state machine, typed model, table, reducer, or the right collection instead of scattered conditionals.
- Redesign from First Principles. A new requirement arrives for an existing design. Design as if it had been there from day one. Do not bolt it onto the side.
- Fix Root Causes. Debugging. Trace each symptom back to the first place the system went wrong and fix it there. A guard is a fix only when the state it handles is legitimate.
- Make Operations Idempotent. Commands, lifecycle steps, or loops that run amid crashes and retries. Converge to the same end state when run twice or resumed after a crash.
- Migrate Callers Then Delete Legacy APIs. A new internal API while old callers exist. Move every caller and delete the old path in the same wave.
Earth: hold
Earthbenders wait and listen, then strike once. Stability comes from what you have verified.
- Boundary Discipline. Wiring validation, error handling, or framework adapters. Validate and parse at the edges (CLI, config, network, external APIs). Inside, trust the types and keep business logic pure.
- Type System Discipline. Designing types or a signature in a typed language. Make illegal states unrepresentable, brand primitives that mean different things, and derive types from the schema that owns the shape.
- Separate Before Serializing Shared State. Concurrent actors might write the same file, branch, key, or object. Give each its own write target first. Lock only when one shared writer is a real invariant.
- Prove It Works. After a task, before declaring done. Check the real artifact directly. A proxy, a cached screenshot, and an agent's report are not proof.
- Test Behavior, Not Implementation. Writing, changing, or keeping a test. Assert what a caller can observe, so the test fails when behavior breaks and passes when only internals change.
- Explain the Number. Before you trust, report, or act on a measured speedup, regression, latency, or eval score. Find what limits it and rule out that it measured something else.
Fire: drive
Iroh taught that fire is life, not destruction. Its source is breath, not rage.
- Outcome-Oriented Execution. Planned rewrites and migrations with explicit phase boundaries. Converge on the target architecture. Do not preserve throwaway compatibility states.
- Never Block on the Human. Tempted to ask "should I do X?" on reversible work. Do it, show the result, and let them correct course. Save questions for product and preference calls.
- Build the Lever. Any non-trivial work. Write the script, codemod, generator, or shared brief that does or proves it. The tool is the artifact a reviewer can rerun.
- Sequence Work into Verifiable Units. Multi-step work and how you stack commits and PRs. Each step ends in a check, verified before the next. Land a failing test before its fix.
- Encode Lessons in Structure. You catch yourself writing the same instruction a second time. Turn it into a lint, a flag, a runtime check, or a script instead of more text.
- Guard the Context Window. Context fills with large outputs, long files, repeated reads, or fan-out planning. Route bulk reading to a dispatched character. Keep summaries, not dumps, in the main thread.
このスキルのファイル
25four-elements skillに関する質問
Claude Codeにfour-elements skillをインストールするには
npx degit tmcfarlane/team-avatar/plugins/team-avatar/skills/four-elements ~/.claude/skills/four-elementsを実行してください。Claude Codeは~/.claude/skills(すべてのプロジェクト)または.claude/skills(単一プロジェクト)からskillsを読み込み、説明がタスクに一致する場合にskillを使用します。
four-elements skillはどのクライアントで使用できますか
Agent Skills形式を読み込むすべてのクライアントで使用できます: Claude Code、Codex、Gemini CLI、claude.ai(ZIPとしてアップロード)。skill内のスクリプトは、クライアントがコード実行を許可した場合にのみ実行されます。