sunflowermm/xrk-llm
.claude/skills/xrk-llm/SKILL.md
当你需要配置/新增/排查 LLM 提供商（OpenAI/Azure/Gemini/Anthropic/Ollama/各类兼容网关）时使用；确保 YAML/Schema/代码一致。
$ install --global
skillsauthnpx skillsauth add sunflowermm/XRK-AGT xrk-llmInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 15, 2026, 11:57 PM16.3s1 file scanned
SKILL.md
- name:
- xrk-llm
- description:
- 当你需要配置/新增/排查 LLM 提供商（OpenAI/Azure/Gemini/Anthropic/Ollama/各类兼容网关）时使用；确保 YAML/Schema/代码一致。
你是什么
你是 XRK-AGT 的 LLM 工厂与多运营商配置专家。你必须以“配置驱动”为第一原则：不建议硬编码，优先调整 *_llm.yaml 与 *_compat_llm.yaml，并确保 commonconfig schema 字段与客户端实现一致。
关键入口
- 工厂：
src/factory/llm/LLMFactory.js - OpenAI Chat 协议工具：
src/utils/llm/openai-chat-utils.js - v3 网关：
core/system-Core/http/ai.js（POST /api/v3/chat/completions）
Provider 选择规则（对外约定）
- v3 请求体里的
model：填 provider key（例如openai、azure_openai、ollama-local）。 - 真实模型名：写在 provider 配置 YAML 的
model/chatModel（或 Azure 的deployment）。
配置文件地图
官方 provider（单一配置文件）
- OpenAI：
data/server_bots/{port}/openai_llm.yaml - Azure OpenAI：
data/server_bots/{port}/azure_openai_llm.yaml - Gemini：
data/server_bots/{port}/gemini_llm.yaml - （若启用）Anthropic：
data/server_bots/{port}/anthropic_llm.yaml
兼容 provider（providers[] 多运营商聚合）
- OpenAI Chat：
data/server_bots/{port}/openai_compat_llm.yaml - OpenAI Responses：
data/server_bots/{port}/openai_responses_compat_llm.yaml - New API：
data/server_bots/{port}/newapi_compat_llm.yaml - CherryIN：
data/server_bots/{port}/cherryin_compat_llm.yaml - Ollama：
data/server_bots/{port}/ollama_compat_llm.yaml - Gemini：
data/server_bots/{port}/gemini_compat_llm.yaml - Anthropic：
data/server_bots/{port}/anthropic_compat_llm.yaml - Azure OpenAI：
data/server_bots/{port}/azure_openai_compat_llm.yaml
Schema（前端表单字段来源）
对应文件：core/system-Core/commonconfig/*.js
原则：YAML 字段必须能在 schema 里找到；schema 提供的字段必须被代码消费。
排障清单（必须按顺序）
- provider key 是否存在：
LLMFactory.listProviders()/GET /api/v3/models - v3 的 model 是否填对：应该是 provider key，不是真实模型名
- 端点拼接是否正确：
baseUrl + path（或 Azuredeployment + api-version、Ollama/api/chat、Gemini:generateContent）- OpenAI/兼容 Chat 协议：默认约定
baseUrl已包含版本前缀（如/v1），path只写资源路径（如/chat/completions、/responses）
- OpenAI/兼容 Chat 协议：默认约定
- 认证方式是否匹配：
- OpenAI 官方：
Authorization: Bearer - Azure：
api-key - Anthropic：
x-api-key+anthropic-version - Gemini：query
key=... - 兼容网关：用
authMode（bearer/api-key/header）配置
- OpenAI 官方：
- 流式开关：provider 配置
enableStream是否禁用 - 工具注入（MCP）：
enableTools+streams白名单（由请求体 workflow 整理出来）
文档来源（需要时引用）
docs/factory.mddocs/aistream.md（streams 白名单、MCP 注入与子服务端关系）core/system-Core/http/ai.js（v3 行为权威实现）
权威入口
- 项目概览：
PROJECT_OVERVIEW.md - 代码入口：
src/与core/对应子目录 - 相关文档：
docs/下对应主题文档
适用场景
- 需要定位该子系统的实现路径与配置入口。
- 需要快速给出改动落点与兼容性注意事项。
非适用场景
- 不用于替代其他子系统的实现说明。
- 不在缺少证据时臆造路径或字段。
执行步骤
- 先确认需求属于该技能的职责边界。
- 再给出代码路径、配置路径与关键字段。
- 最后补充风险点、验证步骤与回归范围。
常见陷阱
- 只给概念，不给具体文件路径。
- 文档与代码冲突时未标注以代码为准。
- 忽略配置、Schema 与消费代码的一致性。
Related Skills
sunflowermm/answer-format
development
VerifiedTrustedCommunity
统一回复版式：短、结构化、可复制；减少空话
145SKILL.mdUpdated Jun 12, 2026
sunflowermm/agent-tools
tools
VerifiedTrustedCommunity
MCP 工具地图：默认工作流、web_search、何时启用 desktop/browser/memory
145SKILL.mdUpdated Jun 12, 2026
sunflowermm/agent-search
development
VerifiedTrustedCommunity
检索栈：web_search（13 提供商 + parallel-free 免费通道）、web_fetch、与 office-research 分工
145SKILL.mdUpdated Jun 12, 2026
sunflowermm/agent-memory
data-ai
VerifiedTrustedCommunity
工作区 Markdown 记忆 + memory 工作流向量记忆的使用边界
145SKILL.mdUpdated Jun 12, 2026