SkillFoxx
Telegram

Architecture Copilot — скилл

Скилл делает агента архитектурным тренером: вопросами ведет к ADR, схеме и плану развития, чужой репозиторий разбирает по коду

  • 90 ★ репозитория
  • Последний коммит
Скилл

Минимальный доступ

Почему такой уровень

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

study8677/architecture-copilotАвтор:study8677

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/architecture-copilot

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

Другие способы установки

Доступ и проверки

Как мы проверяем

Минимальный доступИнструмент ничего не запускает и не ходит в сеть.

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

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

Что делает

Скилл сначала задает вопросы и код не пишет. Новый проект он проводит через восемь стадий: одна фраза о задаче, бизнес и границы (что версия не делает), шесть вопросов о масштабе, соотношении чтения и записи, согласованности, росте, цене отказа и ограничениях, прикидка QPS и объема хранилища, выбор между качествами, развилки ключевых решений и контраргументы. На выходе схема архитектуры в ASCII, модель данных, список решений ADR, узкие места, путь развития от MVP и честный перечень слабых мест. Для существующего репозитория сначала идет сбор доказательств: входные точки, ядро, данные и миграции, развертывание и CI, тесты, главный поток данных. Затем таблица «наблюдено, предположено, неизвестно» с файлами и командами и три улучшения с наибольшим эффектом, у каждого проверка, откат и ADR. Скилл ставится в `~/.claude/skills/` для Claude Code, правилом `.cursor/rules/architecture-copilot.mdc` для Cursor и в `~/.codex/skills/` для Codex. Знания берутся из репозитория awesome-architecture.

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

Подходит, если

  • Начинается новый продукт, и надо за разговор прийти к схеме, модели данных и ADR
  • Вы готовитесь к собеседованию по проектированию систем и тренируете ответы с вопросами о нагрузке
  • Достался незнакомый репозиторий, и нужны три самые полезные правки с проверкой и откатом
  • Команде нужны архитектурные ограничения в виде `AGENTS.md` и проверок для агентов

Не подходит, если

  • Нужен готовый код модуля: скилл сначала спрашивает и сам решение не выдает
  • Вопрос узкий и локальный, например правка одной функции: многостадийный опрос будет лишним
  • Вы ожидаете единственно верный ответ: скилл показывает компромиссы и просит выбрать

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

Я хочу сделать многопользовательский список дел для небольших команд. Помоги продумать архитектуру вопросами

Ограничения

  • Основной текст README и скилла написан на китайском, есть английская версия `README_en.md`, ответы агент ведет на языке пользователя.
  • Без проверки реального кода выводы по существующему репозиторию были бы догадками, поэтому скилл требует чтения файлов и команд.
  • Количество шаблонов систем в базе знаний зависит от репозитория awesome-architecture и может меняться.
  • Скилл только ведет разговор и анализ, архитектурные решения принимает пользователь.

Как отключить. Удалите `~/.claude/skills/architecture-copilot` или `~/.codex/skills/architecture-copilot` либо файл `.cursor/rules/architecture-copilot.mdc` из проекта.

Частые вопросы

Как поставить Architecture Copilot?

Для Claude Code скопируйте папку скилла в `~/.claude/skills/`, для Codex в `~/.codex/skills/`, для Cursor положите файл правил в `.cursor/rules/`. Подробный порядок описан в `INSTALL.md`.

Из каких стадий состоит разговор?

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

Что скилл делает с существующим репозиторием?

Читает входные точки, модули, данные, CI и тесты, затем выдает таблицу наблюдений с файлами и топ-3 улучшений с проверкой и откатом. Пересказом README он не ограничивается.

Откуда у скилла знания?

Из соседнего репозитория awesome-architecture: курс по проектированию систем и шаблоны систем. Для каждого шаблона в `references/` лежат ключевые решения, антипаттерны и сигналы развития.

Как проверить качество скилла?

Запустите `python3 scripts/check_quality.py`: он проверяет метаданные, согласованность между Claude Code, Cursor и Codex и тестовые случаи из папки `evals`.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

lencx skills

lencx-skills

Два скилла для Claude Code и Codex: keel решает вопросы архитектуры, coding-protocol держит правки кода в границах задачи

СкиллМинимальный доступ197

14 скиллов, которые находят пробелы в задаче до кода: интервью, план, проверка допущений и доказательство исправления бага

СкиллМинимальный доступ372

Библиотека скиллов для Claude Code, Cursor и Codex: ревью командой агентов, TDD, стековые PR, оценка готовности репозитория

ПлагинРасширенный доступ72

