agents skills
This commit is contained in:
146
docs/axiom-mcp-tools-report.md
Normal file
146
docs/axiom-mcp-tools-report.md
Normal file
@@ -0,0 +1,146 @@
|
||||
#region AxiomMCPToolsReport [C:1] [TYPE Module] [SEMANTICS axiom,mcp,tools,inventory,report]
|
||||
@BRIEF Полный реестр 15 AXIOM MCP tools, доступных в проекте ss-tools, с описанием, назначением и ключевыми параметрами.
|
||||
@RATIONALE Отчёт создан для фиксации текущего состояния инструментальной базы AXIOM. Позволяет быстро ориентироваться в доступных инструментах без повторного сканирования.
|
||||
@DATA_CONTRACT Inventory -> { tool_name: str, purpose: str, key_operations: str[], workspace_required: bool }
|
||||
|
||||
## Отчёт: AXIOM MCP Tools — ss-tools
|
||||
|
||||
**Дата:** 2026-05-25
|
||||
**Индекс:** DuckDB (2543 контракта, 1987 связей)
|
||||
**Всего инструментов:** 15
|
||||
|
||||
---
|
||||
|
||||
### 1. `axiom_contract_metadata`
|
||||
- **Назначение:** Заголовочные метаданные + редактирование @RELATION рёбер.
|
||||
- **Ключевые операции:** `update_metadata`, `update_metadata_batch`, `rename_tag`, `prune_metadata`, `add_relation_edge`, `remove_relation_edge`, `rename_relation_predicate`, `update_relation_batch`, `upgrade_complexity_for_scope`.
|
||||
- **Требует workspace:** да.
|
||||
|
||||
---
|
||||
|
||||
### 2. `axiom_contract_patch`
|
||||
- **Назначение:** Патчинг контрактов с preview, belief-протокол инструментация.
|
||||
- **Ключевые операции:** `simulate`, `guarded_preview`, `guarded_apply`, `apply`, `belief_protocol_preview/apply`, `belief_protocol_apply_batch`.
|
||||
- **Требует workspace:** да.
|
||||
- **Примечание:** Не использовать для редактирования @RELATION рёбер — для этого есть `contract_metadata`.
|
||||
|
||||
---
|
||||
|
||||
### 3. `axiom_contract_refactor`
|
||||
- **Назначение:** Переименование, перемещение, извлечение, обёртка контрактов; вывод missing @RELATION.
|
||||
- **Ключевые операции:** `rename_contract_id`, `move_contract`, `extract_contract`, `wrap_node`, `infer_missing_relations_preview/apply`, `change_contract_type`, `infer_missing_relations_for_scope_preview/apply`, `migrate_def_to_region`.
|
||||
- **Требует workspace:** да.
|
||||
|
||||
---
|
||||
|
||||
### 4. `axiom_runtime_evidence`
|
||||
- **Назначение:** Маппинг runtime-трейсов на контракты + чтение структурированных событий.
|
||||
- **Ключевые операции:** `map_trace_to_contracts`, `read_events`.
|
||||
- **Требует workspace:** да.
|
||||
|
||||
---
|
||||
|
||||
### 5. `axiom_security_workflow`
|
||||
- **Назначение:** Сканирование уязвимостей + подготовка handoff'ов для security-ревью.
|
||||
- **Ключевые операции:** `scan`, `prepare_handoff`.
|
||||
- **Требует workspace:** да.
|
||||
|
||||
---
|
||||
|
||||
### 6. `axiom_semantic_context`
|
||||
- **Назначение:** Локальный граф (neighbourhood), task-пакеты, health воркспейса, гибридные запросы.
|
||||
- **Ключевые операции:** `local_context`, `task_context`, `workspace_health`, `hybrid_query`.
|
||||
- **Режимы `hybrid_query`:** `semantic_neighborhood`, `blast_radius`, `dependency_path`, `dead_code_islands`, `cycle_detection`, `runtime_federation`.
|
||||
- **Требует workspace:** да.
|
||||
|
||||
---
|
||||
|
||||
### 7. `axiom_semantic_discovery`
|
||||
- **Назначение:** Поиск контрактов, AST-поиск, read_outline, описание тегов.
|
||||
- **Ключевые операции:** `search_contracts`, `ast_search`, `read_outline`, `describe_tags`.
|
||||
- **Особенности:** Fuzzy-поиск через DuckDB (Levenshtein distance) при `fuzzy=true`.
|
||||
- **Требует workspace:** да (кроме `describe_tags`).
|
||||
|
||||
---
|
||||
|
||||
### 8. `axiom_semantic_index`
|
||||
- **Назначение:** Переиндексация (in-memory), пересборка (DuckDB), статус индекса.
|
||||
- **Ключевые операции:** `reindex`, `rebuild`, `status`.
|
||||
- **Режимы:** `incremental` / `full`, с опцией DuckDB и refresh embeddings.
|
||||
- **Требует workspace:** да.
|
||||
|
||||
---
|
||||
|
||||
### 9. `axiom_semantic_validation`
|
||||
- **Назначение:** Аудит контрактов, belief-протокола, runtime, diff, impact-анализ.
|
||||
- **Ключевые операции:** `audit_contracts`, `audit_belief_protocol`, `audit_belief_runtime`, `diff_contract_semantics`, `impact_analysis`.
|
||||
- **Фильтры:** `file_path`, `filter_mode` (prefix/contains/exact), `limit`/`offset`.
|
||||
- **Требует workspace:** да.
|
||||
|
||||
---
|
||||
|
||||
### 10. `axiom_testing_support`
|
||||
- **Назначение:** Поиск связанных тестов + генерация scaffold-тестов из метаданных контракта.
|
||||
- **Ключевые операции:** `trace_related_tests`, `scaffold_tests`.
|
||||
- **Требует workspace:** да.
|
||||
|
||||
---
|
||||
|
||||
### 11. `axiom_workspace_artifact`
|
||||
- **Назначение:** Создание/патч/удаление файлов, генерация docs, scaffold-модулей.
|
||||
- **Ключевые операции:** `create_file`, `patch_file`, `delete_file`, `scaffold_module`, `scaffold_docs`, `generate_docs`.
|
||||
- **Режимы target:** `exact_text`, `regex`, `whole_file`.
|
||||
- **Требует workspace:** да.
|
||||
|
||||
---
|
||||
|
||||
### 12. `axiom_workspace_checkpoint`
|
||||
- **Назначение:** Чекпоинты — суммари, diff, rollback preview/apply.
|
||||
- **Ключевые операции:** `summarize`, `diff`, `rollback_preview`, `rollback_apply`.
|
||||
- **Требует workspace:** да.
|
||||
|
||||
---
|
||||
|
||||
### 13. `axiom_workspace_command`
|
||||
- **Назначение:** Выполнение shell-команд + метрики сервера.
|
||||
- **Ключевые операции:** `run`, `server_metrics`.
|
||||
- **Требует workspace:** да (кроме `server_metrics`).
|
||||
|
||||
---
|
||||
|
||||
### 14. `axiom_workspace_path`
|
||||
- **Назначение:** Операции с файловой системой (mkdir, move, rename, delete, inspect).
|
||||
- **Ключевые операции:** `mkdir`, `move`, `rename`, `delete`, `inspect`.
|
||||
- **Требует workspace:** да.
|
||||
|
||||
---
|
||||
|
||||
### 15. `axiom_workspace_policy`
|
||||
- **Назначение:** Разрешение политик, защищённых путей, рабочих директорий.
|
||||
- **Требует workspace:** да.
|
||||
|
||||
---
|
||||
|
||||
## Сводная таблица
|
||||
|
||||
| # | Инструмент | Категория | Preview | Checkpoint | DuckDB |
|
||||
|---|-----------|-----------|---------|------------|--------|
|
||||
| 1 | `axiom_contract_metadata` | Метаданные | да | да | да |
|
||||
| 2 | `axiom_contract_patch` | Патчинг | да | да | да |
|
||||
| 3 | `axiom_contract_refactor` | Рефакторинг | да | да | да |
|
||||
| 4 | `axiom_runtime_evidence` | Runtime | нет | нет | да |
|
||||
| 5 | `axiom_security_workflow` | Безопасность | нет | нет | да |
|
||||
| 6 | `axiom_semantic_context` | Контекст | нет | нет | да |
|
||||
| 7 | `axiom_semantic_discovery` | Поиск | нет | нет | да |
|
||||
| 8 | `axiom_semantic_index` | Индекс | нет | нет | да |
|
||||
| 9 | `axiom_semantic_validation` | Валидация | нет | нет | да |
|
||||
| 10 | `axiom_testing_support` | Тестирование | нет | нет | да |
|
||||
| 11 | `axiom_workspace_artifact` | Файлы | да | нет | да |
|
||||
| 12 | `axiom_workspace_checkpoint` | Чекпоинты | да | да | да |
|
||||
| 13 | `axiom_workspace_command` | Команды | нет | нет | да |
|
||||
| 14 | `axiom_workspace_path` | FS | да | нет | да |
|
||||
| 15 | `axiom_workspace_policy` | Политики | нет | нет | да |
|
||||
|
||||
**Итого:** 15 инструментов, все интегрированы с DuckDB-индексом. 6 инструментов поддерживают preview-режим. 4 поддерживают checkpoint-механизм.
|
||||
|
||||
#endregion AxiomMCPToolsReport
|
||||
Reference in New Issue
Block a user