AgentSkillsCN

artifact-management

本地.AGENTS.md文件及全局性资产(TASK.md、ARCHITECTURE.md)的管理规则。

SKILL.md
--- frontmatter
name: artifact-management
description: Правила управления локальными .AGENTS.md и глобальными артефактами (TASK.md, ARCHITECTURE.md).
version: 1.0

Управление Артефактами (Artifact Management)

Локальные .AGENTS.md (В каждой директории)

  • Цель: Распределенная долгосрочная память для конкретных директорий.
  • Расположение: В каждой директории с исходным кодом (например, src/services/.AGENTS.md).
  • Единственный Писатель: ТОЛЬКО агент Developer (Разработчик) имеет право создавать или обновлять эти файлы. Все остальные агенты (Аналитик, Ревьюер и т.д.) должны только ЧИТАТЬ их.
  • Формат:
    markdown
    # Directory: src/services/
    
    ## Purpose
    [Краткое описание назначения директории]
    
    ## Files
    
    ### [filename.py]
    **Classes/Functions:**
    - `[ClassName]` — [Описание]
      - `[method_name]` — [Описание]
    

Глобальные Артефакты

  • TASK.md: Техническое Задание. Управляется Аналитиком.
  • ARCHITECTURE.md: Архитектура системы. Управляется Архитектором.
  • PLAN.md: План разработки. Управляется Планировщиком (Planner).

Протокол

  1. Сначала Читать: Перед началом работы прочитайте соответствующие артефакты.
  2. Обновлять Немедленно: Обновляйте артефакты, соответствующие вашим изменениям (Разработчик обновляет .AGENTS.md, Аналитик обновляет TASK.md).
  3. Согласованность: Убедитесь, что артефакты соответствуют фактическому состоянию кода.