Локализованное руководство по чтению

writing-skillsНазначение, использование и источник

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

Источник получен: 2026-10-29

Репозиторий-источник: obra/superpowers
SKILL.md: skills/writing-skills/SKILL.md
Звёзды репозитория: 309,479
Последнее обновление репозитория: 2026-10-30
Категории Skills: Рабочий процесс агента
Время последнего сбора: 2026-10-31 10:38 UTC+08:00

Лицензия: MIT

Оригинальный файл SKILL.md

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

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

Что делает этот навык

Как работает рабочий процесс на вышестоящем уровне

Рабочий процесс обнаружения

Как будущие агенты находят ваш навык: Сталкивается с проблемой ("тесты нестабильны") Ищет навыки (использует grep для описания, просматривает категории) Находит НАВЫК (соответствует описанию)

проход вверх по течению · L388 ↗

Обзор

Навыки написания документации применяются в разработке через тестирование (Test-Driven Development) для описания процессов. Личные навыки хранятся в каталоге навыков вашей среды выполнения.~/.claude/skills/(о Кодексе Клода) — см.codex-tools.mdилиgemini-tools.mdдля пути к этим средам выполнения. Codex, Copilot CLI и Gemini CLI также распознают этот путь.~/.agents/skills/в качестве межпрограммного псевдонима. Вы пишете тестовые примеры (сценарии стресса с субагентами), наблюдаете за их неудачами (базовое поведение), пишете навык (документацию), наблюдаете за прохождением тестов (агенты выполняют требования) и проводите рефакторинг (закрываете лазейки). Основной принцип: если вы не наблюдали за неудачей агента без навыка, вы не знаете, обучает ли навык правильным вещам.

проход вверх по течению · L8 ↗

Когда следует создавать навык

Техника не была для вас интуитивно очевидной. Вы будете ссылаться на нее в разных проектах. Этот подход применим повсеместно (а не только в рамках одного проекта). Он будет полезен и другим.

проход вверх по течению · L47 ↗

проход вверх по течению · ↗

skills/
  skill-name/
    SKILL.md              # Main reference (required)
    supporting-file.*     # Only if needed

Требования и настройка

Навыки обеспечения дисциплины (rules/requirements)

Примеры: TDD, проверка перед завершением, проектирование перед кодированием. Вопросы из академической среды: Понимают ли они правила?

проход вверх по течению · L188 ↗

Ограничения и проверки качества

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

Начните с безопасного пробного периода.

Проверьте поддерживаемый хост и инструкции по установке репозитория. Храните каталог Skill, а также связанные с ним скрипты, ресурсы и документацию вместе;SKILL.mdВ одиночку можно опустить зависимости.
Предоставьте агенту ваши реальные входные данные, желаемый результат и критерии приемки. Синтаксис вызова и доступные инструменты зависят от хоста; данный сайт не предполагает универсальной команды установки.
Попробуйте запустить исходный рабочий процесс в тестовом проекте или в его копии. Перед тем как разрешить операции, изменяющие файлы, удаленные сервисы или оплачиваемые ресурсы, проверьте их.
Проверьте выходные данные на соответствие исходным проверкам качества и вашим собственным требованиям. Успешный запуск или большое количество звезд в репозитории не гарантируют корректного результата.

Формат навыков и спецификация каталога ↗

Подробнее читайте в источнике.

Перевод и сфера применения

В этом руководстве по чтению представлены избранные отрывки из закрепленного текста выше по течению.SKILL.mdПеревод выполнен с помощью переводчика. Это не полное руководство и не гарантия проверенной совместимости. Перед использованием ознакомьтесь с оригиналом и указанными в нем файлами.

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

Закрепленный источник: Прочитайте оригинал ↗
Источник получен: 2026-10-29T09:32:23Z
Исходный коммит: 2ce8aa15d05bd57213e6f746f953aafb7ded7a8b
Исходный SHA-256: 8cb3ac68c6d8c4bb46886b998b09af7989643cab8bd0e46ee86dd62e64546bbe

Вернуться к полному каталогу навыков