Навык four-elements
✓ ПровереноПредоставляет 24 инженерных принципа, разделенных на четыре категории, для принятия решений при рефакторинге, отладке и проектировании архитектуры.
- Звёзды на GitHub
- 113
- Файлы
- 25
- Последний коммит
- 1 нояб. 2026 г.
- Лицензия
- MIT
- Разрешённые инструменты
- —
Что делает навык four-elements?
Предоставляет 24 инженерных принципа, разделенных на четыре категории, для принятия решений при рефакторинге, отладке и проектировании архитектуры.
Сводка сгенерирована из SKILL.md навыка.
О skill four-elements
Этот SKILL позволяет разработчикам и ИИ-агентам принимать инженерные решения на основе структурированных принципов. Он включает двадцать четыре отдельных принципа, организованных в четыре стихийные категории: Воздух, Вода, Земля и Огонь. Агенту следует загрузить этот навык, когда ему необходимо провести рефакторинг кода, отладить сложные системы, спроектировать новую архитектуру или управлять техническим долгом.
Используя поиск по конкретным принципам, агент может определить, нужно ли снизить сложность, адаптироваться к новым требованиям, поддерживать стабильность за счет дисциплины или обеспечивать прогресс через исполнение. Работа навыка опирается на набор markdown-файлов, в которых подробно описан каждый принцип. Когда агент применяет принцип к задаче, он формирует обоснованное решение, в котором указывает использованный принцип и объясняет, как он повлиял на технический выбор. Такой подход помогает избежать распространенных ошибок, таких как создание избыточных абстракций, неспособность найти первопричину при отладке или раздувание контекстного окна во время длительных сессий.
Что агент может делать с ним
- 1Рефакторинг и снижение сложностиАгент может использовать принципы Воздуха, чтобы решить, стоит ли добавлять новую абстракцию или достаточно просто удалить мертвый код.
- 2Отладка и анализ первопричинЕсли несколько попыток исправления не приносят результата, агент может применить принцип атаки на исходную предпосылку.
- 3Проектирование надежных структур данныхРазработчики могут использовать принципы Земли, чтобы гарантировать невозможность возникновения недопустимых состояний внутри их систем типов.
Написано на основе skill SKILL.md. Каждый сценарий использования проверен по цитате из него.
Как установить навык four-elements
Каждая команда копирует папку навыка в каталог навыков клиента. Перезапустите клиент или начните новую сессию, чтобы загрузить его.Установка навыка four-elements в Плагин
/plugin marketplace add tmcfarlane/team-avatar /plugin install team-avatar@team-avatar
Установка навыка four-elements в Claude Code
~/.claude/skills/four-elements/SKILL.md
$ npx degit tmcfarlane/team-avatar/plugins/team-avatar/skills/four-elements ~/.claude/skills/four-elementsУстановка навыка four-elements в Claude Code (project)
.claude/skills/four-elements/SKILL.md
$ npx degit tmcfarlane/team-avatar/plugins/team-avatar/skills/four-elements .claude/skills/four-elementsУстановка навыка four-elements в Codex
~/.agents/skills/four-elements/SKILL.md
$ npx degit tmcfarlane/team-avatar/plugins/team-avatar/skills/four-elements ~/.agents/skills/four-elementsУстановка навыка four-elements в Gemini CLI
~/.gemini/skills/four-elements/SKILL.md
$ npx degit tmcfarlane/team-avatar/plugins/team-avatar/skills/four-elements ~/.gemini/skills/four-elementsУстановка навыка four-elements в Claude.ai
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
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Прошёл наши автоматические проверки. Это не аудит безопасности: прочитайте скрипты, прежде чем агент их запустит. Как работают проверки
- Связанный и доступный исходный репозиторийtmcfarlane/team-avatar/plugins/team-avatar/skills/four-elements is public and reachablegithub.com/tmcfarlane/team-avatar/tree/HEAD/plugins/team-ava ↗Пройдено
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний год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 SkillsValid name and description; says when to use it; 55 linesgithub.com/tmcfarlane/team-avatar/blob/HEAD/plugins/team-ava ↗Пройдено
SKILL.md
Открыть на GitHubThe 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.
Файлы в этом навыке
25Вопросы о навыке four-elements
Как установить навык four-elements в Claude Code?
Выполните npx degit tmcfarlane/team-avatar/plugins/team-avatar/skills/four-elements ~/.claude/skills/four-elements. Claude Code загружает навыки из ~/.claude/skills (все проекты) или .claude/skills (один проект) и использует навык, когда его описание соответствует задаче.
Какие клиенты могут использовать навык four-elements?
Любой клиент, который читает формат Agent Skills: Claude Code, Codex, Gemini CLI и claude.ai (загрузить как ZIP). Скрипты в навыке выполняются только там, где клиент разрешает выполнение кода.