Funzen/ai-project-template
Watch
3
0
Fork
You've already forked ai-project-template
 0
Code Issues Pull requests Projects Releases 5 Packages Wiki Activity Actions
5 releases 6 tags
  • v2.0 386f0090a3

    v2.0 Stable

    a.kerp released this 2026-07-05 18:59:03 +03:00 | 1 commits to master since this release

    Update Notes v2.0

    Переезд инструкций в .opencode/ — нативный OpenCode-конфиг

    • Новая корневая структура конфигурации агента:
      • .opencode/opencode.json — настройки клиента OpenCode: formatter, lsp, instructions, mcp, provider (MiniMax-M3 / M2.7 / M2.7-highspeed)
      • .opencode/agents/ — суб-агенты и режимы: backend-developer, quality-assurance, tech-writer, unity-developer, rnd
      • .opencode/skills/ — навыки (Backend / Unity / Dev / Ops / Plan / Docs)
      • .opencode/plans/ — рабочая область (бывшая PROJECT.Agent/Specs/)
      • .opencode/README.md — единая точка входа: примеры flow, subagents vs modes, best practices
    • AGENTS.md обновлён: пути → .opencode/plans, Agent Config, Git/Log Conventions; добавлены правила.
    • Добавлен PROJECT.Unity/AGENTS.md — Unity-специфичные инструкции: проверка активной MCP-инстанции через mcpforunity://instances перед любым вызовом (важно для worktree)

    AgentAdapter — Installer переехал в PROJECT.Tools/

    • PROJECT.Agent/Installer/ → PROJECT.Tools/AgentAdapter/ — теперь это «внешний инструмент», а не часть конфига агента
    • Суть та же: создаёт symlinks из .opencode/{agents,skills} и AGENTS.md → сторонние клиенты (ClaudeCode, KiloCode, Cursor, Windsurf, Trae, QwenCode и др.)

    Существенные правки в навыках

    • Ops/create-skill
    • Dev/review-code
    • Docs/create-tech-doc

    DevOps / GitLab CI/CD — крупное обновление AI Review

    • PROJECT.Devops/scripts/ — три новых bash-скрипта:
      • fetch-mr-context.sh — собирает чистый контекст discussions (без system-шума, с resolve-статусом) в mr-context.txt
      • ci-helpers.sh — функция find_managed_discussion (поиск по маркеру)
      • publish-review.sh — публикация через Discussions (POST/PUT /discussions/:id/notes/:note_id), а не Notes; при not_ready разрезолвливает discussion; resolve — только от пользователя; validate_review требует <!-- mr-verdict:ready|not_ready -->, иначе refuse-to-publish
    • ai:review job полностью переписан:
      • Использует прямой Docker-образ ghcr.io/anomalyco/opencode:1.16.2 (без GitLab-компонента nagyv/gitlab-opencode)
      • Достаёт jq, glab, git через apk add внутри контейнера
      • Конфиг генерируется из .opencode/opencode.json с удалённым .mcp (uvx ненадёжен в CI); auth.json копируется в $HOME/.local/share/opencode/
      • Агент запускается opencode run --agent build, ответ пишется write-инструментом в mr-agent-review.out (stdout — только фолбэк)
      • Skip на чистом rebase только если прошлое ревью валидно (содержит verdict-маркер); иначе — пере-ревью
      • Артефакты: mr-agent-review.out, mr-context.txt, stdout.log, opencode-stderr.log
    • README.md и review-gitlab-mr.md переписаны под новую схему Discussion + скрипты

    ai_init_workflow.md — переписан

    • Workflow адаптации под проект теперь работает с .opencode/ и AgentAdapter
    • Прямой вызов клиента OpenCode после замен — AgentAdapter опционален только для сторонних AI
    Downloads
  • v1.4 0faf010e56

    v1.4 Stable

    a.kerp released this 2026-07-05 18:38:02 +03:00 | 6 commits to master since this release

    Update Notes v1.4

    DevOps / GitLab CI/CD — улучшения

    • Добавлен PROJECT.Devops/README.md — настройка GitLab Variables, Runner, путь CI
    • Пропуск пустого diff через workflow.rules — MR без изменений не создаёт pipeline
    • Пропуск чистого rebase — before_script сравнивает patch-id diff'а с сохранённым в managed-комментарии; новый patch-id пишется через after_script
    • Модель OpenCode обновлена: MiniMax-M2.7 → MiniMax-M3
    • review-gitlab-mr.md: добавлено распознавание wont fix; "unresolved ≠ проблема остаётся" — проверять фикс и включать только реально требующие исправления замечания

    Installer — мульти-клиент и TUI

    • Добавлены модули: core/dependencies.py (авто-установка pip), core/detector.py (детект клиентов), ui/tui.py (TUI на prompt_toolkit)
    • CLI: --client name1 name2 … и --client auto — установка сразу в несколько клиентов или авто-обнаружение существующих
    • Удалён ui/interactive.py, заменён на TUI со чекбоксами и преселектом обнаруженных клиентов

    Skills — реструктуризация и новые навыки

    • Новые категории: Backend/, Unity/, Plan/, Docs/
    • Новые Skills:
      • Dev/debug-code — систематический дебаг (Investigate → Reproduce → Fix), Iron Rule «нет фикса без root cause»
      • Plan/research — единый research багов и задач (автоопределение типа по ключевым словам)
      • Plan/rnd — вынесен из Modes/rnd.md
      • Plan/build-plan — формализован финальный pipeline: Refactor → (Tests ∥ Docs) → Review
      • Docs/update-tech-doc — обновление существующих тех-документов
    • Переименования / перенос:
      • Project/run-backend-tests → Backend/run-backend-tests
      • Project/run-unity-tests → Unity/run-unity-tests
      • Dev/create-adr, Dev/create-tech-doc → Docs/...
      • Workflow/{execute-plan, explore} → Plan/{execute-plan, explore}
    • Удалены: Workflow/build-plan, Workflow/research-bug, Workflow/research-task (объединены в research)
    • Ops/create-skill: подпапки workflow/, templates/, examples/; паттерны $ARGUMENTS; требование clarifying questions
    • Dev/refactor-code: раздел «Collection Types and Contracts» — narrow input / wide output, ToArray() > ToList()

    Subagents

    • tech-writer: добавлен update-tech-doc

    Conventions и инструкции

    • code-conventions.md: bool-префикс Should; новый раздел Collection types; уровни логов — handled (W/E) vs unhandled (Ex); backticks только для строковых параметров
    Downloads
  • v1.3 75e81d491e

    v1.3 Stable

    a.kerp released this 2026-04-20 05:07:44 +03:00 | 11 commits to master since this release

    Update Notes v1.3

    Новый функционал: DevOps / GitLab CI/CD

    • Добавлена папка PROJECT.Devops/
    • .gitlab-ci.yml — автоматический MR review через OpenCode AI Agent
    • review-gitlab-mr.md — инструкция для проведения ревью в GitLab MR
    • CI/CD Pipeline публикует результаты ревью как комментарий к MR с эмодзи-вердиктом

    Новый Mode: rnd (замена specifier)

    • specifier.md удалён, заменён на rnd.md
    • Улучшенный процесс: исследование → уточнение → спецификация → план
    • Добавлена Mermaid-диаграмма рабочего процесса
    • Более чёткие ограничения и формат вывода

    Новый Skill: add-doc-links

    • Добавлен в Skills/Dev/
    • Добавляет <seealso href> ссылки в C# код из документации и наоборот
    • Поддерживает два направления: Docs→Code и Code→Docs
    • Confidence-based подход: High (>70%) добавляется автоматически, Medium (30-70%) — с подтверждением пользователя

    Рефакторинг Workflow Skills

    • rnd-bug → research-bug
    • rnd-task → research-task
    • Обновлены ссылки в README и subagents

    Рефакторинг review-code

    • Удалены Python-скрипты get-review-files.py и get-review-commits.py — переписано на чистые bash-команды
    • Улучшена структура: чёткое разделение Gathering → Review → Output
    • Добавлены проверки: YAGNI, over-engineering, архитектурные слои
    • Улучшен output template с русским языком и emoji- severity

    Обновления AGENTS.md

    • Добавлена строка PROJECT.Devops/ в таблицу директорий
    • Добавлен KISS-принцип в Guidelines
    • Реструктуризированы пункты: review-code и refactor-code вынесены в отдельные строки

    Обновления Conventions

    • Добавлен Conventions/README.md с оглавлением
    • Исправлено именование: non-public non-readonly static вместо non-public static

    Обновления ai_init_workflow

    • Уточнено описание типичных мест для поиска
    • Улучшен вопрос о бэкенде ("или отсутствует")
    • Расширен чек-лист тех. паспорта (Unity Editor, MCP, Render Pipeline, и т.д.)
    • Файл не найден → "Не определена" + вопрос пользователю
    Downloads
  • v1.2 943b3069f6

    v1.2 Stable

    a.kerp released this 2026-04-20 04:53:48 +03:00 | 12 commits to master since this release

    Update Notes v1.2

    Новый функционал: Modes (Режимы работы)

    • Добавлена папка PROJECT.Agent/Modes/ с README
    • Режим specifier — уточнение требований и создание спецификаций
    • Режимы вызываются вручную через Tab в OpenCode (Primary Agents)
    • Installer теперь поддерживает Modes — добален параметр --modes и автоматическое создание symlinks в папку Subagents

    Улучшения Installer

    • Унифицирована логика symlink-операций — subagents, modes и skills используют общий алгоритм
    • Структура больше не уплощается — сохраняется иерархия папок
    • Добавлена валидация путей при запуске с ошибкой при отсутствии исходных папок
    • Оптимизированы интерактивный режим и CLI-взаимодействие
    • Добавлен тест для новой логики symlink-операций

    Рефакторинг Skills

    • Удалены устаревшие skills:
      • implement-data-processor
      • manage-backend
      • version-up
    • run-unity-tests — обновлён для использования вместо жёстко заданного unityMCP
    • Исправлены опечатки в README Skills

    Улучшения ai_init_workflow

    • Шаг 3 — добавлена проверка подключённых MCP и автоопределение Unity MCP
    • Вопрос о MCP добавлен в опросник (Шаг 4)
    • Обновлены все шаги и чек-лист с учётом нового шага
    • Добавлено поле Unity Editor MCP в tech-pasport.md

    Исправления

    • Исправлена опечатка Точнр → Точно в ai_init_workflow.md
    • Исправлена битая ссылка [Installer без закрывающей скобки в PROJECT.Agent/README.md
    • Удалены маркеры из run-unity-tests (DI и Framework теперь заполнены)
    Downloads
  • v1.1 d9e3100927

    v1.1 Stable

    a.kerp released this 2026-04-20 04:42:26 +03:00 | 16 commits to master since this release

    Update Notes v1.1

    Ребрендинг Exporter → Installer

    • Директория Exporter переименована в Installer
    • Обновлены все ссылки и документация
    • Переименован skill run-ai-exporter → install-ai-config

    Улучшения workflow инициализации

    • Добавлен Шаг 6 — настройка .gitignore для AI-директорий
    • Добавлен Шаг 7 — удаление ai_init_workflow.md после завершения
    • Добавлено автоматическое определение версии Unity из ProjectVersion.txt
    • Инструкции по использованию обновлены с учётом новых шагов

    Исправления

    • Маркеры заменены на в файлах конвенций (code-conventions.md, git-conventions.md, project-conventions.md, ui-conventions.md)
    • Исправлена ошибка с некорректной ссылкой в PROJECT.Agent/README.md (отсутствовала закрывающая скобка)
    • Удалён лишний BOM в файле SKILL.md
    • Мелкие исправления в README и примерах сообщений
    Downloads