LLM-配置管理系统

集中式LLM配置和文档管理系统。用于构建技能、命令、代理、提示和管理MCP服务器的工具。多LLM支持（克劳德代码、Codex、OpenCode）。

![License: MIT](https://opensource.org/licenses/MIT) ![Python 3.11+](https://www.python.org/downloads/)

______________________________________________________________________

🎯 视觉

构建一个统一的系统，用于跨多个LLM提供商（Claude Code、Codex、OpenCode等）管理LLM配置、文档和工具。使开发人员能够：

获取并维护 LLM提供商提供的最新文档
构建和管理 技能、命令、代理和提示
包装和分发 团队共享插件
管理MCP （模型上下文协议服务器）
跨LLM工作 使用单一工具集

______________________________________________________________________

✨ 特性

当前（Sprint 1-4:Claude代码焦点）

✅ 文档获取器：自动从Anthropic、OpenAI等获取和更新文档。
✅ 范围情报：自动检测全局/项目/本地配置
✅ 技能建设者：使用模板生成Claude代码技能
✅ 指令产生器：创建斜线命令以实现自动化
✅ 代理构建器：为专门任务建立子代理
✅ 快速构建器：生成并验证主提示
✅ 插件生成器：打包技能/命令/分发代理
✅ MCP经理：管理模型上下文协议服务器
✅ 吊钩生成器：创建挂钩配置

未来（Sprint 5+：多LLM）

🔮 食品法典支持：为OpenAI Codex调整工具
🔮 OpenCode支持：扩展到OpenCode
🔮 通用格式：LLM无关配置格式
🔮 RAG集成：个人文件知识库

______________________________________________________________________

🤖 功能实现器v2架构

状态: ✅ 生产就绪（v1.0.0）

这 功能实现器v2 是一个复杂的多代理系统，它协调了从需求分析到部署的整个软件开发生命周期。它由14个专业代理、37个生产技能和智能挂钩构建，提供了一种结构化、自动化的方法来实现GitHub issues的功能。

架构概述

┌─────────────────────────────────────────────────────────────┐
│              FEATURE-IMPLEMENTER (Main Agent)               │
│                  6-Phase Orchestration                      │
└─────────────────────────────────────────────────────────────┘
           │                                       │
    ┌──────┴──────┐                        ┌──────┴──────┐
    │   PHASE 1   │                        │   PHASE 2   │
    │  ANALYSIS   │                        │   DESIGN    │
    └──────┬──────┘                        └──────┬──────┘
           │                                       │
    @analysis-specialist               @design-orchestrator
    ├─ requirements-extractor           ├─ @architecture-designer
    ├─ security-assessor                │  ├─ architecture-planner
    └─ tech-stack-evaluator             │  ├─ data-modeler
                                         │  └─ api-designer
                                         ├─ @documentation-researcher
                                         │  ├─ doc-fetcher
                                         │  └─ doc-analyzer
                                         └─ @dependency-manager
                                            ├─ dependency-analyzer
                                            └─ version-checker

    ┌──────┬──────┐    ┌──────────┬─────────┐    ┌──────┬──────┐
    │ PHASE 3-4   │    │  PHASE 5         │    │  PHASE 6    │
    │ APPROVAL &  │    │  VALIDATION      │    │  DEPLOYMENT │
    │ IMPLEMENT   │    └──────────┬───────┘    └──────┬──────┘
    └─────────────┘               │                    │
    feature-implementer    @validation-orchestrator    @deployment-specialist
    ├─ analysis-skill     ├─ @unit-test-specialist    ├─ documentation-updater
    ├─ design-skill       ├─ @integration-test        ├─ changelog-generator
    └─ implementation     ├─ @test-runner             └─ pr-creator
       - TDD approach     ├─ @code-quality
       - Code review      ├─ @security-specialist
       - Best practices   └─ @e2e-accessibility (frontend)

六阶段工作流程

第一阶段：需求分析 (@analysis-specialist)

- 从GitHub问题中提取需求 - 安全评估（OWASP、数据隐私） - 技术栈评估 - 输出： docs/implementation/analysis/analysis.md

第二阶段：建筑与设计 (@design-orchestrator)

- 并行子代理: - 架构设计（组件、数据模型、API） - 文档研究（获取最新的库文档） - 依赖关系管理（兼容性、版本） - 设计综合与验证 - 输出： docs/implementation/prp/prp.md （问题需求计划）

第三阶段：用户审批

- 向用户展示分析和设计 - 收集反馈和批准 - 必要时迭代

第四阶段：实施 （主代理）

- 测试驱动开发（TDD） - 符合项目标准的代码 - 遵循最佳实践和模式 - 每个文件保持≤500行 - 输出：带有初始测试的工作代码

第5阶段：验证 (@validation-orchestrator)

- 连续专家 （使用递归通信）： - 单元测试(@unit-test-specialist) - 集成测试(@integration-test-specialist) - 测试执行和覆盖范围(@test-runner-specialist) - 代码质量检查(@code-quality-specialist) - 安全扫描(@security-specialist) - E2E和可访问性测试(@e2e-accessibility-specialist，仅前端） - 验证失败时的递归循环 - 输出：验证报告、测试结果、安全扫描

第6阶段：部署 (@deployment-specialist)

- 更新文档（自述、指南、API文档） - 生成CHANGELOG条目 - 创建pull请求 - 输出：PR已准备就绪，可供审查

全部14名代理人

代理	角色	模型	自动激活技能
功能实现者	主编排器	Sonnet	分析、设计、实现、验证
分析专家	需求分析	Haiku	需求提取器、安全评估员、技术栈评估员
设计编排器	设计协调	Sonnet	设计合成器、prp生成器
建筑设计师	组件架构	Opus+superthink	架构规划师、数据建模师、api设计师
文献研究员	库文档	Haiku+context7	文档提取器、文档分析器
依赖关系管理器	依赖性分析	Haiku	依赖性分析器、版本检查器
验证编排器	验证协调	Sonnet	验证协调员、递归通信器
单元测试专家	单元测试	Haiku	单元测试编写器、pytest生成器、jest生成器
集成测试专家	集成测试	Haiku	集成测试编写器、api测试生成器
试运行专家	测试执行	Haiku	测试执行器、覆盖率分析器
代码质量专家	装订格式化	俳句	python质量检查器、打字质量检查器、锈迹质量检查器
安全专家	安全扫描	Sonnet	安全扫描器、漏洞评估器、owasp检查器
e2e无障碍专家	E2E&WCAG 2.1 AA	十四行诗+剧作家	E2E测试撰稿人、可访问性检查器
部署专家	文档与公关	Haiku	文档更新工具、变更日志生成器、公关创建者

生产技能（37）

核心工作流程技能（4）:

analysis/ -需求分析指南
design/ -架构和API设计
implementation/ -TDD实现与代码标准
validation/ -质量验证工作流程

专业技能（33） 映射到代理：

分析：需求提取器、安全评估员、技术栈评估员
设计：设计合成器、prp生成器、架构规划师、数据建模师、api设计器
文档：文档提取器、文档分析器
依赖关系：依赖关系分析器、版本检查器
验证：验证协调器、递归通信器
测试：单元测试编写器、pytest生成器、jest生成器、集成测试编写器，api测试生成器，测试执行器，覆盖率分析器
质量：python质量检查器、打字机质量检查器、锈迹质量检查器
安全：安全扫描器、漏洞评估器、owasp检查器
E2E:E2E测试编写器、可访问性检查器
部署：文档更新器、更改日志生成器、pr创建者
按需：代码审查员、测试生成器

挂钩配置

预提交钩子 (.claude/hooks/pre-commit.py):

触发器打开 git commit 命令
跑步：黑色→ Flake8→ Mypy → Pytest
阻塞：如果检查失败，退出代码2将阻止提交
180秒超时

实施后挂钩 (.claude/hooks/post-implementation.py):

实施阶段完成的触发因素
检测成绩单中的完成标记
自动触发验证工作流
非阻塞：继续正常的对话流程
60秒超时

用法

# Implement a feature from GitHub issue
@feature-implementer implement issue #123

# The agent will:
# 1. Analyze requirements (Phase 1)
# 2. Design architecture (Phase 2)
# 3. Present design for approval (Phase 3)
# 4. Implement with TDD (Phase 4)
# 5. Validate with specialists (Phase 5)
# 6. Create PR and update docs (Phase 6)

质量标准

测试覆盖率：要求≥80%
代码质量黑色，Flake8，Mypy必须通过
安全：OWASP十大合规性
文件大小：每个文件≤500行
无障碍：WCAG 2.1 AA（前端）
文档：全面的API文档、指南、CHANGELOG

主要特点

✅ 多代理编排14名专业人员协同工作 ✅ 渐进呈现：仅在需要时加载上下文 ✅ 递归验证：自动重试验证，直到所有检查通过 ✅ 自动质量门：预提交钩子执行标准 ✅ 文件优先：始终获取最新的库文档 ✅ TDD方法：实施前编写的测试 ✅ 安全第一：内置安全扫描和评估

文档

建筑: docs/architecture/feature-implementer-v2.md
用户指南: docs/guides/feature-implementer-v2-guide.md
迁移指南: docs/architecture/migration-guide-v1-to-v2.md
技能映射: 文档/架构/技能映射.md

______________________________________________________________________

🚀 快速开始

安装

# Clone the repository
git clone https://github.com/matteocervelli/llms.git
cd llms

# Install dependencies with uv
uv pip install -r requirements.txt

# Install in development mode
uv pip install -e ".[dev]"

用法

# Fetch documentation
python -m src.tools.doc_fetcher fetch --provider anthropic

# Build a skill
python -m src.tools.skill_builder create --name my-skill --template basic

# Build a command
python -m src.tools.command_builder create --name my-command

# Build an agent
python -m src.tools.agent_builder create --name my-agent

______________________________________________________________________

🎯 范围情报系统

该项目包括一个强大的 三层范围系统 用于管理不同级别的配置：

范围层次

全局作用域 (~/.claude/)：适用于所有项目的用户范围设置
项目范围 (.claude/)：与团队共享的项目特定设置
本地范围 (.claude/settings.local.json)：项目本地设置未提交到版本控制

配置优先级：本地>项目>全球

快速示例

from src.core.scope_manager import ScopeManager

# Auto-detect scope based on current directory
manager = ScopeManager()
scope = manager.detect_scope()
print(f"Detected scope: {scope.value}")

# Get effective scope with CLI flag
scope_config = manager.get_effective_scope('--project')
print(f"Using path: {scope_config.path}")

# Resolve all scopes with precedence
scopes = manager.resolve_all_scopes()
for scope in scopes:
    print(f"{scope.type.value}: {scope.path} (precedence: {scope.precedence})")

用例

全球：个人偏好、默认模板、用户范围设置
项目：团队共享技能/命令、项目配置（已提交）
本地：个人重写、API密钥、特定于机器的配置（gitignored）

看 src/core/README.md 详细文件和 ADR-001 用于设计决策。

______________________________________________________________________

📁 项目结构

~/.claude/llms/
├── commands/              # Slash commands (LLM-agnostic)
├── agents/                # Sub-agents (LLM-agnostic)
├── skills/                # Skills/capabilities (LLM-agnostic)
├── prompts/               # Prompts
├── .claude/               # Claude-specific settings
│   └── settings.json
├── src/                   # Source code
│   ├── tools/             # Builder tools
│   ├── core/              # Core functionality
│   └── utils/             # Utilities
├── templates/             # Templates for creation
│   ├── claude/            # Claude Code templates
│   ├── codex/             # Codex templates (future)
│   └── opencode/          # OpenCode templates (future)
├── docs/                  # Fetched documentation
│   ├── anthropic/
│   ├── openai/
│   └── mcp/
├── manifests/             # Metadata catalogs
└── tests/                 # Test suite

______________________________________________________________________

🏃 发展

设置开发环境

cd ~/.claude/llms

# Install with development dependencies
uv pip install -e ".[dev]"

# Run tests
pytest

# Run tests with coverage
pytest --cov=src --cov-report=html

# Format code
black src/ tests/

# Type checking
mypy src/

# Lint
flake8 src/ tests/

运行测试

# All tests
pytest

# Specific test file
pytest tests/test_doc_fetcher.py

# With coverage
pytest --cov=src --cov-report=term-missing

# Verbose
pytest -v

______________________________________________________________________

🤖 自动化

每周文档更新

使用cron每周自动更新LLM提供程序文档。

快速设置

手动测试脚本:

cd ~/.claude/llms
./scripts/update_docs.sh

添加到crontab （星期日凌晨2点）：

crontab -e

添加此行：

# Update LLM documentation weekly (Sundays at 2 AM)
0 2 * * 0 cd ~/.claude/llms && ./scripts/update_docs.sh >> logs/doc_fetcher/cron.log 2>&1

验证cron作业:

crontab -l

启用电子邮件通知（可选）

要接收错误的电子邮件警报，请设置环境变量：

# Add to your shell profile (~/.bashrc, ~/.zshrc, etc.)
export DOC_UPDATER_EMAIL="your-email@example.com"

需求:

mail 命令（安装： brew install mailutils 在macOS上）
已配置的邮件服务器（sendmail、postfix或SMTP）

日志管理

日志位置:

详细日志： logs/doc_fetcher/update_YYYYMMDD_HHMMSS.log
Cron输出： logs/doc_fetcher/cron.log

自动旋转:

超过30天的日志将自动删除
每次运行都会创建一个新的带时间戳的日志文件

查看最近的日志:

# List all logs
ls -lh logs/doc_fetcher/

# View latest log
tail -f logs/doc_fetcher/update_*.log | tail -n 50

# View cron output
tail -f logs/doc_fetcher/cron.log

禁用自动化

要临时禁用自动更新，请执行以下操作：

# Comment out the cron job
crontab -e
# Add # at the beginning of the line:
# 0 2 * * 0 cd ~/.claude/llms && ./scripts/update_docs.sh >> logs/doc_fetcher/cron.log 2>&1

要永久删除：

crontab -e
# Delete the line completely

故障排除

Cron作业未运行:

检查cron是否已启用： sudo launchctl list | grep cron （macOS）
检查cron日志： grep CRON /var/log/system.log （macOS）
验证脚本权限： ls -l scripts/update_docs.sh （应该是 -rwxr-x---)

脚本失败，出现错误:

手动运行以查看详细输出： ./scripts/update_docs.sh
检查Python安装： python --version （应为3.11+）
验证依赖关系： pip list | grep -E "(click|requests|pydantic|crawl4ai)"
检查清单是否存在： ls -l manifests/docs.json

电子邮件通知不起作用:

检查 mail 命令： which mail
手动测试电子邮件： echo "test" | mail -s "Test" your-email@example.com
检查环境变量： echo $DOC_UPDATER_EMAIL
验证邮件服务器配置

日志填满磁盘:

日志会自动轮换（保留30天）
检查磁盘使用情况： du -sh logs/doc_fetcher/
手动删除旧日志： rm logs/doc_fetcher/update_*.log

高级配置

自定义时间表:

# Daily at 3 AM
0 3 * * * cd ~/.claude/llms && ./scripts/update_docs.sh >> logs/doc_fetcher/cron.log 2>&1

# Twice weekly (Monday and Thursday at 1 AM)
0 1 * * 1,4 cd ~/.claude/llms && ./scripts/update_docs.sh >> logs/doc_fetcher/cron.log 2>&1

# Monthly (first Sunday at 2 AM)
0 2 1-7 * 0 cd ~/.claude/llms && ./scripts/update_docs.sh >> logs/doc_fetcher/cron.log 2>&1

自定义Python命令:

# Use specific Python interpreter
0 2 * * 0 cd ~/.claude/llms && PYTHON_CMD=python3.11 ./scripts/update_docs.sh >> logs/doc_fetcher/cron.log 2>&1

# Use virtual environment
0 2 * * 0 cd ~/.claude/llms && PYTHON_CMD=.venv/bin/python ./scripts/update_docs.sh >> logs/doc_fetcher/cron.log 2>&1

自定义日志保留:

编辑 scripts/update_docs.sh 并更改：

LOG_RETENTION_DAYS=30  # Change to desired number of days

______________________________________________________________________

📚 文档

CLAUDE.md -Claude Code项目说明
代理商.md -通用LLM指令
TASK.md -Sprint跟踪和GitHub问题
贡献.md -贡献指南

工具文档

范围经理 - src/core/README.md -范围情报系统
文档获取器 - src/tools/doc_fetcher/README.md -自动获取文档
技能建设者- src/tools/skill_builder/README.md （Sprint 2）
命令生成器- src/tools/command_builder/README.md （Sprint 2）
代理生成器- src/tools/agent_builder/README.md （Sprint 2）

______________________________________________________________________

🗓️ 路线图

Sprint 1：基础（当前）

\[x\] 初始化项目结构
\[x\] 构建范围情报系统
\[\]构建LLM适配器架构
\[\]构建文档提取器
\[\]获取Anthropic/Claude代码文档
\[\]设置每周文档更新

Sprint 2：核心构建器

\[\]构建技能构建工具
\[\]构建命令生成器工具
\[\]构建代理生成器工具
\[\]创建模板库
\[\]构建目录清单系统

Sprint 3：高级构建器

\[\]构建钩子生成器工具
\[\]构建插件构建工具
\[\]构建提示生成器工具
\[\]构建MCP管理器工具

Sprint 4：波兰语和文档

\[\]构建实用程序和验证器
\[\]创建全面的文档
\[\]端到端测试
\[\]准备迁移到~/projects/llms

Sprint 5+：多LLM支持

\[\]添加Codex支持
\[\]添加OpenCode支持
\[\]通用配置格式
\[\]RAG集成

______________________________________________________________________

🤝 贡献

我们欢迎捐款！请看贡献.md 有关以下内容的详细信息：

开发设置
代码样式和标准
测试要求
拉取请求流程

______________________________________________________________________

📋 项目状态

当前版本：v1.0.0-功能实现器v2架构（生产就绪）进展：参见 TASK.md 和

📝 许可证

MIT许可证-请参阅许可证文件以获取详细信息。

______________________________________________________________________

👤 作者

马泰奥·塞维利

业务可扩展性工程师
网站： matteocervelli.com
github： @马托切维利
领英：马托切维利

______________________________________________________________________

🔗 链接

GitHub存储库: https://github.com/matteocervelli/llms
问题: https://github.com/matteocervelli/llms/issues
里程碑: https://github.com/matteocervelli/llms/milestones
人类学文献: https://docs.anthropic.com
Claude代码文档: https://docs.claude.com/en/docs/claude-code

______________________________________________________________________

内置❤️ 意大利托斯卡纳

llms (Matteocervelli)

快速接入

详细介绍

LLM-配置管理系统

🎯 视觉

✨ 特性

当前（Sprint 1-4:Claude代码焦点）

未来（Sprint 5+：多LLM）

🤖 功能实现器v2架构

架构概述

六阶段工作流程

全部14名代理人

生产技能（37）

挂钩配置

用法

质量标准

主要特点

文档

🚀 快速开始

安装

用法

🎯 范围情报系统

范围层次

快速示例

用例

📁 项目结构

🏃 发展

设置开发环境

运行测试

🤖 自动化

每周文档更新

快速设置

启用电子邮件通知（可选）

日志管理

禁用自动化

故障排除

高级配置

📚 文档

工具文档

🗓️ 路线图

Sprint 1：基础（当前）

Sprint 2：核心构建器

Sprint 3：高级构建器

Sprint 4：波兰语和文档

Sprint 5+：多LLM支持

🤝 贡献

📋 项目状态

最近的里程碑

📝 许可证

👤 作者

🔗 链接

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP