Communitygithub.com

curiositech/windags-skills

构建生产就绪的LLM应用、高级RAG系统和智能代理。实现向量搜索、多模态AI、代理编排和企业AI集成。主动用于LLM功能、聊天机器人、AI代理或AI驱动的应用。

windags-skills 是什么?

该技能专为构建生产级LLM应用而设计,涵盖从简单聊天机器人到复杂多代理系统的全场景。它专注于RAG架构、向量数据库、提示管理和企业级AI部署。技能提供了详细的决策点,指导用户根据查询类型、预算和延迟要求选择RAG组件、模型路由策略以及代理与RAG的权衡。此外,它深入分析了语义不匹配、上下文窗口溢出、工具幻觉循环等常见故障模式,并给出了检测和修复方法。通过一个客户支持聊天机器人的完整实现示例,展示了从架构决策到性能优化再到故障处理的专家级最佳实践。该技能还包含了严格的质量门控标准、明确的非适用边界(例如,不应将其用于提示工程、ML模型训练或数据管道工程),并建议在需要深度ML专业知识或基础设施扩展时委派给其他专门技能。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/curiositech/windags-skills/tree/HEAD/skills/ai-engineer

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

AI工程师

构建生产就绪的LLM应用专家,从简单聊天机器人到复杂的多代理系统。专精于RAG架构、向量数据库、提示管理和企业级AI部署。

决策点

RAG组件选择

查询类型评估:
├── 简单FAQ/知识查询
│   ├── 文档数量 < 1000 → Chroma + text-embedding-3-small
│   └── 文档数量 > 1000 → Pinecone + text-embedding-3-large
├── 技术/代码文档  
│   ├── 预算受限 → bge-large + pgvector
│   └── 性能关键 → voyage-2 + Weaviate
└── 对话式/多轮
    ├── 需要记忆 → 代理模式 + 上下文管理
    └── 无状态 → 标准RAG管道

重排序决策:
├── 精度关键(法律、医疗)→ 始终使用Cohere Rerank
├── 延迟 < 200ms → 跳过重排序,调整检索
├── 预算受限 → 交叉编码器(bge-reranker-large)
└── 默认 → 使用Cohere Rerank,top-10 → top-3

数据库选择:
├── 已有Postgres → pgvector扩展
├── 需要混合搜索 → Weaviate或Qdrant
├── 托管服务 → Pinecone
└── 自托管/本地 → Chroma或Qdrant

模型路由策略

复杂度评估:
├── 仅关键词(FAQ)→ Claude Haiku
├── 单文档引用 → Claude Sonnet 
├── 多文档综合 → Claude Opus
└── 代码生成 → Claude Sonnet + 工具

Token预算检查:
├── < 1K tokens → 任意模型
├── 1K-4K tokens → Sonnet/GPT-4
├── 4K-32K tokens → Claude Opus
└── > 32K tokens → 先分块再总结

代理与RAG决策

任务分类:
├── 静态知识查询 → 纯RAG
├── 需要外部API → 带工具的代理
├── 多步推理 → 带规划的代理
├── 需要实时数据 → 带实时工具的代理
└── 简单问答 → RAG + 回退到代理

故障模式

语义不匹配级联

症状: 检索精度高但答案相关性差,用户反馈“接近但不太正确” 检测规则: 语义相似度 > 0.8 但用户满意度 < 60% 根本原因: 查询和文档嵌入针对不同的语义空间进行了优化 修复方法: 切换到领域特定的嵌入模型或使用同义词实现查询扩展

上下文窗口溢出

症状: 回答变得通用,模型忽略特定的检索上下文,答案不一致 检测规则: 上下文利用率 < 30% 且回答普遍性得分 > 0.7 根本原因: 过多不相关块稀释了相关信息 修复方法: 实施更严格的相关性阈值(>0.8)和动态上下文选择

工具幻觉循环

症状: 代理编造API调用,引用不存在的函数,无限重试循环 检测规则: 工具调用成功率 < 50% 或迭代次数 > max_iterations * 0.8 根本原因: 模型训练时使用的工具模式与实现不同 修复方法: 在代理系统提示中添加工具验证层和显式错误处理

嵌入漂移退化

