doc-coauthoring
Совместное создание документации со структурированным руководством ИИ
Также доступно от: 7Spade,anthropics,Azeem-2,ZhanlinCui,davila7,7Spade,AstraBit-CPT
Создание качественной документации требует итераций и свежего взгляда. Этот навык предоставляет проверенный трёхэтапный рабочий процесс, который превращает расплывчатые идеи в ясные, протестированные читателями документы.
Скачать ZIP навыка
Загрузить в Claude
Перейдите в Settings → Capabilities → Skills → Upload skill
Включите и начните использовать
Протестировать
Использование «doc-coauthoring». Пользователь хочет написать дизайн-док для нового слоя кэширования
Ожидаемый результат:
Структурированный рабочий процесс начинается с вопросов о контексте проблемы кэширования, аудитории и ограничениях. После сбора информации и уточняющих вопросов документ строится по секциям (постановка проблемы, рассмотренные альтернативы, предложенный подход, план реализации) с итеративным уточнением. Тестирование читателем подтверждает, что документ отвечает на ключевые вопросы перед рецензированием командой.
Использование «doc-coauthoring». У пользователя есть черновик RFC, который кажется неполным
Ожидаемый результат:
Рабочий процесс выявляет пробелы через целевые вопросы, проводит мозговой штурм недостающих соображений для каждой секции и создаёт уточнённый RFC. Тестирование читателем с использованием свежей инстанции Claude выявляет двусмысленности, которые затем устраняются перед финальной публикацией.
Аудит безопасности
БезопасноAll static analysis findings are false positives. The 'external_commands' references are Claude Code tool calls (create_file, str_replace), not shell execution. The 'network' reference is documentation text directing users to claude.ai, not actual network calls. Cryptographic and reconnaissance patterns are text matches in documentation context only. This is a pure instructional skill with no executable security risks.
Оценка качества
Что вы можете построить
Написание технических спецификаций
Инженеры, создающие технические спецификации, могут использовать этот рабочий процесс для систематического сбора требований, изучения альтернатив и создания готовой к чтению документации, которая предвосхищает вопросы по реализации.
Документирование проектных решений
Команды, документирующие архитектурные решения, выигрывают от структурированного подхода, который фиксирует контекст, изучает компромиссы и проверяет ясность через тестирование читателями.
Требования к продукту и предложения
Продуктовые команды могут превращать черновые идеи в отполированные PRD, следуя этапам сбора контекста, уточнения и тестирования, чтобы обеспечить готовый для стейкхолдеров результат.
Попробуйте эти промпты
Мне нужно написать техническую спецификацию для новой функции. Можете провести меня через рабочий процесс совместного создания документации?
У меня есть существующий дизайн-док, который нуждается в улучшении. Давайте используем рабочий процесс соавторства для его поэтапного уточнения.
Мой документ почти готов. Давайте проведём этап тестирования читателем, чтобы найти пробелы перед тем, как поделиться им с командой.
Мне нужно создать документ с предложением с нуля. Проведите меня через все три этапа: сбор контекста, уточнение и структура, и тестирование читателем.
Лучшие практики
- Пройдите все три этапа без пропусков — каждый этап ловит разные типы проблем
- Предоставляйте тщательный контекст во время этапа 1 для обеспечения лучшего руководства на последующих этапах
- Используйте обратную связь от тестирования читателем для выявления реальных пробелов, а не для защиты существующего контента
Избегать
- Пропуск сбора контекста и переход сразу к черновику приводит к неполным документам
- Создание широких переписываний вместо хирургических поэтапных уточнений
- Игнорирование обратной связи от тестирования читателем, потому что контент кажется очевидным автору