invest-skills — 可复核的 A 股研究技能集

每个数字可复核的 A 股投研助手。 输入代码，自动采集公开数据、由 Python 引擎完成计算，并输出带来源、口径与不确定性标注的研究备忘录。它将手工研究中最易出错的环节——数据取数、计算、交叉验证与证据整理——固化为可检查的流程；是学习与研究工具，不是投资决策工具。

普通 AI 给你「看起来对的分析」；invest-skills 给你一份每个数字都能回溯到来源的研究备忘录。

定位声明：本项目是开源软件工具，不从事证券投资咨询业务，未取得证券投资咨询业务资格；不推荐个股、不提供买卖或仓位建议、不承诺收益。完整边界见免责声明。

为什么值得使用

研究链条

flowchart TB
    A["Skill 层<br/>对话入口 → 研究备忘录"]
    B["规则层<br/>16 条法则 · 三层复检 · 禁止买卖建议"]
    C["引擎层<br/>多源并行采集 · Python 计算全部数字"]
    D["存储层<br/>SQLite 快照 → diff 回溯"]
    A --> B --> C --> D

这个链条的关键不是“自动写报告”，而是将研究中的证据责任落到可检查的层次：数据源失败会被记录；跨源数值冲突不会被悄悄抹平；无法证实的判断必须标注边界；技术指标仅描述市场状态，不生成交易信号。

能做什么

扫描或形态检出只说明数据是否满足预设定义，不构成交易信号或操作建议。

数据、计算与输出标准

报告遵循以下最低标准：

• 事实注明来源；分析注明依据；无法验证的内容明确标记为「待验证」。
• 分位数不脱离历史中位数使用；多源冲突并列呈现，不伪造确定性。
• Bull/Bear 需要给出可检查的数值传导与条件，而非形容词堆砌。
• 所有结果是本地 SQLite 快照；项目不跟踪、不上传用户的查询或持仓信息。

详细规则见 invest-a-stock SKILL.md 与配置说明。

从一份报告看证据如何保留

真实历史输出 000338 潍柴动力（2026-07-21） 展示了系统不回避不确定性的方式：

更多真实运行快照：中际旭创复盘、科创 50 ETF、市场脉搏。这些都是历史样例，仅用于展示格式与方法，不代表当前市场状态。

开始使用

选择你使用的平台即可；完整配置、Token 可选项与故障排查集中在 CONFIGURATION.md，避免在这里重复维护教程。

WorkBuddy

从 GitHub Release 下载 invest-skills-wb-vX.Y.Z.zip，在 WorkBuddy 的「专家·技能·连接器 > 技能 > 添加技能 > 上传技能」导入即可，无需打开终端。安装后填写 Token 的方式见 docs/workbuddy/。

Windows 用户若改用 git clone：默认 core.symlinks=false 会把仓库 36 条技能链接物化成文本文件，导致技能发现失效。运行重建脚本（NTFS junction 重建 27 个目录链接 + 硬链接重建 9 个 commands 文件，无需管理员权限，幂等；数量与 skills/ 目录一一对应）：

git config core.symlinks true        # 可选但推荐（避免再物化）
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned   # 若策略拦截 .ps1
.\scripts\setup_workbuddy_windows.ps1

验证：cmd /c dir .workbuddy\skills 应显示 <JUNCTION>。

开发与项目资料

项目以 SKILL.md 开放格式分发，核心代码与测试位于 skills/；命令行参考见 docs/cli.md，贡献规范见 CONTRIBUTORS.md，版本记录见 CHANGELOG.md。开发校验：uv sync && uv run pytest。

免责声明

• 工具定位：本项目提供公开数据的采集、计算、整理与学习框架，不提供投资意见，不从事证券投资咨询业务。
• 不构成投资建议：任何输出，包括基于明示假设的多情景估值，均不是买卖建议、目标价预测、要约或收益承诺；使用者应独立核验和决策。
• 数据限制：公开数据可能延迟、缺失、口径不一致或错误。报告会标注冲突与不可得维度，请以公司公告、交易所和原始资料为准。
• 风险自担：投资有风险；项目不推荐个股、不提供仓位建议，也不承诺任何收益。

License

MIT · 本地运行 · 不跟踪不上报