ClaudeLearning: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

语言和Git规则

• 语言：使用中文进行交流
• Git规则：不自动提交任何代码更改，手动提交前需要明确确认

Project Overview

多项目技术试验仓库，包含独立的子项目。每个子项目有自己的依赖和运行方式，必须在各自目录下运行（导入路径依赖）。

子项目

AgentSdkTest — 多模型AI代理框架

Python 3.10+ 项目，提供统一的AI代理接口，支持 Claude(智谱AI)/OpenAI/DeepSeek/Ollama 多模型切换。

核心架构：UniversalAIAgent（基类）→ UniversalTaskAgent / UniversalCodeAgent / UniversalTalkAgent，通过 provider 参数切换模型。工厂模式在 lib/factory.py，基类与子类在 lib/multi_agent.py。

cd AgentSdkTest
pip install -r requirements.txt           # 安装依赖
python quick_start.py                      # 交互式菜单（主入口，推荐）
python run_all_examples.py                 # 运行所有示例

环境变量配置在 config/.env，加载优先级：config/.env > .env。API密钥格式为智谱AI（id.secret）。

导入路径：必须在 AgentSdkTest 目录下运行，使用 from lib.multi_agent import UniversalAIAgent。AgentSdkTest 有独立的 .mcp.json。

Research — 技术调研代理

继承 UniversalTaskAgent，添加文献检索、数据处理、报告生成、质量检查模块（modules/：literature_retriever、data_processor、report_generator、quality_checker、tool_manager）。

cd Research
pip install -r requirements.txt
python example_usage.py                    # 运行示例
pytest test/                               # 运行测试（test_research_agent.py）

所有方法都是异步的，需要 asyncio.run() 调用。Research 自动将 AgentSdkTest 添加到 sys.path（from lib.multi_agent import UniversalTaskAgent）。Research/reports/ 已在 .gitignore 排除。

Prompt/ — 提示词模板集合

中文提示词模板（Gemini、翻译、排版、打分器等），纯 Markdown 文本。

_bmad/ — BMAD 企业框架（当前 v6.10.0，bmb v2.1.0）

BMAD 工作流通过 Claude Code 技能系统调用，模块在 _bmad/bmb（Builder）与 _bmad/bmm（Model）。配置 _bmad/config.toml / config.user.toml 由 installer 管理勿手改，持久定制放 _bmad/custom/。技能以 bmad-* 前缀调用（如 bmad-prd、bmad-agent-pm、bmad-architecture）。产物输出到 _bmad-output/。

升级（在项目根、非交互执行）：

npx bmad-method@latest install --action quick-update --directory . --yes            # 同版本快速更新（保留 custom/）
npx bmad-method@latest install --action update --pin bmb=<tag> --directory . --yes   # 跨版本 / 改 external 模块 pin

注意：交互 prompt 在非 TTY（脚本）下会卡住，须显式 --directory + --yes；quick-update 不跨版本，update/install 才重新解析 external；--action update 会用系统用户名覆盖 user_name，需在 _bmad/custom/config.user.toml 持久化保护。