auto-sync: 2026-04-18 16:00:01
This commit is contained in:
@@ -1,41 +1,66 @@
|
||||
# Tasks & Scripts
|
||||
# Tasks
|
||||
|
||||
Папка для хранения скриптов и отчётов, создаваемых в процессе выполнения задач.
|
||||
**Временные файлы** хранятся в `../temp/` и удаляются после использования.
|
||||
Корневая папка для всех проектных материалов OpenClaw.
|
||||
|
||||
## Структура
|
||||
Здесь живут:
|
||||
- `tasks/<project>/` — отдельный проект
|
||||
- `tasks/README.md` — общий стандарт для структуры проектов и задач
|
||||
|
||||
### `scripts/`
|
||||
Вспомогательные Python/bash-скрипты для анализа данных, генерации отчётов, одноразовых задач.
|
||||
## Базовый стандарт проекта
|
||||
|
||||
**Примеры:**
|
||||
- `token_summary.py` — анализ использования токенов из логов сессий
|
||||
- `usage_summary.py` — сводка по использованию моделей через OpenRouter
|
||||
- Любые другие утилиты, создаваемые по запросу
|
||||
```text
|
||||
tasks/<project-slug>/
|
||||
├── PROJECT.md
|
||||
├── docs/
|
||||
├── journal/
|
||||
├── assets/
|
||||
├── meta/
|
||||
└── TASKS/
|
||||
├── backlog/
|
||||
├── active/
|
||||
├── blocked/
|
||||
├── done/
|
||||
└── archive/
|
||||
```
|
||||
|
||||
### `reports/`
|
||||
Готовые отчёты, результаты анализа, экспортированные данные.
|
||||
## Базовый стандарт задачи
|
||||
|
||||
**Примеры:**
|
||||
- CSV/JSON с результатами анализа
|
||||
- Логи проверок
|
||||
- Временные дампы данных
|
||||
```text
|
||||
tasks/<project-slug>/TASKS/<status>/<task-slug>/
|
||||
├── TASK.md
|
||||
├── context.md
|
||||
├── report.md
|
||||
└── attachments/
|
||||
```
|
||||
|
||||
## Правила
|
||||
|
||||
1. **Не хранить секреты** — API-ключи, пароли, приватные данные
|
||||
2. **Чистить старые файлы** — удалять временные файлы после использования
|
||||
3. **Документировать** — добавлять комментарии в скрипты, описывать назначение
|
||||
4. **Сохранять структуру** — новые категории создавать как подпапки
|
||||
5. **Перенос в skills** — при необходимости оформления скрипта в skill (AgentSkill) переносить по команде в папку `../skills/` с полной документацией
|
||||
1. **Task без Project не существует**
|
||||
2. У каждого проекта есть `folder` и `doc_path`
|
||||
3. У каждой задачи есть `project`, `folder` и `doc_path`
|
||||
4. Имена папок и документов — читаемые slug-и, без внутренних кодов
|
||||
5. Внутренние `id` используются только в онтологии
|
||||
6. Временные файлы — вне `tasks/`, в `temp/`
|
||||
7. Секреты, ключи и пароли здесь не храним
|
||||
|
||||
## Связь с памятью
|
||||
## Документация
|
||||
|
||||
Значимые результаты анализа или выводы фиксируются в:
|
||||
- `memory/YYYY-MM-DD.md` — дневная память
|
||||
- `MEMORY.md` — долгосрочная память (только в главной сессии)
|
||||
- `tasks/<project>/PROJECT.md` — главная документация проекта
|
||||
- `tasks/<project>/TASKS/.../TASK.md` — постановка задачи
|
||||
- `tasks/<project>/TASKS/.../report.md` — итог выполнения
|
||||
|
||||
## Связь с онтологией
|
||||
|
||||
Проекты и задачи должны быть отражены в:
|
||||
- `memory/ontology/schema.yaml`
|
||||
- `memory/ontology/graph.jsonl`
|
||||
- `memory/ontology/RULES.md`
|
||||
|
||||
## Старые скрипты и отчёты
|
||||
|
||||
Исторические служебные файлы можно хранить в подпапках проекта, но не смешивать их с основным стандартом проектов и задач.
|
||||
|
||||
---
|
||||
|
||||
**Создано:** 2026-03-22
|
||||
**Цель:** Организовать workspace, отделить скрипты/отчёты от конфигурационных файлов и памяти.
|
||||
**Обновлено:** 2026-04-18
|
||||
**Цель:** Стандартная структура проектов и задач для OpenClaw.
|
||||
|
||||
Reference in New Issue
Block a user