Скилл ревью в два взгляда: правый мозг смотрит на архитектуру, левый проверяет контракты и код, память проекта хранится в файле

СкиллРасширенный доступ154

Скилл расспрашивает про проект и пишет requirements.md, design.md и tasks.md, чтобы Claude Code и Cursor работали по одному плану

СкиллРасширенный доступ158

Скилл рисует интерактивную изометрическую карту репозитория: здания по размеру кода, потоки по реальным вызовам.

СкиллРасширенный доступ386

Коротко о README

README объясняет, зачем нужен тренер архитектуры, показывает образец диалога про список дел с выбором между OT и CRDT и таблицу восьми стадий. Отдельный раздел посвящен разбору существующего репозитория. Дальше идут установка для трех инструментов, связь с awesome-architecture и проверки качества.

Бейдж для README

Исходный SKILL.md

---
name: architecture-copilot
description: >-
  引导式「架构共创」教练。当用户面对一个新项目 / 新系统、想在动手写代码前把架构想清楚时使用,
  也适用于系统设计面试练习、技术方案讨论、架构评审、现有方案读图,以及从真实代码和配置还原
  现有仓库架构、定位高杠杆改进。新系统以提问共创;现有仓库必须先取证、后判断。它不直接给方案,
  而是通过分阶段深度提问(一句话定位 → 业务范围 → 灵魂六问 → 信封背面估算 →
  质量属性取舍 → 关键决策追问 → 收敛产出 → 反挑战)引导用户收敛出:
  架构全景图、数据模型、ADR 决策记录、规模化瓶颈、演进路线、风险清单,
  并可把关键约束沉淀成 AGENTS.md / 适应度函数 / eval 门禁。方法论与案例知识源自
  awesome-architecture 的系统设计教程与数十个系统模板(具体数量以上游为准);
  本 skill 的 references/ 里为每个模板沉淀了「关键决策 / 反模式 / 演进信号」按需加载。
  触发词:设计架构、系统设计、技术方案、架构评审、架构体检、了解当前项目、读图、
  "我想做一个…该怎么设计"、system design、architecture review。
---

# Architecture Copilot · 架构副驾

> 你是一位资深的**架构教练**,不是代码生成器。
> 用户带着一个「想做的东西」或「已有方案」来,你的任务**不是直接甩出架构图**,
> 而是通过结构化深度提问,引导用户把约束、取舍、失败模式和演进路线想清楚。
> 本规范的方法论与案例来自 **[awesome-architecture](https://github.com/study8677/awesome-architecture)**。

---

## 何时使用 / 何时不要使用

**使用本 skill**:
- 用户要设计新系统、新产品、新模块,或做 system design 练习。
- 用户要讨论技术方案、架构选型、架构评审、现有架构图 / 文档的优缺点。
- 用户要了解当前代码仓库、还原真实架构、寻找高杠杆改进或判断技术债优先级。
- 用户说「我想做一个 X,该怎么设计」「帮我把架构想清楚」「这个方案会死在哪」。

**不要自动进入架构副驾模式**:
- 用户明确要写代码、修 bug、补测试、查 API、改 UI、跑命令,且没有架构讨论意图。
- 用户只问某个实现细节。可以短答,必要时只提醒「这是架构相关取舍」,不要强行走完整八阶段。
- 用户要求直接产出方案时,先说明「信息不足会影响判断」,但可以给**最小可用方案 + 明确假设**;不要无限追问。

**模板深度从哪来**:
- 优先读**本地 `references/`**:阶段 5 匹配到模板后,按映射表最后一列去读对应类别文件(每个模板有「关键决策 / 反模式 / 演进信号」三节)。这是离线可靠的深度来源。
- 需要完整 14 节模板(架构图 / 组件职责 / 数据流 / 数据模型 / 安全 / 参考原型)或端到端案例时,指引用户去上游 [awesome-architecture/templates](https://github.com/study8677/awesome-architecture/tree/main/templates) 的 `templates/<slug>/`——上游是唯一权威、始终最新。references 只有三节摘要、**没有现成架构图**;不要拿摘要拼凑或编造某个上游模板的图 / 数据模型充数。阶段 6 的 ASCII 图应根据**用户自己的约束现场共创**,而非复述模板里的图。
- 若 references 和网络都不可用,用下方映射表的必问决策 + 通用决策继续,不阻塞。
- 模板只是起点,不是答案。始终用用户的约束覆盖模板默认值。
- 审视现有代码仓库时,先读 `references/repository-review.md`;需要稳定产物时再使用 `assets/` 模板。

Сообщить о проблеме