症状: 检索质量随时间逐渐下降,性能季节性下降 检测规则: 月度平均retrieval@5相比基线下降 > 10% 根本原因: 领域语言演变但嵌入模型保持不变 修复方法: 实施嵌入模型重训练管道或切换到自适应嵌入

响应延迟爬升

症状: P95延迟逐渐增加,用户抱怨响应慢 检测规则: P95响应时间超过基线2倍且持续7天 根本原因: 向量索引退化、上下文大小膨胀或模型端点饱和 修复方法: 实施索引优化计划、上下文剪枝和多模型负载均衡

工作示例

示例:客户支持聊天机器人实现

初始需求: “构建一个聊天机器人,能够回答关于我们500页产品文档的问题”

步骤1:架构决策

  • 文档数量:500页 → 使用Pinecone以保证可扩展性
  • 查询类型:混合FAQ + 故障排除 → 需要混合搜索
  • 延迟要求:< 3秒 → 包含重排序但进行优化

步骤2:实现演练

// 新手方法 - 使用基本的相似度搜索
const chunks = await vectorDb.query(queryEmbedding, { topK: 5 });

// 专家方法 - 考虑相关性阈值
const rawChunks = await vectorDb.query(queryEmbedding, { 
  topK: 20, 
  threshold: 0.7  // 确保最低相关性
});

// 专家添加新手可能会跳过的重排序步骤
const reranked = await reranker.rank(query, rawChunks);
const finalChunks = reranked.slice(0, 3);

// 专家包含回退处理
if (finalChunks.length === 0) {
  return await fallbackToGeneralSupport(query);
}

步骤3:性能优化发现

  • 初始P95延迟:4.2秒(高于要求)
  • 分析:60%的时间花费在重排序上
  • 权衡决策:从Cohere Rerank切换到本地交叉编码器
  • 结果:P95延迟 → 2.1秒,轻微质量下降(92% → 89%满意度)
  • 专家见解:对于支持用例,速度胜于完美精度

步骤4:故障场景处理

  • 发现15%的查询是关于文档中未包含的功能
  • 新手:会返回“我不知道”
  • 专家:添加了升级检测并移交给人机客服

最终架构:Pinecone + 本地重排序器 + 代理升级 = 89%自动化率,P95为2.1秒

质量门禁

  • 评估数据集上的Retrieval@5准确率 > 85%
  • P95的平均响应延迟 < 3秒
  • 上下文利用率 > 60%(模型使用了检索到的信息)
  • 幻觉率 < 5%(检索上下文不支持的响应)
  • 30天滚动窗口内的用户满意度得分 > 80%
  • 每次查询的Token成本低于预设预算阈值
  • 排除计划维护后的系统正常运行时间 > 99.9%
  • PII检测率 > 95%(响应中不包含个人信息)
  • 嵌入模型性能稳定(月度退化不超过10%)
  • 错误处理覆盖所有故障模式并提供优雅降级

非适用边界

请勿将此技能用于:

提示工程任务 → 请使用prompt-engineer

  • 优化提示模板和指令
  • A/B测试提示变体
  • 思维链提示设计

ML模型训练/微调 → 请使用ml-engineer

  • 训练自定义嵌入模型
  • 在领域数据上微调LLM
  • 模型架构研究

数据管道工程 → 请使用data-pipeline-engineer

  • 训练数据的ETL流程
  • 数据验证和清理工作流
  • 批处理系统

基础设施/DevOps → 请使用backend-architect

  • Kubernetes部署策略
  • 数据库优化和分片
  • 负载均衡器配置

分析和监控设置 → 请使用chatbot-analytics

  • 对话流分析
  • 用户行为追踪
  • 性能仪表盘创建

委托时机:

  • 任务需要深度ML专业知识 → ml-engineer
  • 重点在对话设计 → prompt-engineer
  • 需要基础设施扩展 → backend-architect
  • 想要使用分析功能 → chatbot-analytics
  • 构建非AI功能 → 相关专家技能

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

curiositech/windags-skills

Expert in 2000s-era music visualization (Milkdrop, AVS, Geiss) and modern WebGL implementations. Specializes in Butterchurn integration, Web Audio API AnalyserNode FFT data, GLSL shaders for audio-reactive visuals, and psychedelic generative art. Activate on "Milkdrop", "music visualization", "WebGL visualizer", "Butterchurn", "audio reactive", "FFT visualization", "spectrum analyzer". NOT for simple bar charts/waveforms (use basic canvas), video editing, or non-audio visuals.

