BC reqplan-v3
Движок управления полным жизненным циклом проекта. Используется для систематического и процессного выполнения задач программной инженерии. **Когда использовать**: - Пользователь говорит «Помоги мне разработать…», «Реализовать… функцию», «Добавить…», «Написать…» - Пользователь говорит «Помоги мне проанализировать…», «Проверить…», «Посмотри на этот дизайн…» - Пользователь говорит «Ошибка», «Ошибка выполнения», «Исправить… ошибку», «Исправить…» - Пользователь говорит «Помоги мне спланировать…», «Как сделать…», «Какие есть варианты» - Пользователь говорит «Дополнить документацию…», «Добавить документацию…», «Написать документацию…» - Пользователь говорит «Рефакторинг…», «Оптимизировать архитектуру…», «Технический долг…» - Пользователь говорит «Тестировать…», «Написать тесты…», «Покрытие…» - Пользователь вводит команду «/reqplan» - Любые сложные задачи, требующие многошагового планирования, проектирования, реализации и проверки **Когда НЕ использовать**: - Одиночные простые вопросы (например, «Как сортировать список в Python?»), не требующие планирования многошаговых задач - Чистое общение без конкретной цели (без намерения разработки/анализа/исправления) - Чисто информационный запрос (например, «Что нового в React 18?»), не требующий вывода кода - Пользователь только просит просмотреть код, без необходимости анализа, модификации или проектирования - Требования крайне расплывчаты, и пользователь отказывается уточнять, невозможно определить границы конкретной задачи - Цель/область задачи четко определены, требуется только однократное изменение кода, без многоэтапного сотрудничества **Как это работает**: 0. Определение пути проекта (мета-задачи следуют основным правилам, не пропускаются из-за неопределенности пути) 1. Чтение «эстафетной палочки» (.agent/harness/_baton.md) для получения текущего состояния 2. Автоматическое выполнение в соответствии с конечным автоматом: START→ANALYZE→CONFIRM→DESIGN→IMPLEMENT→VERIFY→JUDGE (без необходимости пошаговых команд пользователя) 3. Каждый этап должен проверять выходные данные перед переходом к следующему этапу 4. Все выходные данные передаются через файлы, устные передачи запрещены 5. Пользователь должен подтвердить на этапе CONFIRM, прежде чем продолжить 6. Первая строка каждого ответа должна выводить «Текущее состояние: [имя состояния], следующий шаг: [действие]» 7. В конце каждого шага выполняется проверка цепочки валидации (проверка счетчиков/списков/файлов) для предотвращения ложного завершения **Что это производит**: - Отчет об анализе требований (_analysis.md) - Документ технического проектирования (_design.md) - Сводка реализации (_implementation.md) - Отчет о проверке (_verification.md) - Состояние «эстафетной палочки» (_baton.md) - **Отчет об аудите качества (_quality_audit_analysis.md / _quality_audit_design.md / _quality_audit_implement.md / _quality_audit_verify.md / _quality_audit_judge.md)**
машинный переводПоказать оригиналСкрыть оригинал«项目全生命周期管理引擎。用于系统化、流程化地执行软件工程任务。 **When to use**: - 用户说"帮我开发..."、"实现..…»
项目全生命周期管理引擎。用于系统化、流程化地执行软件工程任务。 **When to use**: - 用户说"帮我开发..."、"实现...功能"、"新增..."、"写个..." - 用户说"帮我分析..."、"审查..."、"看看这个设计..." - 用户说"出错了"、"报错了"、"修个Bug"、"修复..." - 用户说"帮我规划..."、"怎么做..."、"有什么方案" - 用户说"完善文档..."、"补充文档..."、"写文档..." - 用户说"重构..."、"优化架构..."、"技术债务..." - 用户说"测试..."、"写测试..."、"覆盖率..." - 用户输入 "/reqplan" 命令 - 任何涉及多步骤、需要设计-实现-验证的复杂任务 **When NOT to use**: - 单次简单问答(如"Python列表怎么排序"),不涉及多步骤任务规划 - 纯聊天对话,无具体任务目标(无开发/分析/修复意图) - 纯粹的信息查询(如"React 18 新增了什么"),不需要代码产出 - 用户仅要求查看/浏览代码,无需分析、修改或设计 - 需求极度模糊且用户拒绝澄清,无法确定具体任务边界 - 任务目标/范围已明确固定、只需单次代码修改、不涉及多阶段协作 **How it works**: 0. 确定项目路径(元任务走兜底规则,不以路径模糊为由跳过) 1. 读取接力棒(.agent/harness/_baton.md)获取当前状态 2. 按状态机自动执行:START→ANALYZE→CONFIRM→DESIGN→IMPLEMENT→VERIFY→JUDGE(无需用户逐一下令) 3. 每个阶段必须验证产物才能进入下一阶段 4. 所有产物通过文件传递,禁止口头传递 5. 用户必须在 CONFIRM 阶段确认后才能继续 6. 每步回复第一行必须输出"当前状态:[状态名],下一步:[操作]" 7. 每步结束执行验证链检查(计数验证/列表验证/文件验证),防止虚假完成 **What it produces**: - 需求分析报告(_analysis.md) - 技术设计文档(_design.md) - 实现摘要(_implementation.md) - 验证报告(_verification.md) - 接力棒状态(_baton.md) - **质量审核报告(_quality_audit_analysis.md / _quality_audit_design.md / _quality_audit_implement.md / _quality_audit_verify.md / _quality_audit_judge.md)**
Движок управления полным жизненным циклом проекта.
Как процесс C 57/100 · Есть пробелы — слабые места: результат и критерий готовности, когда включается, входы и предусловия
Как улучшить
- Сократите description до 1024 символов.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 0
✓ Критических и высоких находок нет
Просканировано файлов: 23. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- ошибка
description-longdescription 1145 символов, лимит 1024
Процессный рейтинг: все десять параметров 57/100
- 0Результат и критерий готовности. Не сказано, что считать результатом
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
- 20Когда включается. Не сказано, при каком запросе скилл включается
- 50Ошибки и развилки. Развилок: 0, есть раздел про ошибки
- 70Стоимость исполнения. Тело инструкции 4007 токенов
- 100Инструменты и файлы. Внешние инструменты не нужны
- 100Шаги. Шагов: 89
- 100Согласованность. Имя и обязательные поля на месте
- 100Повторный запуск. Изменяющих операций нет
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Длина description 1144: рекомендуется 120–800 символов
- +3Формат ответа не описан: модель каждый раз решает сама
- -5В тексте остались TODO / заглушки
- -239 эмодзи в инструкциях: шум для модели
- +2Инструкции на одном языке
- +5В description 17 примера фраз-триггеров в кавычках
- +4Структура: 44 заголовков
- +3Пошаговые инструкции: 89 пунктов
- +4Есть примеры (12 блоков кода)
- +4Справочные файлы упоминаются в инструкциях (3 из 3)
- +1Лицензия указана
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 59.