Навыки specdd-docs
📦

specdd-docs

Ревизия содержимого r1 Безопасно ⚙️ Внешние команды

Документирование проектов SpecDD на основе спецификаций

Проектам, управляемым спецификациями, нужна документация, соответствующая текущим контрактам. Этот навык помогает Claude, Codex и Claude Code обновлять документацию на основе активных спецификаций SpecDD.

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

Установить с помощью моего Агента

Скопируйте этот запрос в своего Агента. Он содержит каноническую страницу Skill и манифест.

Запрос агента
Review the Skillstore skill "specdd-docs" from https://skillstore.io/skills/specdd-specdd-docs.md and its manifest at https://skillstore.io/api/skills/specdd-specdd-docs/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

Ваш Агент по-прежнему должен показать план и запросить все подтверждения, требуемые политикой безопасности.

Ресурсы для AI-агентов

Используйте эти ссылки, когда AI-агенту, crawler или script нужен чистый контекст вместо полной страницы.

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

Использование «specdd-docs». Обновите раздел README о потоке приглашений на основе активных спецификаций SpecDD.

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

Раздел о потоке приглашений обновлен, управляющие спецификации перечислены, и сообщено об одном недостаточно определенном правиле истечения срока.

Использование «specdd-docs». Проверьте руководство по установке на соответствие измененным спецификациям настройки.

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

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

Использование «specdd-docs». Напишите документацию для нового поведения экспорта без расширения контракта.

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

Черновик объясняет заданное поведение экспорта, избегает неподтвержденных гарантий и отмечает тесты, подтверждающие задокументированный поток.

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

Безопасно

All eight static findings are false positives caused by Markdown inline code around file paths and skill names in SKILL.md. I found no executable shell or Ruby code, prompt injection attempt, network access, or data exfiltration intent in the reviewed file.

1
Просканировано файлов
61
Проанализировано строк
0
Пункты проверки
0
Ложные срабатывания проигнорированы
Последний завершенный статический и семантический аудит не обнаружил подтвержденных проблем безопасности. Это не доказывает отсутствие побочных эффектов у навыка.
Поделиться и цитировать этот отчет

Делитесь версионным отчетом об оценке, нейтральным значком, встраиваемой карточкой и цитатами. Skillstore публикует доказательства, не решая, безопасен ли этот Skill.

Открыть версионный отчет
Оценка безопасности

Копировать ссылку на отчёт

https://skillstore.io/skills/specdd-specdd-docs/audits/5?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Значок Markdown

