Навыки doc-coauthoring
📄

doc-coauthoring

Безопасно

Совместное создание документации с ИИ

Также доступно от: 7Spade,7Spade,davila7,AstraBit-CPT,Azeem-2,anthropics

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

Поддерживает: Claude Codex Code(CC)
🥉 74 Бронза
1

Скачать ZIP навыка

2

Загрузить в Claude

Перейдите в Settings → Capabilities → Skills → Upload skill

3

Включите и начните использовать

Протестировать

Использование «doc-coauthoring». Мне нужно написать техническую спецификацию для нашего нового API

Ожидаемый результат:

Я могу помочь вам создать техническую спецификацию с помощью нашего структурированного рабочего процесса. Вот что мы сделаем:

**Этап 1: Сбор контекста** — Я задам вопросы о вашем API, его назначении, техническом подходе и о том, кто будет его разрабатывать.

**Этап 2: Уточнение и структурирование** — Мы будем создавать спецификацию раздел за разделом, проводя мозговой штурм вариантов контента и улучшая каждую часть.

**Этап 3: Тестирование читателем** — Мы протестируем спецификацию с новым экземпляром Claude, чтобы убедиться в её ясности для разработчиков.

Хотите продолжить с этим рабочим процессом или предпочитаете работать в свободном формате?

Использование «doc-coauthoring». Помогите создать документ с решениями по внедрению новой базы данных

Ожидаемый результат:

Я проведу вас через создание документа с решениями по выбору базы данных. Начнём со **Сбора контекста**:

1. Какой тип документа это будет? (Документ с решениями, RFC и т.д.)
2. Кто основная аудитория?
3. Каков желаемый результат, когда кто-то прочитает это?
4. Есть ли шаблон или конкретный формат, которому нужно следовать?
5. Любые другие ограничения или контекст, о которых нужно знать?

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

Аудит безопасности

Безопасно
v1 • 2/24/2026

All 18 static findings are false positives. The skill is a documentation co-authoring workflow that guides users through structured document creation. Tool references like `create_file` and `str_replace` were misidentified as external shell commands. Documentation type keywords (spec, proposal, decision) were incorrectly flagged as cryptographic algorithms. The single network reference to claude.ai is legitimate for reader testing. No actual security risks identified.

1
Просканировано файлов
376
Проанализировано строк
0
находки
1
Всего аудитов
Проблем безопасности не найдено
Проверено: claude

Оценка качества

38
Архитектура
100
Сопровождаемость
87
Контент
50
Сообщество
100
Безопасность
91
Соответствие спецификации

Что вы можете построить

Создание технических спецификаций

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

Написание документов с решениями

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

Разработка предложений для команды

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

Попробуйте эти промпты

Запуск рабочего процесса документации 
Я хочу создать [тип документа]. Можете провести меня через рабочий процесс совместного создания документации?
Начать с шаблона 
У меня есть шаблон документа по [URL/путь]. Можете помочь мне заполнить его с помощью вашего структурированного рабочего процесса документации?
Улучшение существующего документа 
У меня есть существующий документ, который нужно улучшить. Можем ли мы использовать ваш рабочий процесс для его улучшения и тестирования с новым экземпляром ИИ?
Полный проект документации 
Мне нужно создать комплексный [PRD/техническая спецификация/документ с решениями] для [название проекта]. Аудитория — [описание]. Можем ли мы пройти через ваш полный трёхэтапный рабочий процесс документации?

Лучшие практики

  • Предоставляйте комплексный контекст на Этапе 1 — чем больше информации вы поделитесь, тем лучше руководство вы получите
  • Используйте итеративный цикл обратной связи — указывайте конкретные изменения, а не размытые предпочтения для лучших результатов
  • Завершайте тестирование читателем — тестирование с новым экземпляром ИИ выявляет допущения и пробелы, невидимые для автора

Избегать

  • Пропуск сбора контекста — переход сразу к черновику без предоставления фона приводит к общему, поверхностному контенту
  • Предоставление минимальной обратной связи — фраза «выглядит хорошо» без конкретики мешает рабочему процессу учиться вашим предпочтениям
  • Пропуск тестирования читателем — публикация документов без тестирования может оставить критические пробелы, которые запутают читателей

Часто задаваемые вопросы

Сколько времени занимает рабочий процесс документации?
Рабочий процесс занимает столько времени, сколько нужно для создания качественной документации. Простые документы могут занять 15-30 минут. Сложные технические спецификации или предложения могут потребовать нескольких сессий.
Могу ли я пропустить этапы, если тороплюсь?
Вы можете пропустить этапы, но качество результата пострадает. Если вы пропустите сбор контекста, контент может упустить критические детали. Если вы пропустите тестирование читателем, читатели могут найти документ запутанным.
Какие типы документов лучше всего работают с этим рабочим процессом?
Этот рабочий процесс хорошо подходит для технических спецификаций, документов с решениями, предложений, PRD, дизайн-документов, RFC и любого существенного контента, который должен быть ясен для читателей.
Нужны ли мне специальные инструменты или интеграции?
Специальные инструменты не требуются. Рабочий процесс работает с базовым доступом к Claude. Интеграции, такие как суб-агенты (Claude Code), позволяют автоматизировать тестирование читателем, но ручные инструкции по тестированию предоставляются для пользователей веб-интерфейса.
Что, если у меня уже есть шаблон документа?
Поделитесь своим шаблоном во время сбора контекста. Рабочий процесс использует вашу структуру и поможет заполнить каждый раздел, используя процесс мозгового штурма и уточнения.
Как работает тестирование читателем?
Тестирование читателем использует новый экземпляр Claude (без контекста из вашей текущей беседы) для ответа на вопросы о вашем документе. Это выявляет пробелы и допущения, которые авторы упускают, потому что у них есть весь контекст.

Сведения для разработчиков

Автор

ZhanlinCui

Лицензия

MIT

Репозиторий

https://github.com/ZhanlinCui/Ultimate-Agent-Skills-Collection/tree/main/doc-coauthoring

Ссылка

main

Структура файлов

📄 SKILL.md