curiositech/windags-skills

Expert legal research agent for finding and scraping expungement data state by state. Knows authoritative sources, URL patterns, Firecrawl configuration, and 2026 legal landscape.

curiositech/windags-skills

Expert in 3D computer vision labeling tools, workflows, and AI-assisted annotation for LiDAR, point clouds, and sensor fusion. Covers SAM4D/Point-SAM, human-in-the-loop architectures, and vertical-specific training strategies. Activate on '3D labeling', 'point cloud annotation', 'LiDAR labeling', 'SAM 3D', 'SAM4D', 'sensor fusion annotation', '3D bounding box', 'semantic segmentation point cloud'. NOT for 2D image labeling (use clip-aware-embeddings), general ML training (use ml-engineer), video annotation without 3D (use computer-vision-pipeline), or VLM prompt engineering (use prompt-engineer).

curiositech/windags-skills

Implement WCAG 2.2 AA/AAA compliance with automated testing, keyboard navigation, screen reader support, and focus management. Activate on: accessibility audit, WCAG compliance, keyboard navigation, screen reader, aria attributes, axe-core, focus trap. NOT for: design-level accessibility review (use design-accessibility-auditor), color contrast only (use css-in-js-architect).

curiositech/windags-skills

Time-blind friendly planning, executive function support, and daily structure for ADHD brains. Specializes in realistic time estimation, dopamine-aware task design, and building systems that actually work for neurodivergent minds.

curiositech/windags-skills

Designs digital experiences for ADHD brains using neuroscience research and UX principles. Expert in reducing cognitive load, time blindness solutions, dopamine-driven engagement, and compassionate design patterns. Activate on 'ADHD design', 'cognitive load', 'accessibility', 'neurodivergent UX', 'time blindness', 'dopamine-driven', 'executive function'. NOT for general accessibility (WCAG only), neurotypical UX design, or simple UI styling without ADHD context.

curiositech/windags-skills

>- Apply crisis decision-making research to agent routing, uncertainty triage, and coordination failure analysis in time-pressured systems. Use when diagnosing handoff failures, analytical paralysis, or expert judgment under incomplete information. NOT for routine coding, simple CRUD design, or static single-agent tasks with complete information.

curiositech/windags-skills

Extend and modify the admin dashboard, developer portal, and operations console. Use when adding new admin tabs, metrics, monitoring features, or internal tools. Activates for dashboard development, analytics, user management, and internal tooling.

curiositech/windags-skills

Conversation patterns and interaction protocols for multi-agent systems. Covers request/response, pub/sub, blackboard, delegation chains, debate, critique, consensus, fan-out/fan-in, supervisor-worker, and peer negotiation. Deep analysis of AutoGen conversation patterns, CrewAI delegation, LangGraph state passing, and FIPA-ACL performatives. Teaches how to design what agents say to each other and in what order. Activate on: "agent conversation", "agent protocol", "multi-agent debate", "agent delegation", "supervisor worker pattern", "agent voting", "consensus protocol", "fan-out fan-in", "agent negotiation", "blackboard pattern", "agent dialogue", "conversation topology", "agent handoff". NOT for: wire format or serialization (use agent-interchange-formats), orchestration infrastructure (use agentic-infrastructure-2026), single agent behavior (use agentic-patterns).

curiositech/windags-skills

Meta-agent for creating new custom agents, skills, and MCP integrations. Expert in agent design, MCP development, skill architecture, and rapid prototyping. Activate on 'create agent', 'new skill', 'MCP server', 'custom tool', 'agent design'. NOT for using existing agents (invoke them directly), general coding (use language-specific skills), or infrastructure setup (use deployment-engineer).

curiositech/windags-skills

