К основному содержанию
скилл CX Codex

keeping-one-source-of-truth — скилл для Claude Code: одно место

Скилл для агентов, который держит каждый факт в одном месте и мешает копиям расходиться. Пригодится, когда значение так и просится во второй файл.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add riekelt/principal-engineer --skill keeping-one-source-of-truth -a claude-code
Открыть на GitHub

Что делает keeping-one-source-of-truth

Скилл задаёт правило: у каждого факта о системе ровно один владелец, остальной код читает значение оттуда. По описанию автора он срабатывает в момент, когда скопировать значение кажется быстрее, чем сослаться на источник, — а также когда две копии уже разошлись.

Внутри семь пунктов доктрины. Сначала найти, кто уже владеет данными, и расширить этого владельца, а не заводить второго. Затем выводить значение на чтении, если платформа или существующий источник умеет его отдать, и попутно схлопывать найденные дубли. Отсутствующая запись обязана падать с ошибкой, а не подставлять тихое значение по умолчанию. Сгенерированное помечается отдельно, и правки в него не вносятся. Идентификаторы и состояния, по которым ветвится код, становятся константами или перечислениями, а не строками. При расхождении двух источников скилл велит сначала вслух сказать о противоречии, потом определить живое значение, свести всё к одному источнику и удалить проигравшего. Не молчать и не следовать тому, что прочитал первым: так ошибка тихо закрепляется.

Скилл требует предварительного знакомства с principal-engineering. Кеши и read-модели он допускает, если копия обновляется автоматически, а её устаревание ограничено и заметно; фикстуры могут намеренно замораживать копию реальности. Границы с TypeError: без базового principal-engineering часть ссылок в тексте повиснет.

Какие задачи решает

  • найти существующего владельца данных перед добавлением нового поля
  • прочитать значение из платформы вместо второй копии в коде
  • схлопнуть дубль при правке старого кода
  • заменить строковые идентификаторы на константы и перечисления
  • разобрать расхождение двух источников и оставить один

Примеры запросов агенту

  • Собираюсь добавить лимит в конфиг — проверь, кто уже владеет этим значением, и не заводи вторую копию
  • В settings.py и service.yaml разные пороги таймаута: разберись, какое значение живое, оставь один источник
  • Замени строки статусов в двух сервисах на общий перечислимый тип

Как установить keeping-one-source-of-truth

1Через Skills CLI (Vercel)

npx skills add riekelt/principal-engineer --skill keeping-one-source-of-truth -a claude-code

2Вручную: положить файлы

~/.claude/skills/keeping-one-source-of-truth/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/keeping-one-source-of-truth/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о keeping-one-source-of-truth

Как установить keeping-one-source-of-truth в Claude Code?

Выполните npx skills add riekelt/principal-engineer --skill keeping-one-source-of-truth -a claude-code. Файл скилла окажется по пути ~/.claude/skills/keeping-one-source-of-truth/SKILL.md.

Что делает keeping-one-source-of-truth?

Задаёт агенту доктрину: один владелец на факт, выводить вместо хранения, схлопывать дубли и громко сообщать о расхождении источников.

Что нужно для работы скилла?

Установленный скилл principal-engineering из того же репозитория — он указан как обязательная база.

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
setup-matt-pocock-skills Matt Pocock Скилл настраивает репозиторий для инженерных скиллов Matt Pocock: задаёт трекер задач, метки триажа и расположение доменной документации. Запустите его перед первым использованием остальных скиллов. 1 052 851установок ask-matt Matt Pocock Помогает выбрать подходящий скилл или рабочий поток из набора Matt Pocock. Пригодится, когда непонятно, с чего начать задачу: от идеи до разбора бага. 766 587установок to-tickets Matt Pocock Разбивает план, спецификацию или переписку на небольшие сквозные задачи и отмечает, какие из них блокируют остальные. Пригодится, когда нужно согласовать порядок работы до публикации задач в трекере. 711 230установок writing-plans Jesse Vincent Скилл превращает требования к многошаговой задаче в подробный план реализации до начала работы с кодом. Пригодится, когда исполнителю нужно зафиксировать файлы, интерфейсы и проверки. CX Codex 282 859установок caveman-review JuliusBrussee Пишет замечания к коду одной строкой: место, проблема, исправление. Пригодится, когда ревью диффа или PR надо пройти быстро и без воды. CX Codex +1 411 800установок caveman-compress JuliusBrussee Сжимает CLAUDE.md, списки задач и другие текстовые файлы в краткий формат, сохраняя читаемую резервную копию. CX Codex +1 411 500установок

Из того же набора9

guarding-architecture Защищает архитектурные границы проекта и превращает правила в автоматические тесты сборки. Пригодится при сквозных правках модулей или случайных импортах. CX Codex +1 18 000установок verifying-before-done Скилл для ИИ-агента: прежде чем объявить задачу выполненной, он прогоняет изменение на его родной поверхности и показывает вывод команды проверки. CX Codex +1 17 800установок principal-engineering Скилл задаёт строгие инженерные правила перед правками: запрещает заглушать ошибки, требует чекпоинт рисков и проверку работы реальным кодом, а не догадками. CX Codex +1 18 000установок writing-unit-tests Помогает писать и перерабатывать модульные тесты, проверяющие поведение, а не устройство кода. Пригодится для нестабильных и трудночитаемых тестов. CX Codex +1 17 800установок adding-dependencies Скилл помогает решить, нужна ли проекту новая зависимость, как её проверить и обновлять. Пригодится перед добавлением пакета, SDK или GitHub Action. CX Codex +1 17 700установок operating-safely Задаёт правила для разрушительных операций, работы с секретами и параллельных сессий. Срабатывает до вызова опасных команд вроде удаления файлов или перезапуска сервисов. CX Codex +1 17 900установок scoping-changes Помогает удерживать объём исправления в границах исходной проблемы и не выдавать сокращённую работу за завершённую. Пригодится при планировании, реализации и ревью изменений. CX Codex +1 17 700установок testing-changes Скилл задаёт правила проверки изменений в коде: когда нужен регрессионный тест, как закрывать краевые случаи и почему диффу нельзя оставаться без проверок. CX Codex +1 17 900установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой