📦

codebase-design

Name: codebase-design
Author: mattpocock

Ревизия содержимого r2 Безопасно ⚙️ Внешние команды

Проектирование глубоких модулей кода

Крупные кодовые базы часто накапливают поверхностные модули с широкими интерфейсами и разрозненным поведением. Этот навык помогает Claude, Codex и Claude Code проектировать более глубокие модули и более чистые тесты.

Поддерживает: Claude Codex Code(CC)

🥉 77 Бронза

Установить с помощью моего Агента

Скопируйте этот запрос в своего Агента. Он содержит каноническую страницу Skill и манифест.

Запрос агента

Review the Skillstore skill "codebase-design" from https://skillstore.io/skills/mattpocock-codebase-design.md and its manifest at https://skillstore.io/api/skills/mattpocock-codebase-design/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

Ваш Агент по-прежнему должен показать план и запросить все подтверждения, требуемые политикой безопасности.

Ресурсы для AI-агентов

Используйте эти ссылки, когда AI-агенту, crawler или script нужен чистый контекст вместо полной страницы.

Markdown-детали GET /skills/mattpocock-codebase-design.md Подписанный manifest GET /api/skills/mattpocock-codebase-design/manifest Подписанный lockfile GET /api/skills/mattpocock-codebase-design/lockfile

Протестировать

Использование «codebase-design». Проверь модуль оркестрации платежей с множеством тонких оберток.

Ожидаемый результат:

Ответ выявляет поверхностные обертки, предлагает один более глубокий интерфейс рабочего процесса и объясняет, какие зависимости должны стать адаптерами.

Использование «codebase-design». Спроектируй тесты для отрефакторенного модуля отчетности.

Ожидаемый результат:

Ответ рекомендует тесты на интерфейсе отчетности и перечисляет наблюдаемые результаты для проверок.

Использование «codebase-design». Сравни варианты интерфейса для модуля индексации поиска.

Ожидаемый результат:

Ответ сравнивает усилия вызывающего кода, скрытую сложность, размещение точек стыка, стратегию зависимостей и сопровождаемость.

Аудит безопасности

Безопасно

v5 • 23.07.2026 Открыть версионный отчет

All nine static findings are false positives. Eight findings identify Markdown code fences as shell execution, while the remaining finding identifies an illustrative TypeScript function as reconnaissance. No malicious intent, prompt injection, or executable command behavior was found.

Просканировано файлов

198

Проанализировано строк

Пункты проверки

Ложные срабатывания проигнорированы

Факторы риска

⚙️ Внешние команды (8)

SKILL.md:34-42 SKILL.md:42-46 SKILL.md:46-52 SKILL.md:52-73 SKILL.md:73-81 SKILL.md:81-85 SKILL.md:85-93 SKILL.md:93-108

Последний завершенный статический и семантический аудит не обнаружил подтвержденных проблем безопасности. Это не доказывает отсутствие побочных эффектов у навыка.

Аудитор:: codex Посмотреть историю аудитов →

Поделиться и цитировать этот отчет

Делитесь версионным отчетом об оценке, нейтральным значком, встраиваемой карточкой и цитатами. Skillstore публикует доказательства, не решая, безопасен ли этот Skill.

Открыть версионный отчет

Копировать ссылку на отчёт

https://skillstore.io/skills/mattpocock-codebase-design/audits/5?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Значок Markdown

[![Skillstore security assessment](https://skillstore.io/badges/skills/mattpocock-codebase-design/security.svg)](https://skillstore.io/skills/mattpocock-codebase-design?utm_source=security_passport_badge)

Значок HTML

<a href="https://skillstore.io/skills/mattpocock-codebase-design?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/mattpocock-codebase-design/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Встраиваемая карточка

<iframe src="https://skillstore.io/embed/skills/mattpocock-codebase-design.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

Академические ссылки (APA · BibTeX · CFF)

Цитата APA

mattpocock. (2026). codebase-design security audit report (audit version 5) [Author version unspecified]. Skillstore. https://skillstore.io/skills/mattpocock-codebase-design/audits/5

Цитата BibTeX

@techreport{mattpocock-mattpocock-codebase-design-2026,
  author = {mattpocock},
  title = {codebase-design security audit report (audit version 5)},
  institution = {Skillstore},
  year = {2026},
  number = {5},
  url = {https://skillstore.io/skills/mattpocock-codebase-design/audits/5},
  note = {Author version unspecified}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "codebase-design security audit report (audit version 5)"
version: "unspecified"
type: report
authors:
  - name: "mattpocock"
date-released: "2026-07-23"
url: "https://skillstore.io/skills/mattpocock-codebase-design/audits/5"
identifiers:
  - type: other
    value: "skillstore:mattpocock-codebase-design:audit:5"
    description: "Skillstore immutable audit report identifier"

Оценка Skillstore

Почему такая оценка Достоверность доказательств: Средний

Архитектура

Сопровождаемость

Контент

Сообщество

Соответствие спецификации

Что вы можете построить

Рефакторинг поверхностных модулей

Находите транзитный код и преобразуйте его в более глубокий модуль с меньшей поверхностью для вызывающего кода.

Планирование тестируемых интерфейсов

Переносите тесты к стабильному поведению на интерфейсе модуля вместо хрупких деталей реализации.

Сравнение вариантов архитектуры

Сгенерируйте несколько дизайнов интерфейса и сравните глубину, локальность, зависимости и размещение точек стыка.

Попробуйте эти промпты

Найти поверхностные модули

Проверь этот модуль, используя словарь codebase-design. Скажи, глубокий он или поверхностный, и объясни нагрузку на вызывающий код.

Улучшить один интерфейс

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

Спланировать рефакторинг для углубления

Классифицируй зависимости этого модуля, выбери правильную стратегию точек стыка и предложи поэтапный план безопасного углубления.

Сравнить альтернативы дизайна

Используй процесс Design It Twice. Подготовь три разных интерфейса, сравни глубину и локальность, затем порекомендуй самый сильный дизайн.

Лучшие практики

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

Избегать

Не добавляйте точки стыка, когда существует только один адаптер.
Не раскрывайте внутренние точки стыка только ради упрощения тестов.
Не оценивайте глубину модуля только по количеству строк реализации.

Часто задаваемые вопросы

С чем помогает этот навык?

Он помогает проектировать модули с меньшими интерфейсами, скрытым поведением и более чистыми тестами через стабильные точки стыка.

Редактирует ли он код автоматически?

Нет. Он предоставляет архитектурный словарь и рекомендации по проектированию, которые может применить ассистент или разработчик.

Что такое глубокий модуль?

Глубокий модуль предоставляет вызывающему коду существенное поведение через небольшой интерфейс с понятными правилами и режимами ошибок.

Как он улучшает тестирование?

Он поощряет тестирование через публичный интерфейс модуля, чтобы тесты описывали поведение, а не приватные детали реализации.

Когда следует использовать Design It Twice?

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

Какой контекст проекта нужно предоставить?

Предоставьте рассматриваемый модуль, важные места вызова, зависимости, текущие тесты и известные ограничения.

Сведения для разработчиков

Автор

mattpocock

Лицензия

MIT

Ревизия Skillstore

Примечание о версии

Автор не указал версию.

Репозиторий

https://github.com/mattpocock/skills/tree/main/skills/engineering/codebase-design/

Ссылка

ebdfe608f5de2b66ff37ab4af12af8ac4f5e8006

Актуальность поддержки

29.07.2026

Использование

6 загрузок · 0 просмотров

Структура файлов

📄 DEEPENING.md

📄 DESIGN-IT-TWICE.md

📄 SKILL.md