24KRMB/Financial-Analyst

简介

这是一个Workspace (generated by AI agents)

项目结构

Financial-Analyst/
├── AGENTS.md        # 子代理架构与调度逻辑
├── HEARTBEAT.md     # 生物钟与自动心跳机制
├── IDENTITY.md      # 身份定义、核心能力、行为准则
├── MEMORY.md        # 长期记忆与知识沉淀
├── SOUL.md          # 灵魂内核、性格特质、语气风格
├── README.md        # 项目说明文档
└── skills/          # 可复用技能集目录
    └── skill-name/
        ├── SKILL.md                 # 技能核心描述与元数据
        ├── scripts/                 # 可执行脚本 (Python等)
        ├── resources/               # 配置文件与Prompt模板
        ├── tests/                   # 测试用例与评估标准
        ├── agents/                  # 代理模板与输出示例
        ├── references/              # 扩展专业知识文档
        ├── assets/                  # 图标、K线图等静态资源
        ├── README.md                # 技能使用说明
        ├── PROVENANCE.md            # 来源与变更记录
        └── CHANGELOG.md             # 变更日志

前置条件

在部署与运行本项目之前，请确保您的环境满足以下条件：

1. AI 运行环境：需具备支持多 Agent 调度与大语言模型调用的基础环境。
2. Python 环境：Python 3.10~3.13（用于运行 skills/ 目录下的量化脚本与数据处理脚本）。
3. 依赖库：具体依赖请参考各 Skill 内的 scripts/ 及 resources/config.yaml，通常包括：
   • 数据处理：pandas, numpy,xlrd
   • 量化与可视化：matplotlib
   • 技术分析库：talib
4. 数据源权限：部分代理需要配置相应的行情 API Key 或数据源访问权限。
5. 笔记软件（可选）：如需启用代理的联动功能，需提前配置 Obsidian 或 Notion 的本地路径或 API。

运行方法

1. 获取项目代码

   git clone https://github.com/24krmb/Financial-Analyst.git
   cd Financial-Analyst

2. 配置身份与密钥

   • 阅读 IDENTITY.md 与 SOUL.md 了解助理的初始化设定。
   • 在 resources/config.yaml 中填入必要的 API 密钥（如行情数据源、LLM 模型密钥等）。

3. 启动主控服务 根据您使用的 Agent 框架，加载 AGENTS.md 中定义的调度逻辑，启动多代理工作流。

4. 调用技能 (Skills) 您可以通过向主代理发送指令来触发特定技能，例如：

   • “拉取当前A股涨停板数据” -> 触发 MarketHawk
   • “回测双均线策略” -> 触发 QuantCraft 运行 scripts/main.py

构建与开发

开发新 Skill 流程：

1. 在 skills/ 目录下按照标准目录结构创建新文件夹。
2. 编写 SKILL.md 定义技能用途与流程。
3. 在 scripts/ 中实现核心逻辑，在 tests/ 中编写测试用例与评估标准，在 agents/ 中编写代理模板与输出示例。详细参考 项目结构中的 skill-name/
4. 提交代码：git commit -m "feat: 添加 XXX 技能"

本项目采用约定式提交Conventional Commits规范进行版本控制，开发与提交代码时请遵循以下格式：

<type>: <subject>

常用的 type 类型：

• feat: 新功能（如：添加新的数据源）
• fix: 修复 bug（如：修复图表显示问题）
• docs: 文档更新
• refactor: 重构代码
• test: 测试相关
• chore: 构建或辅助工具变动

⚖️ 许可证信息

本项目版权归 24KRMB.COM 所有。具体开源协议请参考仓库根目录下的 LICENSE 文件。

⚠️ 免责声明

本助理仅供内部研究参考，不构成任何投资建议。 金融市场具有高风险性，基于 AI 代理产生的分析结果、策略建议与交易执行均存在不确定性，请使用者自行承担相关风险。

关于我们

官方网站：24KRMB.COM