Об этом проекте

Это локализованная на упрощённый китайский версия репозитория mattpocock/skills, предназначенная для coding-агентов, таких как Claude Code и Codex. Она предоставляет набор agent skills, основанных на реальной повседневной инженерной работе автора, и делает акцент на компактности, изменяемости и компоновочности, а не на методологическом фреймворке, который полностью перехватывает процесс разработки. Мотивация и стратегия локализации: - Китайские описания снижают затраты на концептуальное переключение для разработчиков, чей родной язык — китайский. Для моделей, взаимодействующих на китайском или оптимизированных под китайские корпусы, китайские промпты лучше соответствуют контексту, уменьшая неоднозначность, возникающую из-за смешения языков. - Перевод выполнен по принципу skill-guided content localization: переводятся только текстовые описания на естественном языке, при этом сохраняются имена каталогов, названия навыков, ключи frontmatter, команды, блоки кода, пути, URL, идентификаторы пакетов/инструментов/API и т.д., чтобы не нарушить установку и выполнение. - Репозиторий синхронизируется с upstream по содержимому, не повторяя git-историю или настройки управления репозиторием. Последняя синхронизация и перевод выполнены Claude (Anthropic) и внесены в main через PR; правила обслуживания записаны в .skills/translate-skill/SKILL.md. Способы установки (выберите один, не устанавливайте повторно): 1. Установщик skills.sh: Выполните `npx skills@latest add vinvcn/mattpocock-skills-zh-CN`, выберите навыки и целевых coding-агентов. Навыки копируются в проект для удобного изменения и настройки. 2. Плагин для Claude Code: Выполните `/plugin marketplace add vinvcn/mattpocock-skills-zh-CN` и `/plugin install mattpocock-skills@mattpocock`. Навыки устанавливаются как управляемый read-only bundle, обновляемый с новыми версиями. Подходит для тех, кто хочет использовать готовое и следить за обновлениями. 3. DeepSeek Harness (dsh): Установите как плагин с помощью `dsh plugin --profile web add @vinvcn/dsh-mattpocock-skills-zh`. После установки навыки вызываются по имени с префиксом `/zh-`, например `/zh-grilling`. После первой установки необходимо выбрать `/setup-matt-pocock-skills` и запустить его в агенте. Это настроит issue tracker (GitHub, Linear или локальный файл), метки для триажа и место сохранения документов. Концепция дизайна: автор разработал навыки, направленные на устранение типичных сбоев coding-агентов: - Несоответствие требований: Сессия запросов (grilling session: `/grill-me`, `/grill-with-docs`) заставляет агента задавать подробные вопросы перед началом работы, согласовывая намерения. - Многословие: Документ shared language (CONTEXT.md) помогает агенту декодировать терминологию проекта, делая именование более согласованным, код — более читаемым, а мышление — менее затратным по токенам. - Код не запускается: Упор на feedback loops (статическая типизация, браузерный доступ, автоматические тесты). `/tdd` запускает цикл red-green-refactor; `/diagnosing-bugs` предлагает дисциплинированный, поэтапный цикл отладки. - Архитектурная деградация: `/to-spec` перед написанием спецификации запрашивает, какие модули планируется изменять. `/improve-codebase-architecture` сканирует код на deepening opportunities и генерирует визуальный HTML-отчёт; предназначен для регулярного survey, а не для спасения. Навыки делятся по признаку «кто может вызвать»: user-invoked (требуют ввода имени пользователем; отвечают за оркестрацию; могут вызывать model-invoked навыки, но не могут вызывать другие user-invoked) и model-invoked (могут быть вызваны пользователем или автоматически агентом при совпадении задачи; несут переиспользуемую дисциплину). Engineering (инженерные): - User-invoked: ask-matt (роутинг навыков репозитория), grill-with-docs (интервью с уточнением и ведение CONTEXT.md и ADR), triage (машина состояний с ролями для продвижения issue), improve-codebase-architecture, setup-matt-pocock-skills, to-spec (преобразование диалога в spec и публикация в issue tracker), to-tickets (разбивка плана на tracer-bullet tickets с блокировками), wayfinder (планирование крупной работы как набора decision tickets в issue tracker для совместного понимания), implement (реализация по spec/ticket, с использованием /tdd на оговорённых seams и завершением /code-review). - Model-invoked: prototype (создание одноразового прототипа: один HTML-файл или несколько вариантов UI), diagnosing-bugs, research (исследование по авторитетным первоисточникам с сохранением Markdown с цитатами), tdd, domain-modeling, codebase-design (дисциплина deep modules и лексика), code-review (двухосевой обзор по Standards и Spec с параллельными под-агентами), resolving-merge-conflicts (пофрагментное разрешение конфликтов с отслеживанием намерений каждой стороны, без использования --abort), wizard (создание интерактивного bash-мастера для выполнения человеко-ориентированных шагов: настройка инфраструктуры, credentials, CI secrets, одноразовые миграции). Productivity (общие рабочие процессы, не только код): - User-invoked: grill-me, handoff (сжатие диалога в передаточный документ), teach (с текущей директорией как состоятельной учебной рабочей областью; обучение через сессии), to-questionnaire (преобразование решения в Markdown-анкету для заполнения теми, кто может ответить), wait-what (восполнение отсутствующего контекста и перефразирование сообщения простым языком). - Model-invoked: grilling (переиспользуемый примитив интервью; поддерживает grill-me, grill-with-docs, triage, wayfinder, improve-codebase-architecture), writing-for-agents (написание документации для агентов, например AGENTS.md/CLAUDE.md). Misc (локальные, редко используемые): git-guardrails-claude-code (хуки для перехвата опасных git-команд: push, reset --hard, clean), migrate-to-shoehorn (миграция as-приведений типов в тестах на @total-typescript/shoehorn), scaffold-exercises (генерация каталогов упражнений с секциями, задачами, решениями и объяснениями), setup-pre-commit (настройка Husky pre-commit хуков с интеграцией lint-staged, Prettier, проверки типов и тестов).