[![Skillstore security assessment](https://skillstore.io/badges/skills/specdd-specdd-docs/security.svg)](https://skillstore.io/skills/specdd-specdd-docs?utm_source=security_passport_badge)

Значок HTML

<a href="https://skillstore.io/skills/specdd-specdd-docs?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/specdd-specdd-docs/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Встраиваемая карточка

<iframe src="https://skillstore.io/embed/skills/specdd-specdd-docs.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
Академические ссылки (APA · BibTeX · CFF)

Цитата APA

specdd. (2026). specdd-docs security audit report (audit version 5) [Author version unspecified]. Skillstore. https://skillstore.io/skills/specdd-specdd-docs/audits/5

Цитата BibTeX

@techreport{specdd-specdd-specdd-docs-2026, author = {specdd}, title = {specdd-docs security audit report (audit version 5)}, institution = {Skillstore}, year = {2026}, number = {5}, url = {https://skillstore.io/skills/specdd-specdd-docs/audits/5}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "specdd-docs security audit report (audit version 5)" version: "unspecified" type: report authors: - name: "specdd" date-released: "2026-07-07" url: "https://skillstore.io/skills/specdd-specdd-docs/audits/5" identifiers: - type: other value: "skillstore:specdd-specdd-docs:audit:5" description: "Skillstore immutable audit report identifier"

Оценка Skillstore

Почему такая оценка Достоверность доказательств: Средний
55
Архитектура
85
Сопровождаемость
87
Контент
67
Сообщество
83
Соответствие спецификации

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

Обновление документации функции

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

Подготовка заметок по реализации

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

Проверка области документации

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

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

Обновить существующую документацию
Use specdd-docs to update the documentation for [feature]. Read the active bootstrap and governing specs before editing.
Написать новую документацию на основе спецификаций
Use specdd-docs to draft documentation for [behavior]. Source every claim from the active specs and implementation evidence.
Проверить документацию по спецификациям
Use specdd-docs to review [document]. Identify claims that are unsupported, outdated, or missing important constraints.
Определить полномочия для документации
Use specdd-docs to determine which specs govern [target path]. Report the write authority, docs to change, and any underspecified behavior.

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

  • Перед использованием этого навыка подтвердите, что в проекте есть корневой файл .specdd/bootstrap.md.
  • Перед редактированием документации определите управляющую цепочку спецификаций и права на запись.
  • Сообщайте использованные спецификации, измененные документы и любое поведение, которое остается недостаточно определенным.

Избегать

  • Использование этого навыка в проекте не на SpecDD без явного запроса на внедрение.
  • Добавление обещаний, API или рабочих процессов, которые не подтверждены спецификациями или реализацией.
  • Выведение прав на запись только из близлежащих файлов, имен или соглашений.

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

Что делает этот навык?
Он направляет написание и обновление документации на основе активных спецификаций SpecDD.
Какие инструменты могут его использовать?
Он помечен для Claude, Codex и Claude Code.
Он выполняет команды?
Нет. Навык представляет собой руководство по документации и не определяет исполняемые команды.
Можно ли использовать его вне проектов SpecDD?
Нет. Для продолжения требуется корневой файл .specdd/bootstrap.md.
Как он предотвращает появление неподтвержденной документации?
Он указывает агенту основывать утверждения на спецификациях и доказательствах из реализации.
Что должен включать итоговый отчет?
Отчет должен включать использованные спецификации, измененные документы и недостаточно определенное поведение.

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

Автор

specdd

Лицензия

Apache-2.0

Ревизия Skillstore

r1

Примечание о версии

Автор не указал версию.

Ссылка

f93e9bb0daca99badb6a7e574b97737155d57cb3

Актуальность поддержки

23.07.2026

Использование

1 загрузок · 0 просмотров

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

📄 SKILL.md

Больше от specdd

Показать все
📦

specdd-trace

77

Трассировка спецификаций SpecDD к коду и тестам

Проекты SpecDD могут терять четкие связи между спецификациями, исходными файлами, тестами и документацией. Этот навык помогает Claude, Codex и Claude Code трассировать эти связи и сообщать о пробелах, по умолчанию не редактируя файлы.

Кодинг и разработка Просмотр
📦

specdd-refactor

77

Безопасный рефакторинг проектов SpecDD

Проекты, основанные на спецификациях, могут терять поведение во время крупных структурных изменений. Этот навык проводит Claude, Codex и Claude Code через рефакторинг с учетом SpecDD, с проверками полномочий и верификацией.

Кодинг и разработка Просмотр
📦

specdd-risk

77

Классификация риска проекта SpecDD

Работа с SpecDD может завершиться неудачей, если агенты начинают без проверки полномочий, контрактов или требований к верификации. Этот навык проводит Claude, Codex и Claude Code через четкую оценку риска до начала работы.

Безопасность и соответствие требованиям Просмотр
Показать все
📦

doc-coauthoring

79

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

от ZhanlinCui

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

Документация Просмотр
📦

crafting-effective-readmes

79

Создание README с учетом аудитории

от softaworks

Универсальные README часто не учитывают потребности контрибьюторов, коллег по команде или будущих сопровождающих. Этот навык помогает Claude, Codex и Claude Code с вопросами об аудитории, шаблонами и проверками качества.

Документация Просмотр
📦

project-planner

86

Планируйте программные проекты с помощью структурированных документов

от Dwsy

Программные проекты часто терпят неудачу, когда требования, проектные решения и задачи неясны. Этот навык превращает идеи проектов в структурированные плановые документы для рабочих процессов Claude, Codex и Claude Code.

Документация Просмотр
📦

github-release-assistant

83

Генерация двуязычной документации для релизов GitHub

от ZhanlinCui

Создание качественной документации для релизов требует времени и согласованности между языками. Этот навык автоматизирует генерацию двуязычных README-файлов на основе существующих метаданных репозитория.

Документация Просмотр