nirvana context engineering
Squad de engenharia de contexto para agentes de IA: elicitação de requisitos, análise do projeto, design de arquitetura de contexto, geração de artefatos (CLAUDE.md, AGENTS.md, rules, configs de memória) e otimização com validação de qualidade. Pipeline de 5 fases que aplica as 5 abordagens de context engineering (RAG, ACE, Hierarchical Layering, GCC, Structured Files).
🧠 Context Engineering Squad
Context Engineering Squad 是一个专为 AIOS 设计的专业智能体团队,负责为 AI 辅助开发设计、生成和优化上下文架构。该团队将上下文工程从手动工作转变为系统化、可重复的流程。
📋 目录
概述
Context Engineering Squad 通过结构化的五阶段流水线解决 AI 辅助开发中最关键的挑战:如何为 AI 智能体提供正确的上下文。
该团队:
- 通过访谈收集项目需求和上下文目标
- 扫描现有代码库以提取相关上下文
- 设计分层上下文架构
- 生成
CLAUDE.md、、.claude/rules/
AGENTS.md等产物 - 持续优化上下文以保持质量和相关性
安装
npx squads add gutomec/squads-sh/nirvana-context-engineering系统要求: Squad Protocol v5
流水线
该团队遵循线性流水线,每个阶段都有明确的输入和输出:
五个阶段:
- 需求收集 — 访谈者通过结构化访谈理解项目目标
- 项目扫描 — 扫描器分析代码库、依赖关系和现有模式
- 架构设计 — 架构师设计分层上下文结构
- 产物生成 — 生成器创建所有上下文文件
- 上下文优化 — 优化器精炼并验证产物质量
智能体
| 智能体 ID | 角色 | 类型 | 职责 |
|---|---|---|---|
interviewer | 🎯 访谈者 | Guardian | 通过结构化访谈收集上下文需求;确保完整性和清晰度 |
scanner | 🔬 扫描器 | Guardian | 分析项目结构、代码模式、依赖关系和现有上下文 |
architect | 🏗️ 架构师 | Builder | 设计上下文层次结构和文件组织策略 |
generator | ⚡ 生成器 | Builder | 生成所有上下文产物:CLAUDE.md、规则文件、AGENTS.md |
optimizer | 🔧 优化器 | Balancer | 验证质量、识别冗余并优化令牌使用效率 |
任务
| 任务 ID | 描述 | 执行者 |
|---|---|---|
gatherRequirements() | 通过访谈收集项目上下文需求 | 访谈者 |
scanProject() | 扫描代码库并提取相关上下文信号 | 扫描器 |
designContextArchitecture() | 设计分层上下文架构方案 | 架构师 |
generateContextArtifacts() | 生成所有上下文文件和配置 | 生成器 |
optimizeContext() | 优化令牌使用并提升上下文质量 | 优化器 |
validateContextQuality() | 验证产物的完整性和有效性 | 优化器 |
工作流
context_engineering_pipeline(五阶段主流水线)
完整的端到端上下文工程工作流。从原始需求开始,经过所有五个阶段,输出完整的上下文架构。
触发条件: 新项目初始化或重大架构变更
阶段顺序:
gatherRequirements → scanProject → designContextArchitecture
→ generateContextArtifacts → optimizeContext
context_optimization_cycle(迭代优化循环)
针对已有上下文的持续改进工作流。周期性运行以确保上下文与项目演进保持同步。
触发条件: 定期维护或检测到上下文漂移时
循环:
scanProject → optimizeContext → validateContextQuality → [重复]
五种方法
该团队支持五种经过验证的上下文工程方法:
| 方法 | 缩写 | 描述 |
|---|---|---|
| 检索增强生成 | RAG | 动态检索相关上下文片段并注入提示词 |
| 智能体上下文工程 | ACE | 为智能体自主工作流设计专用上下文层 |
| 分层上下文 | Hierarchical Layering | 将上下文组织为全局、项目、智能体、任务四层结构 |
| Git 上下文控制器 | GCC | 使用 Git 历史和变更追踪维护上下文时效性 |
| 结构化文件 | Structured Files | 通过规范化的文件格式和命名约定管理上下文 |
2026 最佳实践
| 实践 | 类别 | 影响 |
|---|---|---|
| 分层上下文加载(按需) | 性能 | 减少 60% 令牌使用 |
| 每层单一职责 | 架构 | 提升可维护性 |
| 版本控制所有上下文文件 | 可追溯性 | 启用变更审计 |
| 通过 GCC 自动更新上下文 | 自动化 | 防止上下文漂移 |
| 定期质量验证循环 | 质量保障 | 确保持续相关性 |
| 使用 ACE 支持多智能体协调 | 可扩展性 | 优化团队协作 |
生成的产物
运行完整流水线后,该团队生成以下文件:
项目根目录/ ├── CLAUDE.md # 主上下文配置文件 ├── AGENTS.md # 智能体角色和职责定义 ├── .claude/ │ ├── rules/ # 上下文规则文件集合 │ │ ├── workflow-execution.md │ │ ├── agent-authority.md │ │ └── [其他规则文件] │ └── settings.json # Claude Code 配置 └── (runtime dir)/ └── memory/ # 智能体记忆配置 └── context-config.yaml
使用方法
安装后,使用斜杠前缀 ce 调用该团队的命令:
# 启动完整上下文工程流水线
/ce:pipeline
# 仅收集需求
/ce:gather
# 扫描现有项目
/ce:scan
# 生成上下文产物
/ce:generate
# 运行优化循环
/ce:optimize
# 验证上下文质量
/ce:validate
# 查看帮助
/ce:help与 AIOS 智能体集成:
# 使用访谈者智能体
@ce-interviewer *start
# 使用架构师智能体
@ce-architect *design
# 使用优化器智能体
@ce-optimizer *run贡献
欢迎贡献!请遵循以下步骤:
- Fork 本仓库
- 创建功能分支:
git checkout -b feature/your-feature
- 提交变更:
git commit -m 'feat: add your feature' - 推送分支:
git push origin feature/your-feature
- 提交 Pull Request
请确保所有变更符合 AIOS Constitution 原则,特别是 Article IV(禁止发明)和 Article V(质量优先)。
许可证
本项目采用 MIT 许可证。
由 Luiz Gustavo Vieira Rodrigues (@gutomec) 开发 Context Engineering Squad v1.0.0 — Squad Protocol v5
评价
0 条评价暂无评价。来做第一个评价者吧!
更多来自 Luiz Rodrigues
squad forge
Squad meta de desenvolvimento, otimização e evolução de squads agênticos — cria, valida, otimiza e moderniza qualquer artefato de squad (agentes, tasks, workflows, skills, squads inteiros, templates) com perfeição de formato, e mantém a própria base de conhecimento atualizada via pesquisa web.
ultimate landingpage
Squad fullstack para criação de landing pages de ultra-alta conversão — pipeline end-to-end com 9 agentes: discovery de produto, pesquisa de mercado e experts de copywriting, design system atômico com contraste WCAG AAA e light/dark, geração de imagens por IA, frontend Next.js com SEO e acessibilidade, backend Python FastAPI com admin panel e exportação CSV, integrações WhatsApp e email, e QA multidimensional com score por dimensão
data quality guardian
Squad especialista em qualidade de dados — profiling de datasets, detecção de anomalias, validação de schemas, geração de relatórios de qualidade e sugestão de remediações automatizadas para pipelines de dados
incident response squad
Squad especialista em resposta a incidentes para DevOps/SRE — análise de logs multi-source, correlação de causa raiz, execução de runbooks de remediação, comunicação de status e geração de post-mortems blameless
brandcraft
Squad de produção de entregáveis visuais brand-consistent: extrai design systems de URLs (Refero + live extraction), gera PDFs, PPTX, posts sociais, carrosséis e vídeos programáticos por dois caminhos (Veo 3.1 + Remotion para footage de IA; HyperFrames HTML-first determinístico para motion-design, data-viz e explainer), faz auditoria competitiva de marca, aplica um quality gate awwwards de 24 itens e um arsenal de 112 bibliotecas de UI nos HTMLs/PDFs/animações, e valida acessibilidade WCAG 2.2 AA. Pipeline com 16 agentes especializados e 16 workflows.
nirvana squad creator
Gera squads v5-compliant a partir de linguagem natural — pipeline de 11 fases começando com intent archaeology + pesquisa web (2026), depois análise grounded, geração, otimização, validação, README multi-idioma, deploy e publicação no squads.sh
notebooklm automation
Automação programática completa do Google NotebookLM — da criação de notebooks e curadoria de fontes à pesquisa por Q&A progressivo e geração de 10 formatos de conteúdo (podcast, vídeo, slides, quiz, flashcards, infográfico, mapa mental, tabela de dados, relatório), com download de artefatos orquestrado por pipeline inteligente. Suporta 50+ idiomas e error handling cross-cutting (retry, re-auth, fallback de cota).
nirvana readme architect
Squad de geração de README.md perfeito e impecável, combinando análise profunda de codebase, seleção de template por tipo de projeto, todas as features do GitHub Flavored Markdown, validação com checklist de 25+ pontos e polimento final com badges e TOC.
soc alert triage
Squad especialista em triagem de alertas SOC para cybersecurity — classificação automatizada, filtragem de falsos positivos, priorização de ameaças, enriquecimento com threat intel e geração de briefs para analistas
adaptive tutor k12
Squad especialista em tutoria adaptativa K-12 — avaliação diagnóstica, mapeamento curricular personalizado, sessões de tutoria com dificuldade adaptativa, rastreamento de progresso e relatórios para pais e educadores
resume screener squad
Squad especialista em triagem de currículos para recrutamento — parsing automatizado de CVs, matching de skills com requisitos da vaga, auditoria de vieses, ranking de candidatos e geração de resumos executivos para hiring managers
automated code review squad
Squad especialista em code review automatizado — revisão de segurança, análise lógica, verificação de padrões arquiteturais, enforcement de coding standards e geração de review summaries priorizados para PRs e commits