AI-powered calendar management and agent-based scheduling coordination. Covers calendar APIs (Google Calendar, CalDAV/iCal), AI scheduling assistants (Reclaim, Clockwise, Motion, Cal.com), building custom calendar agents with MCP, multi-calendar merging, timezone management, focus block protection, meeting fatigue detection, and agent-to-agent meeting negotiation protocols. Activate on: "calendar agent", "AI scheduling", "calendar coordination", "meeting scheduling", "calendar API", "focus time protection", "calendar optimization", "Google Calendar MCP", "Reclaim", "Clockwise", "Motion", "Cal.com", "smart scheduling", "calendar-aware agent", "timezone scheduling", "agent negotiation meetings". NOT for: manual calendar UI component design (use form-validation-architect), project management scheduling or Gantt charts (use project-management-guru-adhd), general time-tracking or pomodoro apps (use adhd-daily-planner for time-awareness), building the agent itself from scratch (use agent-creator).

curiositech/windags-skills

Build and adopt production AI agent infrastructure in 2026. Covers framework selection (LangGraph, CrewAI, AutoGen, MCP), orchestration patterns, evaluation, observability, memory systems, and tool use. Also covers the SOCIAL dimension: how to sell agent infrastructure internally, change management, measuring ROI, building trust in autonomous systems, and scaling adoption across teams. Activate on: "agent infrastructure", "agent framework comparison", "which agent framework", "sell AI tools internally", "agent adoption", "agent observability", "agent evaluation", "MCP architecture", "agentic mesh", "enterprise AI agents", "AI change management", "agent ROI". NOT for: building specific agents (use ai-engineer), designing agent behavior patterns (use agentic-patterns), prompt tuning (use prompt-engineer).

curiositech/windags-skills

Fundamental patterns for effective agentic behavior. Teaches decomposition, tool orchestration, error recovery, context management, quality self-assessment, and knowing when to stop. Model-agnostic principles that make any agent more effective regardless of domain. Activate on: "how should I structure this agent", "agentic workflow", "agent patterns", "multi-step task", "tool orchestration", "/agentic-patterns", "decompose this", "agent best practices", "chain of actions", "when should the agent stop", "agent loop design". NOT for: creating agent infrastructure (use agent-creator), building DAGs (use windags-architect), specific tool implementation.

curiositech/windags-skills

Automated discovery and matching of agent skills for dynamic task routing and capability assessment

curiositech/windags-skills

Cryptographic security for agentic systems — zero-trust agent networking, signed message envelopes (JWS/JWE), capability-based security (ocaps), Merkle tree audit trails, WASM sandboxing, and formal verification. Covers CLI dev tool security, mTLS between agents, permission boundaries (least privilege for AI agents), and supply chain security for skills/plugins. Activate on: "agent security", "zero trust agents", "secure agent communication", "capability-based security", "ocap", "signed messages between agents", "agent audit trail", "sandbox agent execution", "agent permissions", "mTLS agents", "cryptographic verification", "agent supply chain", "OWASP agentic", "prove agent did X", "tamper-proof agent logs". NOT for: application-level SAST scanning (use security-auditor), network firewall rules (use infrastructure), SOC2/HIPAA compliance (organizational), or prompt injection defense (use prompt-engineer).

curiositech/windags-skills

Data structures and serialization formats for agent-to-agent communication. Covers message envelopes, structured output schemas, capability declarations, task handoff payloads, error/retry signaling, and context windows as data structures. Deep comparison of A2A protocol, MCP, OpenAI function calling, and LangChain message types. Teaches when to use rigid schemas vs free-form with validation, typed vs untyped, streaming vs batch. Activate on: "agent message format", "agent communication schema", "agent-to-agent protocol", "A2A protocol", "MCP message format", "structured output for agents", "agent interop", "interchange format", "agent serialization", "task handoff format", "capability declaration". NOT for: what agents say to each other (use agent-conversation-protocols), orchestration topology (use multi-agent-coordination), building agent infrastructure (use agentic-infrastructure-2026).

curiositech/windags-skills

Logic-based agent programming language implementing BDI architecture for practical autonomous agent development

curiositech/windags-skills

>- Design AgentSpeak(L)-style BDI agents with context-guarded plans, selection functions, and intention stacks. Use for interruptible autonomy, agent policy, and multi-agent orchestration in dynamic environments. NOT for simple rule engines, static planners, or centralized workflows.

curiositech/windags-skills

Foundational concurrent computation model where actors communicate exclusively through asynchronous message passing

curiositech/windags-skills

license: Apache-2.0 NOT for unrelated tasks outside this domain.

相关技能