agents

此技能作为在本地开发环境中开发与管理代理式 AI 模式的综合框架。专为软件工程师、DevOps 从业者与 AI 架构师设计，旨在促进标准化技能文件的生成，使 Claude Code、Cursor、Cline、Windsurf 与 Copilot 等 AI 助手能够理解特定于项目的约定、工具与架构模式。通过自动化技能结构的建立，确保 AI 助手能超越通用行为，提供针对您独特代码库的、具备高度上下文感知能力的多步骤辅助。

• Claude API 集成：提供流式消息 API、系统提示词设计与管理复杂用户上下文的标准化模式，以实现可靠的推理。

• 多代理兼容性：通过集中式配置管理，支持包含 GitHub Copilot、Continue、Roo、Amp、Gemini CLI 与 Goose 在内的多种热门 AI 代理。

• 模式驱动生成：利用自动化生成器扫描项目目录、分析依赖项 (package.json)，并输出一致的 Markdown 格式技能定义。

• 工具调用支持：实现结构化的函数定义与复杂的工作流程编排，允许代理执行如文件系统扫描或代码生成等特定任务。

• 详细日志与诊断：内置调试功能，包括实时流式输出至 stderr 与模拟运行检测，确保代理决策过程的可视性。

• 需要 ANTHROPIC_API_KEY 环境变量以处理涉及 Claude 模型的高级生成任务。

• 最佳实践包括严格区分提示工程文件 (src/prompts/) 与生成器逻辑 (src/generators/)，以维持易于管理的版本控制。

• 此技能提倡“上下文优于 Token”，通过智能筛选相关代码库文件来避免输入溢出，确保推理任务获得更高质量的响应。

• 在构建自定义代理模式时，务必使用异步文件系统操作 (fs/promises)，以避免在 Node.js 工作流程中阻塞事件循环。

• 限制：主要针对使用原生 ESM 模块的 Node.js 18+ 环境所设计，以确保性能并与现代 AI CLI 工具兼容。