revise
Доработка документов P11 по комментариям рецензентов
Проверка документов p11 с участием нескольких соавторов создает разрозненную обратную связь, которую трудно применять вручную. Этот навык читает комментарии рецензентов, классифицирует их по ясности, применяет понятные решения к исходному документу и автоматически публикует новую версию.
Скачать ZIP навыка
Загрузить в Claude
Перейдите в Settings → Capabilities → Skills → Upload skill
Включите и начните использовать
Ресурсы для Agent
Используйте эти ссылки, когда AI Agent, crawler или script нужен чистый контекст вместо чтения всей страницы.
Протестировать
Использование «revise». Примени обратную связь по моему дизайн-предложению, где команда попросила добавить раздел с резюме и изменить порядок списка требований.
Ожидаемый результат:
Я просмотрел 8 веток комментариев к вашему дизайн-предложению. Я нашел 6 понятных решений и 2, требующих вашего ввода. Я применил все понятные изменения: добавил раздел с резюме после введения, упорядочил список требований по приоритету и обновил таблицу сроков. Вот обновленные Read URL и Edit URL.
Использование «revise». Обнови документацию API с учетом комментариев ревью из версии 3.
Ожидаемый результат:
Я получил версию 3 документации API и нашел 5 веток комментариев. Во всех комментариях были понятные решения, поэтому я применил их все: исправил URL эндпоинтов в разделе аутентификации, добавил новую таблицу параметров ограничения частоты запросов и исправил примеры формата ответа. Доработанный документ опубликован по новому Read URL.
Аудит безопасности
Низкий рискAll 57 static findings are false positives. Weak cryptographic algorithm flags were triggered by a hex color code ("#2563EB" in openai.yaml:3), a React component name ("DefinitionDescription" in components.md:34), and YAML metadata fields (SKILL.md:3-5). Ruby/shell backtick execution flags were triggered by Markdown code block backticks in code fences across SKILL.md and components.md. The system reconnaissance flag on SKILL.md:92 is actually security-conscious guidance about bearer credentials. The skill has legitimate external command usage via the p11 CLI, which is expected and necessary for its document revision workflow. No malicious intent detected.
Проблемы низкого риска (3)
Факторы риска
⚙️ Внешние команды (6)
Обнаруженные паттерны
Оценка качества
Что вы можете построить
Обновление дизайн-предложения после командного ревью
Дизайнер получает обратную связь по документу с предложением функции. Навык применяет все понятные решения из комментариев рецензентов и публикует обновленную версию для финального утверждения.
Применение обратной связи технического ревью к документации
Инженер собирает комментарии к технической документации. Навык обрабатывает каждый комментарий, вносит запрошенные изменения и делится доработанным документом.
Пакетная обработка нескольких раундов ревью документов
Руководитель команды управляет итеративными ревью документов в несколько раундов. Навык отслеживает, какие комментарии были применены, а какие все еще требуют обсуждения.
Попробуйте эти промпты
Use p11:revise to update the most recent p11 document with reviewer feedback. Fetch the comments and apply all clear decisions.
Revise p11 document at edit URL [url] from version [number]. Fetch comments from that version and apply clear decisions only.
Use p11:revise on the current document. Classify all visible comment threads. If any need clarification, ask me how to proceed before publishing.
Revise the document at [url]. First read the components reference, then fetch all comments. Apply clear decisions and publish. Report which changes were made and which need my input.
Лучшие практики
- Всегда классифицируйте ветки комментариев по содержанию перед внесением изменений. Не все нерешенные комментарии требуют действия.
- Получайте подтверждение пользователя перед публикацией, если какие-либо ветки комментариев требуют уточнения человеком.
- Читайте справочник компонентов p11 перед редактированием, чтобы использовать только поддерживаемые компоненты документов.
Избегать
- Молчаливо игнорировать видимые ветки комментариев, требующие уточнения человеком. Всегда спрашивайте пользователя, как действовать дальше.
- Публиковать доработанные версии без предварительного получения и просмотра всех комментариев к целевому документу.
- Добавлять в документы интерактивные UI-элементы, такие как кнопки или формы. Используйте только безопасные для документов компоненты из библиотеки p11.