AgentSkillsCN

CII Project Documentation

为CII(智能物联网家居)项目的技术与架构文档查询提供结构化指引。

SKILL.md
--- frontmatter
name: CII Project Documentation
description: Orientação estruturada para consulta da documentação técnica e arquitetural do projeto CII (Casa Inteligente IoT).

Skill: Consultar Documentação CII

Esta skill orienta o agente a navegar de forma eficiente pela documentação do projeto CII, garantindo que as decisões técnicas estejam alinhadas com a Constituição do Projeto (V2.4).

📂 Ponto de Entrada

Sempre comece consultando o arquivo de índice principal:

🗺️ Estrutura de Pastas

PastaConteúdo PrincipalDocumentos Chave
01-principios/Filosofia e Regras de Negócioprincipios_sistema.md, system_roles_and_responsibilities.md
02-arquitetura/Infraestrutura e RedesINFRAESTRUTURA_BACKEND_BROKER.md, ota_strategy.md
03-protocolo/Contrato MQTT e Provisionamentomqtt_topics_V2.4.md, provisioning.md, acl_profiles.md
04-firmware/Hardware e ESP32hardware_map.md, firmware_architecture_esp32.md
05-app/Flutter e UI/UXarchitecture_flutterapp.md, app_ui_ux-espec.md

🛠️ Procedimento de Consulta

  1. Entenda o Contexto: Identifique se a tarefa é de Firmware, App, Protocolo ou Arquitetura.
  2. Localize o Documento: Utilize o README.md para encontrar o caminho absoluto do arquivo necessário.
  3. Valide com a Constituição: Antes de qualquer implementação, verifique se a proposta não viola as "Regras Inquebráveis" definidas na Regra Mestra do Projeto (V2.4).
  4. Links Relativos: Ao citar documentos em outros arquivos de documentação, prefira usar caminhos relativos ou links absolutos formatados com a estrutura de pastas atualizada.

⚠️ Regras Cruciais

  • NÃO invente tópicos MQTT. Consulte sempre o mqtt_topics_V2.4.md na pasta 03-protocolo.
  • NÃO ignore o Hardware Map. Consulte hardware_map.md em 04-firmware antes de sugerir mudanças de pinagem.
  • Siga o Clean Architecture no App Flutter, conforme detalhado em 05-app/architecture_flutterapp.md.