invest-skills: Instructions file for Claude Code

CLAUDE.md — invest:a-stock 投研助手

底座准则（复杂度控制）

本仓库是多个下游项目的底座（skillhub 镜像、WorkBuddy 分发、跨 harness 兼容等均依赖其既有约定）。因此：

• 兼容性不可轻动：frontmatter 格式、SKILL.md 结构、多 harness 兼容性是对下游项目的承诺，任何改动须先评估对全部下游项目的影响
• 目录结构不可轻动：skills/ 布局与路径约定是既有契约
• 复杂度受控：新能力优先落在下游项目（如 invest-skills-skillhub），底座只收共享核心；改动从简，不叠架构

对外内容红线（公开渠道）

适用于一切面向不特定对象的公开发布：GitHub 仓库与 README、docs/demos/、技术社区文章、分发平台描述与截图。 与 LAW 6 互补——LAW 6 管报告写什么，本节管什么可以公开发。合规判断的关键不是「免费」，而是「是否面向不特定对象发布个股倾向性内容」。

红线	规则
个股产出不进公开仓库	日常研究产出一律留在本地 reports/（已 gitignore）。公开仓库只保留经脱敏审查的 demo，新增 demo 须走本节检查
公开 demo 三项强制	① 首行头部免责声明 ② 无方向性倾向表述（「一致看多」「强烈信号」「安全边际吃尽」等）③ 明示为历史快照、不代表当前状况
对外文章只讲方法论	技术社区/周刊/分发平台的宣传素材只讲工程实现与方法论（P0 计算铁律、三层复检、多源降级链），不以个股分析作为宣传素材
不导流、不变现个股观点	「间接有偿」会使「免费」这道防线失效：禁止开户导流/返佣、付费荐股、打赏换观点。任何变现方案启动前须重做合规评估
渠道选择	优先开发者渠道（掘金/HN/阮一峰周刊/ClawHub/skillhub）；股民向渠道（雪球/知乎/公众号）仅发方法论，且须先核对平台资质要求。小红书等已明确「仅持牌机构」的平台不发

变更本节前须重新评估合规影响。背景分析见 host-docs/v0.2.7/directions-research-2026-08-18.md §5.4。

版本规则

• 最多三位：v{major}.{minor}.{patch}
• 小幅迭代递增末位：v0.1.3 → v0.1.4 → ...
• 同版本内多次修订用日期区分，不自创四位版本号
• Git 分支：feat/v{version}

版本号同步（统一修改）

canonical 源：pyproject.toml 的 [project].version（运行时经 version.py 读取）。

禁止手动改多处版本号。pyproject.toml 为唯一 canonical 源，scripts/sync_version.py 同步全部派生文件：

bash scripts/bump-version.sh X.Y.Z   # 或: uv run python scripts/sync_version.py bump X.Y.Z
uv run python scripts/sync_version.py check

运行 bump 后务必执行分支重命名（如当前分支是 feat/v0.1.5，重命名为 feat/v0.1.6）。

版本一致性仅在发布/CI 时校验（sync_version.py check），不在 Skill 运行时或 SessionStart 钩子中执行。

运行命令

# 所有命令必须用 uv run python，确保从 .venv 加载依赖
uv run python skills/invest-a-stock/scripts/invest.py <subcommand> <symbol> [--flags]

# 常用子命令
diagnose     # 检查数据源可用性
collect      # 采集数据（--with-news-pack 新闻三层架构）
report       # 生成报告
compare      # 双标的对比
diff         # 对比两次快照
store list   # 历史采集记录
rigor        # 财务验算（市值/估值/跨源）
audit        # 报告审计 extract/verdict
check        # 单标的质地检查（7 指标）
portfolio    # 组合风险特征
thesis       # 投资假设追踪
shock        # 价格冲击插值比例