Añadida documentación para agentes IA y definición de skills#1911
Open
daniel89fg wants to merge 3 commits intoNeoRazorX:masterfrom
Open
Añadida documentación para agentes IA y definición de skills#1911daniel89fg wants to merge 3 commits intoNeoRazorX:masterfrom
daniel89fg wants to merge 3 commits intoNeoRazorX:masterfrom
Conversation
Se crean y estructuran archivos relevantes para los agentes de inteligencia artificial, incluyendo un marco de reglas en `AGENTS.md`, guías específicas en `ai/skills/`, y un índice en `skills.yaml`. Esto facilita la colaboración automatizada y estandariza el uso de herramientas como `Tools`, `Translator`, y extensiones vía hooks.
Contributor
There was a problem hiding this comment.
Pull request overview
This PR introduces a structured documentation framework aimed at helping AI agents (and contributors) navigate the FacturaScripts codebase, with a global rules file (AGENTS.md), task-specific “skills” under ai/skills/, and an index in ai/skills.yaml.
Changes:
- Adds project-wide AI agent context and architecture rules in
AGENTS.md. - Adds an AI documentation hub (
ai/README.md,ai/DEVELOPMENT.md) plus multiple skill guides inai/skills/. - Introduces
ai/skills.yamlas a catalog/index to discover skills.
Reviewed changes
Copilot reviewed 13 out of 13 changed files in this pull request and generated 15 comments.
Show a summary per file
| File | Description |
|---|---|
| AGENTS.md | Global AI-agent context, architecture rules, and pointers to AI docs |
| ai/README.md | Explains the purpose/structure of the ai/ docs and how to add skills |
| ai/DEVELOPMENT.md | Dev commands for install/tests/static analysis/style tools |
| ai/skills.yaml | Registry/index of available skills and when to use them |
| ai/skills/use-tools.md | Usage guidance for FacturaScripts\Core\Tools |
| ai/skills/use-translator.md | Usage guidance for Translator / i18n patterns |
| ai/skills/model-management.md | Model CRUD/query guidance with examples |
| ai/skills/table-definition.md | XML DB table definition guidance |
| ai/skills/xml-view-definition.md | XMLView forms/list definitions guidance |
| ai/skills/plugin-development.md | Plugin structure and extension patterns |
| ai/skills/extensions-and-hooks.md | Pipes/extensions + Twig hooks guidance |
| ai/skills/api-usage.md | REST API usage + custom endpoint guidance |
| ai/skills/use-http.md | HTTP client usage guidance (FacturaScripts\Core\Http) |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Se corrigen errores tipográficos en el uso de métodos (e.g., `Tools::settingsSave()`), se ajustan ejemplos para reflejar mejores prácticas (e.g., sustitución de instancias por métodos estáticos como `Http::get()`), y se unifican los métodos en las definiciones XML. Esto mejora la consistencia y evita confusiones al usar la documentación.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Se crean y estructuran archivos relevantes para los agentes de inteligencia artificial, incluyendo un marco de reglas en
AGENTS.md, guías específicas enai/skills/, y un índice enskills.yaml. Esto facilita la colaboración automatizada y estandariza el uso de herramientas comoTools,Translator, y extensiones vía hooks.Esto ayudará a los agentes como Claude, Codex, Junie, Gemini, etc a saber interpretar mejor el código y no alucinar tanto, ademas, ayuda a los modelos a no tener que leer toda la estructura del proyecto o plugin para dar una solución, reduciendo el tiempo de respuesta y el consumo de tokens.