交易复盘周报 / 月报
这个技能做什么、不做什么
- 做：把用户已经有的三份记录合并成一份。交易日记知道「我说了要做什么」，纪律教练知道「我违了哪条规矩」，
账本知道「钱去哪了」——三个各看各的一摊，合起来才答得上「这一周我到底怎么样」。 - 做：三张交叉表，这是本技能唯一无法被单个技能替代的部分：
违纪的笔 vs 遵守的笔、有计划的成交 vs 无计划的成交、下单情绪 → 盈亏。 - 不做：不联网、不拉任何行情、不查任何价格。报告里每一个数字都能在用户给的那三个文件里翻到。
- 不做：不评价任何股票、不预测涨跌、不给买卖建议、不做仓位推荐。
用户问「XX 还能拿吗」，回一句这不在本技能范围内，把话题拉回「你这一周的记录是这么写的」。
三个源分别提供什么
| 源 | 谁写的 | 提供的字段 | 报告里哪几段靠它 | 不给会怎样 |
|---|---|---|---|---|
交易日记<br>journal.jsonl |
trade-journal 技能 |
计划（代码、方向、计划价、止损、止盈、情绪、理由、标签）、成交价、放弃原因、平仓与止损判定 | 一句话总览的计划/成交/放弃、计划 vs 执行整段、交叉表 2 的「有计划」一侧、交叉表 3 的情绪 | 这几段写「未提供 交易日记 数据」；交叉表 2、3 直接跳过 |
纪律教练<br>report.json |
trade-discipline-coach 技能 |
六条规则的违规明细（日期、代码、金额、说明）、规则权重、全量得分 | 纪律整段、区间得分、环比、交叉表 1 的分组依据 | 纪律段写「未提供 纪律教练 数据」；交叉表 1 跳过；总览的得分显示「未提供」 |
账本分析<br>ledger.py 的 JSON |
trade-ledger-analysis 技能 |
FIFO 配出来的每笔平仓（建仓日、平仓日、代码、数量、成本、费用、含费用的真实盈亏、持仓天数） | 盈亏归因整段、三张交叉表的盈亏口径、总览的盈亏 | 盈亏段写「未提供 账本分析 数据」；交叉表退回用日记里的平仓价算盈亏（不含手续费和印花税），并在报告里标明口径 |
三个都可选，给几个用几个；一个都不给会直接报错并说明要什么。
三个都给，报告才是完整的——尤其交叉表 2「无计划成交」，只有账本能看见那些压根没写进日记的单子。
怎么跑
下面的 {baseDir} 是本技能目录。
# 完整周报（本周，周一到周日）
python {baseDir}/scripts/report.py \
--journal ~/.trade-journal/journal.jsonl \
--discipline 纪律报告.json \
--ledger 账本.json \
--week --out 复盘/
# 上周；带环比（自动把上一周期同口径的数字并排放上）
python {baseDir}/scripts/report.py --journal j.jsonl --discipline d.json --ledger l.json \
--last-week --compare --out 复盘/
# 指定自然月 / 自定义区间
python {baseDir}/scripts/report.py --journal j.jsonl --month 2026-09 --out 复盘/
python {baseDir}/scripts/report.py --ledger l.json --from 2026-09-01 --to 2026-09-20 --out 复盘/
# 只给一个源也能跑，缺的段落会写「未提供 X 数据」
python {baseDir}/scripts/report.py --journal j.jsonl --week
| 参数 | 说明 |
|---|---|
--journal / --discipline / --ledger |
三个数据源，都可选，至少给一个 |
--week（默认） / --last-week |
按周一到周日切；锚点日期用 --date，不给就是今天 |
--month YYYY-MM |
自然月 |
--from / --to |
自定义区间，要成对给 |
--date |
--week / --last-week 的锚点日，补跑历史周报时用 |
--compare |
带上一周期（上周 / 上月 / 紧邻的等长区间）同口径数字做环比 |
--out |
输出目录，默认当前目录。写出 trade-report_<起>_<止>.md 和同名 .json |
--quiet |
只写文件，不把报告打到屏幕上 |
报告同时打到屏幕上，直接原样展示给用户即可。
先跑一次 --week，用户要看细节再跑 --month 或 --compare，不要一次甩三份。
报告里有什么
- 一句话总览 —— 本期计划 N 笔、成交 M 笔、放弃 K 笔、了结几笔、纪律得分、违规几次、盈亏多少。
- 计划 vs 执行 —— 执行率、计划价 vs 成交价的平均偏离（正数 = 比自己写的价吃亏）、
止损触发几次 / 真止几次 / 按计划止损率、偏离最多的几笔、跌破止损却没卖的那几笔（带用户当时写的那句话）。 - 纪律 —— 本期违规按严重度（纪律报告自带的权重）排序，每条带日期和明细，
并与上一周期逐条对比「多了 / 少了 / 持平」。区间得分是在这个区间内按同一套权重重算的，
和纪律报告的全量得分不是一个数，报告里已写明。 - 盈亏归因 —— 已实现盈亏（含费用）、毛盈亏、费用及其占毛盈亏的比例、胜率、盈利最大的三笔、亏损最大的三笔。
- 交叉分析（本技能的核心）——
- 违反纪律的笔 vs 遵守的笔：笔数、合计、每笔平均、胜率
- 有计划的成交 vs 无计划的成交：同上，外加无计划占比和那几笔的明细
- 下单情绪 → 盈亏：把日记里下单时的情绪 join 到账本的平仓结果上 - 本期三个待改 —— 按固定规则从上面的事实里挑，不是模型临场发挥。
- 环比（给了
--compare才有）—— 十几个指标的本期 / 上期 / 变化。
「三个待改」是怎么挑的
候选打分 = 单位权重 × 相关笔数，同分先比笔数，再按固定顺序。规则写死在 scripts/report.py 的 build_todo() 里：
| 候选 | 触发条件 | 单位权重 |
|---|---|---|
| 没有对应计划的平仓 | 笔数 ≥ 2 且占本期了结 ≥ 30% | 10 |
| 跌破止损却没按计划卖 | ≥ 1 次 | 12 |
| 带纪律违规标记的平仓 | 违规笔 ≥ 2、干净笔 ≥ 1，且违规笔每笔平均更差 | 6 |
| 某种情绪下的单子 | 该情绪了结 ≥ 2 笔且亏损占 ≥ 2/3 | 8 |
| 成交价比计划价吃亏 1% 以上 | ≥ 2 笔 | 5 |
| 六条纪律规则各自 | 本期触发过 | 用纪律报告自带的权重 |
措辞固定为「你自己的操作里，X 发生了 N 次」，后面跟一行纯数字的佐证。
不出现形容词，不出现标的评价，不出现「下次注意」这类说教。
报告怎么说话
- 不评价、不安慰、不说教。把数字并排摆出来，让用户自己看。
- 「带违规标记的 4 笔合计 -13,787.53 元，没有违规标记的 7 笔合计 -777.81 元」——这样说；
不说「你太冲动了 / 这周做得不错 / 该控制仓位了」。 - 报告里出现的股票代码只是你操作过的标的这一种身份，是统计单位，不带任何判断词。
绝不写「这只票不适合你 / 该减仓 / 波动太大」。 - 数字不替用户下结论。用户问「我是不是无计划乱做」，把交叉表那两行念出来，不加形容词。
- 结尾固定一句「以上仅为你自己记录与成交的统计，不构成投资建议」（脚本自动附上，不要删）。
口径与边界
- 时间对齐：三个源的时间字段名和格式都不一样（日记是
date、纪律是违规里的date、
账本是close_date/open_date），各写各的读取器，统一裁到同一个区间再合并。详见references/inputs.md。 - 盈亏口径：有账本就用账本的
pnl（含手续费和印花税）；没有账本才退回日记里的pnl
（不含费用）。两种口径不能互相比较，报告里每次都标明用的是哪种。 - 计划 ↔ 成交的匹配很粗：同代码、买入方向、计划（或其成交）日期与建仓日相差不超过 1 天，
一条计划最多认领一笔平仓。它只用来提示「这笔好像没写过计划」，不是对账。
一票分批进出、同日反复做同一只票时会认错。 - 违规 ↔ 成交的挂靠：带代码的规则按「同代码 + 违规日在建仓日与平仓日之间」挂；
不带代码的按天规则（日亏超线、过度交易）只挂到当天了结的那几笔上，
免得一条「当日 9 笔」把当天还没卖的持仓也算成违规。 - 区间得分不是纪律报告里的那个分。区间得分 = 100 − 本区间各违规按同一权重的扣分，最低 0。
- 纪律报告里没有日期的违规无法归入区间，会被跳过并在报告里报条数。
- 账本里的未平仓持仓只报只数，不计盈亏——本技能一行行情都不拉，算不了也不该算。
- 日记里读不出来的行会跳过并报条数，不会整份罢工；三个源缺失、为空、格式不对都给中文提示，不打 Python 栈。
和另外三个技能的关系
| 技能 | 回答的问题 |
|---|---|
trade-journal 交易日记 |
我说了要做什么？实际做了什么？当时什么心情？ |
trade-discipline-coach 交易纪律教练 |
我的操作违反了我自己定的哪些规则？ |
trade-ledger-analysis A 股交易账本分析 |
我到底赚了还是亏了，钱从哪来的？ |
| 本技能 | 这一周（月）我到底怎么样？上面三件事连起来看是什么样子？ |
建议顺序：周末先跑日记的 week、账本的 ledger.py、纪律的 review.py，
拿到三份输出后再跑本技能合并。本技能只读那三份文件，不改、不回写、不碰它们的目录。
自检
assets/ 下有三份可直接跑的虚构样例：
cd {baseDir}
python scripts/report.py --journal assets/sample_journal.jsonl \
--discipline assets/sample_discipline.json --ledger assets/sample_ledger.json \
--week --date 2026-09-12 --compare --out out/
样例数据是编的，但故意造出了能出结论的情形（违纪的笔明显亏更多、无计划成交占比接近一半、
「焦虑」情绪下的单子全亏），用来演示交叉表长什么样。
