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

archify-tuning — скилл для Claude Code: что делает и как установить

Скилл archify-tuning помогает оценивать и улучшать генерацию архитектурных схем Archify, сокращая число правок и сбоев при отрисовке.

Apache-2.0 ★ 98 599 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add tt-a1i/archify --skill archify-tuning -a claude-code
Открыть на GitHub

Что делает archify-tuning

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

Рабочие данные сохраняются в каталог $ARCHIFY_TUNING_HOME (по умолчанию ~/.local/share/archify-tuning) вне репозитория, чтобы не закоммитить приватный исходный код проектов. Для снятия скриншотов через shots.mjs требуются Node.js версии 22.13 или новее и установленный Chrome или Chromium. Без них визуальное сравнение прогонов не сработает.

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

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

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

  • Проанализируй трейс упавшей генерации схемы и найди причину лишних изгибов связей
  • Запусти регрессионный тест через replay.mjs для последней ревизии правил компоновки
  • Зафиксируй результат раунда тюнинга в journal.md и сравни скриншоты до и после правок

Как установить archify-tuning

1Через Skills CLI (Vercel)

npx skills add tt-a1i/archify --skill archify-tuning -a claude-code

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

~/.claude/skills/archify-tuning/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/archify-tuning/

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

Вопросы об archify-tuning

Как установить archify-tuning в Claude Code?

Выполните команду npx skills add tt-a1i/archify --skill archify-tuning -a claude-code в терминале.

Что делает скилл archify-tuning?

Он предоставляет методику и набор правил для тестирования движка Archify, помогая отлаживать инструкции агента, эвристики раскладки и диагностику схем на реальных примерах.

Какие системные требования нужны для запуска тестов?

Потребуются Node 22.13 или новее, а также браузер Chrome или Chromium для утилиты shots.mjs.

Исходный текст

SKILL.md · Apache-2.0
---
name: archify-tuning
description: Improve Archify diagram accuracy, visual quality and complete authoring speed with fewer repairs. Use for generation experiments or evaluating changes to layout, routing, diagnostics, authoring instructions and acceptance rules against actual diagrams and agent traces.
metadata:
  internal: true
---

# Archify Tuning

Users describe a system and an agent authors the diagram. Optimize that complete journey, from understanding the source to delivering a usable artifact. Keep this priority:

1. **Accurate**: facts, relationships, directions, conditions, ownership and sources match the system.
2. **Readable and attractive**: a clear reading path, distinguishable connections, legible text and balanced composition.
3. **Efficient**: short complete delivery time, few failed repairs and little repeated work.

**Tests and validators serve these outcomes and are themselves candidates for improvement.** A passing check does not establish a good diagram; a failing check can expose an unsuitable rule. Judge the artifact and authoring experience before choosing what to change.

## Product requirements and adjustable rules

- Protect source facts and supported user behavior. First drafts can be wrong: retain originals and record source-backed corrections or additions. Counts of deleted elements flag a semantic review; they do not decide whether an edit is correct.
- Treat spacing, preferred direction, bend counts and single-screen fit as design strategies to assess in context. An extra bend or readable scrolling can improve the whole diagram. Preserve explicit geometry and supported contracts unless an agreed change covers them.
- Before repairing a failed check, identify the user harm it is meant to prevent and whether that harm is present. For an unsuitable rule, revise its scope, threshold or severity; update or retire obsolete tests with the rationale and actual before/after evidence. Keep the original failure visible. Changing an expected value alone proves no benefit.
- Early diagnostics and browser checks should agree where they measure the same requirement and state their different scopes elsewhere. Neither is an unquestionable oracle. Taste that cannot be judged reliably can remain advice or visual review instead of a hard failure.

## Measures

| Role | Measure | Evidence |
|---|---|---|
| Outcome | Accurate, visually acceptable final delivery | Source audit and actual screenshots; separate machine pass from visual acceptance |
| Outcome | Complete elapsed time, failed repairs and repeated work | Timed trace from task start through reading, first draft, repairs, viewing and delivery |
| Process | First-draft quality and time to first usable result | Preserve the first attempt, every failure and the last verified usable artifact |
| Regression | Fixed-input pass/fail and changed output | `replay.mjs`, affected tests and visual comparisons; render pass excludes finalize/browser acceptance |
| Diagnostic | Bends, crossings, route length, text size and CLI time | Explain an observed benefit or tradeoff; none is a substitute for whole-diagram quality |

