mcpField
B
bro-review-spec-plan

bro-review-spec-plan

github.com/irpsv测试与质量941 次安装今天更新
代码仓库

关于 bro-review-spec-plan

bro-review-spec-plan 是用于审查现有规格说明或实施计划的只读技能，面向需要独立检查文档问题的开发流程。它只输出带证据的审查报告，不修改文件，也不代替评审编写或实施计划。

主要功能

  1. 01审查现有规格说明或实施计划
  2. 02只读检查文档、仓库及相关文件
  3. 03可进行安全的非破坏性检查
  4. 04报告包含证据的问题项
  5. 05不修改文件或生成实施方案

适用场景

  1. 01检查规格说明中的实质性缺陷
  2. 02复核实施计划并记录有据问题
  3. 03在不改动审查对象的情况下生成报告

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/irpsv/ai-bro --skill bro-review-spec-plan

安装后在 Claude Code 中输入/bro-review-spec-plan确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

evals/
evals.json
trigger-evals.json
references/
review-output-example.md
subagent-model-tiers.md
subagents/
reviewer-prompt.md
security-reviewer-prompt.md

README 原文English

来自项目 README

README 暂无中文译文，以下为英文原文；中文介绍见上方。

bro-review-spec-plan

Независимое ревью уже существующей спецификации результата или плана реализации. Результат — только отчёт. Не исправляй артефакт, не вызывай CreatePlan и не подменяй ревью составлением или реализацией.

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

READONLY

Разрешено читать артефакт, репозиторий и связанные файлы, искать факты в коде, проверять веб-ссылки и запускать безопасные недеструктивные проверки.

Запрещено:

  • изменять или создавать файлы, в том числе spec, plan и файлы harness;
  • вызывать CreatePlan или аналог обновления плана;
  • править текст артефакта «заодно» с отчётом;
  • предлагать архитектуру, diff, патчи, псевдокод или шаги реализации как замену findings;
  • сообщать стилистические предпочтения и недоказанные предположения как findings.

Вход ревью

Сначала определи объект ревью:

  1. Явно указанный путь к файлу.
  2. Полный текст артефакта, переданный вызывающим скиллом.
  3. Прикреплённый или открытый файл спецификации или плана.
  4. Полный текст артефакта в текущем сообщении человека.
  5. Если есть ровно один очевидный свежий кандидат — возьми его и назови путь в отчёте. Если кандидатов несколько или ни одного — не угадывай.

Если объект так и не установлен — остановись и задай один вопрос, что ревьюить. Не начинай ревью по догадке. Если вызывающий скилл уже передал путь или текст — не спрашивай объект заново.

Кого запускать

Ревью ОБЯЗАТЕЛЬНО должны делать субагенты ревьюверы:

  1. общее ревью — тир senior, промпт субагента reviewer-prompt
  2. проверка безопасности — тир critical, промпт субагента security-reviewer-prompt

Запускай ревью безопасности только если: в тексте есть доступ, доверие, секреты или права (кто к чему допускается, роли, авторизация, токены, ключи, пароли, персональные данные как предмет защиты).

Итоговый формат

Начни с раздела ## Результаты ревью. Дальше:

  • Статус: PASS | NEEDS_WORK | BLOCKED
  • Объект: путь или «текст из сообщения»

Затем findings. Для каждого:

  1. Заголовок #### [ID] Краткое название.
  2. **Тип:** значение из отчёта ревьюера.
  3. **Где:** раздел, шаг, критерий или утверждение.
  4. **Проблема:** конкретный дефект.
  5. **Доказательство:** фрагмент артефакта и/или факт из репозитория или проверки ссылки.
  6. **Требуется:** какое изменение текста или какой ответ человека нужен. Это не патч и не поручение править файл в этом запуске.

Если findings нет — напиши: Существенных проблем не найдено.

Если есть блокеры — отдельный раздел ### Блокеры со списком вопросов или недоступных фактов. Не начинай допрос: для BLOCKED достаточно показать блокеры в отчёте.

Оформляй по примеру.

После результатов:

Краткое резюме
  • что просмотрено;
  • какие проверки использованы, в том числе была ли проверка безопасности;
  • какие риски остались непроверенными и почему;
  • какой нужно сделать следующий шаг

评论

支持 Markdown