Report delivered outcomes and failed/unfinished tasks separately. A failed run ending sooner is not a speed gain. Keep synthetic regressions separate from the frozen first-draft denominator; additions to the corpus form a versioned cohort. Repaired drafts never replace their original benchmark entries.

## Setup

- **Tuning home**: `$ARCHIFY_TUNING_HOME`, default `~/.local/share/archify-tuning`. It holds `journal.md`, `bench/`, `rounds/` and `replays/`. It stays outside the repository because drafts carry content from source projects, which may be private: never commit it.
- **Resume**: read the journal, available checkpoint and current goal state. Respect pauses and prior product decisions; continue an active round instead of duplicating it. Use the user's chosen diagram types; cover others when shared changes affect them.
- **Versions**: refresh the target remote revision and record source, base and candidate identities. Use separate durable worktrees or frozen snapshots. Record remote movement without overwriting a comparison baseline or a running author's runtime.
- **Evidence selection**: follow [Choose evidence by impact](../../../CONTRIBUTING.md#choose-evidence-by-impact). Reuse unchanged evidence with its original revision and scope.
- **Tools**: Node 22.13 or later and Chrome or Chromium for `shots.mjs` (`ARCHIFY_CHROME` overrides discovery). The collector accepts Devin CLI history or a [normalized trace export](references/trace-export.md) from another agent. It does not read other agents' private history databases.

## Loop

1. **Bound the question.** Record one user-visible problem, the hypothesis, evidence that would support or refute it, and a time/attempt budget in the journal. Rank it by frequency, harm, likely benefit and ongoing complexity. Prefer existing evidence before starting another generation.
2. **Choose the experiment.** Use fixed JSON for renderer/rule changes, independent comparable authors for instruction or complete-flow claims, and a new project to discover problems or check transfer. For author runs, timing or screenshot comparisons, read [Experiment design](references/experiment-design.md). Discovery is not proof of improvement.
3. **Attribute.** Read the trace and inspect the complete diagram using [Trace signals](references/trace-signals.md). Record the primary cause, contributing factors and uncertainty. Distinguish source misunderstanding, placement, routing, diagnostics, instruction usability and unsuitable acceptance rules. Reproduce with valid placement before blaming the router; a rule being documented does not establish that it is useful or easy to apply.
4. **Change the smallest responsible scope.** Prefer a minimal reproduction before a runtime fix. Trace other callers before changing a shared path. Evaluate main-path arrangement, interacting modules, branch/merge space and return paths together with routing. Keep experimental placements on copies; an automatic route fix must honor authored pins. Add guidance only for a demonstrated information gap, then evaluate whether authors benefit.
5. **Verify the claim.** Select affected public-behavior tests and fixed inputs; add a regression for a demonstrated runtime defect when existing coverage does not capture it. Inspect changed outputs with the same viewport and state. Investigate each changed pass/fail result: distinguish real regressions, corrected false failures and intended rule changes with evidence. Unexplained failures remain open. A local improvement must survive the complete diagram and relevant contrasting cases before adoption. Rebuild generated outputs only when their authoritative inputs changed.
6. **Conclude and consolidate.** Record confirmed facts, rejected approaches, remaining problems and one disposition: confirmed problem, verified local fix, experimental candidate, rejected approach or candidate ready for independent review. State limits on visual, speed and generalization claims. Prepare small reviewable changes once benefits are established; separate unrelated fixes and prototypes. Follow [CONTRIBUTING.md](../../../CONTRIBUTING.md) for integration; this skill grants no push, PR, merge, release or live-install authority.

### When to stop an experiment

- At the budget limit, record the result and remaining uncertainty. Extend only for a concrete new hypothesis and a fresh bounded test.
- Stop or change focus when attempts repeat without new causal evidence, depend on project-specific coordinate search, improve selected lines while worsening the whole graph, or add complexity disproportionate to the benefit.
- Preserve the last verified artifact separately from an unsuccessful experiment. Ending an experiment does not complete the overall goal. Consolidate useful fixes before accumulating another batch.

## Tools and reporting

Run from the repository root; these tools supply evidence for the selected experiment, not a mandatory sequence every round. `round`, `collect` and `replay` print usage with no arguments.

| Need | Command |
|---|---|
| Fixed-input comparison | `node .agents/skills/archify-tuning/scripts/replay.mjs --base <base>/archify` |
| Prepare author tasks | `node .agents/skills/archify-tuning/scripts/round.mjs <project-path> --types <selected-types> --archify <frozen-runtime>/archify` |
| Collect traces and content-change signals | `node .agents/skills/archify-tuning/scripts/collect.mjs <round> --dump` (add `--trace-export <file.json>` outside Devin) |
| Initial light-theme image comparison | `node .agents/skills/archify-tuning/scripts/shots.mjs <replay-dir> --height 900` |

The collector does not establish semantic correctness or complete elapsed time; supplement it with source review and timing records. Preserve failure logs and unknown outcomes. Diagnostics should name the affected element and a verified repair, or explain why no repair was found. Keep authoring guidance concise and reachable in required reads; avoid accumulating advice that has no observed benefit.

© tt-a1i · Apache-2.0 · tt-a1i/archify

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
fireworks-tech-graph yizhiyanhua-ai Скилл fireworks-tech-graph генерирует точные технические схемы в SVG, экспортирует их в PNG или автономный HTML и анимирует в GIF. Пригодится при проектировании архитектуры, UML, C4 и воркфлоу агентов. CX Codex +1 18 400установок mermaid-diagrams davila7 Скилл mermaid-diagrams для Claude Code — учит агента писать диаграммы Mermaid: классы, последовательности, ERD, C4, флоучарты. Документирует архитектуру и схемы БД. CX Codex +1 1 180установок system-atlas inkboard Скилл system-atlas создаёт интерактивную изометрическую карту архитектуры и файл SYSTEM.md из одного источника данных, помогая вести обсуждения и фиксировать вопросы. CX Codex +1 525установок excalidraw Hermes Agent Генерирует .excalidraw-файлы с архитектурными схемами, флоучартами и sequence-диаграммами. CX Codex +1 424установок diagram-quality pproenca Скилл diagram-quality задаёт правила отрисовки PlantUML на холсте agent-uml, предотвращая ошибки HTTP 400 и пустые схемы при работе с инструментами дизайна. CX Codex +1 230установок blueprint-mcp-diagram-generation reason-machines Скилл blueprint-mcp-diagram-generation готовит архитектурные схемы, блок-схемы и диаграммы потоков данных по текстовому описанию. Работает через Nano Banana Pro и MCP-сервер Arcade. CX Codex +1 189установок

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

Весь набор →
cache-miss.sequence Промпт cache-miss.sequence генерирует через скилл Archify диаграмму последовательности для запроса дашборда с промахом кэша в Redis и обращением к PostgreSQL. CX Codex GP ChatGPT ★ 98 599звёзд репо web-runtime.architecture Промпт web-runtime.architecture для генерации JSON-схемы веб-архитектуры через утилиту Archify с записью результата в benchmark-candidate.json. CX Codex GP ChatGPT ★ 98 599звёзд репо product-analytics.dataflow Промпт product-analytics.dataflow задаёт схему продуктовой аналитики: от событий веб- и мобильных клиентов до витрин, дашбордов и модели. Учитывает согласие на обработку и защищённое хранение идентификаторов. CX Codex GP ChatGPT ★ 98 599звёзд репо agent-tool-call.workflow Промпт agent-tool-call.workflow для создания диаграммы workflow-а, где AI-агент вызывает инструменты с проверкой у человека. CX Codex GP ChatGPT ★ 98 599звёзд репо agent-run.lifecycle Промпт agent-run.lifecycle ставит агенту задачу спроектировать JSON-диаграмму жизненного цикла агентского запуска через встроенный инструмент Archify. CX Codex GP ChatGPT ★ 98 599звёзд репо archify-review Скилл archify-review для Claude Code оценивает задачи, pull request и код по ценности, стоимости и влиянию. Помогает проводить триаж и принимать решения по сопровождению. CX Codex +1 ★ 98 599звёзд репо simplify-codebase Скилл simplify-codebase для аудита и упрощения кодовой базы: ищет мёртвый код, дубли состояния и лишние слои, а в режиме правок удаляет их, когда есть доказательства. CX Codex +1 ★ 98 599звёзд репо test-value Скилл test-value помогает выбирать тесты по риску, находить дубли и разбирать нестабильные проверки. Пригодится во время разработки, аудита и ревью перед коммитом. CX Codex +1 ★ 98 599звёзд репо

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

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