Chanlun Trading System（缠论分析 Skill）

把缠中说禅（缠论）的技术分析体系，变成一套可执行、可复核、不自欺的看盘与研究流程：图形诊断 → 结构判定 → 信号识别 → 失效点 → 回测规则化。

⚠️ 免责声明：本 Skill 仅用于技术研究与学习。它不构成投资建议，不给具体买卖指令，不承诺任何收益。缠论是一套技术分析框架，存在主观性与失效风险，任何据此产生的盈亏由使用者自负。本 Skill 的最大价值在于强制纪律——让分析"先定级别、先认结构、先写失效点"，而不是给你一个"必涨信号"。

它解决什么问题

缠论难学、易被滥用：很多人把"指标金叉/MACD 底背离"直接喊成"买点"，把"突破"喊成"三买"，结果在震荡里反复挨打（whipsaw）。本 Skill 用一套**门控（gate）**逼着分析走完整结构链，任何一步缺失就自动降级为"观察"而不是"确认买入"。

三种运行模式（必须先声明用的是哪种）

• strict_chanlun：有足够的多级别 K 线/图形细节，能完整判断包含、分型、笔、线段、同级别中枢、背驰、低级别触发——不跳过递归结构链时才用。
• structure_proxy：能复现 K 线包含、分型、笔、类中枢重叠，但线段/走势类型做了简化。
• proxy_research：只有日线、波段或指标数据时用。必须明确标注"近似损失"，绝不把代理信号当成严格的缠论原文定义。

默认姿态：从 strict_chanlun_audit（严格原文自检）起步，只有在点名缺了哪一步结构之后才降级。

不可妥协的规则（Non-Negotiable Rules）

1. 永远先定操作级别。没有级别，就没有有效的买卖点。
2. 区分 original_definition / segment_proxy / swing_proxy / kline_proxy / indicator_proxy 五种定义口径。
3. 结构优先：走势类型 → 级别 → 中枢 → 背驰/力度 → 买卖点 → 过滤器。
4. 不把小级别背驰直接当成大级别反转，除非检验了"小转大"的条件。
5. 每个入场都要写明：依据、触发、失效点、下一个观察点。
6. MACD/RSI/成交量/换手/资金流/趋势线/均线/筹码等技术过滤器只调整信心、等待纪律或仓位，不定义缠论买卖点。
7. 数据不足以做严格的分型/笔/线段/中枢时，明确降级为代理分析。
8. 结构不清时，宁可等待，不强行交易。
9. 有图（截图/书图/手绘）时，先读图，再依赖周边文字。
10. 任何信号，先记录"什么情况下它失效"，再讨论潜在收益。
11. 没点名"前一个同级别趋势"或"下跌+中枢+下跌"的上下文、没识别被比较的同向走势之前，不喊一买/一卖。
12. 没点名"一买候选 + 它的第一次回抽测试"之前，不喊二买/二卖。
13. 没点名"中枢边界、离开、回拉、不回/再入"全部状态之前，不喊三买/三卖。
14. 回测产信号时，必须暴露这些列：trade_level / confirm_level / trigger_level / definition_mode / structure_completeness / approximation_loss。

严格原文自检门（Strict Original Audit Gate）

任何操作性结论之前，过这道门：

1. level_gate：点名 review_level / trade_level / confirm_level / trigger_level。
2. structure_gate：按"包含 → 分型 → 笔 → 线段 → 中枢"的顺序构建或引用。
3. type_gate：把当前同级别状态归类为 趋势 / 盘整 / 中枢延伸 / 中枢突破 / 转折 / 不明。
4. comparison_gate：用背驰时，点名被比较的两段同向走势，并确认它们同级别。
5. buy_sell_gate：上述门通过后，才把结构映射到一/二/三类买卖点。
6. trigger_gate：要求低级别触发，或显式标注 trigger_missing。
7. risk_gate：先写失效点，再谈收益。
8. downgrade_gate：任一门不过，输出 proxy_research 或 observe，而不是 buy_confirmed。

被禁止的捷径：指标背离→一买；突破→无回抽的三买；更高的低点→无一买上下文的二买；30 分钟均线/MACD 状态→当成 30 分钟结构；日线信号+30 分钟指标确认→冒充严格多级别缠论信号。

默认工作流（8 步）

1. 背景：确认标的、周期、目的、约束；设 trade/confirm/trigger 级别（中线=周/日/30m；波段=日/30m/5m；短线=30m/5m/1m）；声明输出是 strict / structure_proxy / proxy_research。
2. 结构：有图有数就识别包含、分型、笔、线段、中枢、当前态；只有文字时给假设+清单，不假装看到图。（读图见 references/visual-reading.md，结构判定见 references/structure-engine.md，概念冲突见 references/concepts.md）
3. 状态：用一个当前态标签（center_oscillation / center_extension / center_breakout / uptrend / downtrend / transition_zhongyin / first|second|third_buy_candidate / 卖侧镜像 / untradable_unclear），先点名最近有效中枢及其 zg/zd 边界。
4. 信号：找候选买卖点并说明理由；背驰必须先点名被比较的两段。（细则见 references/buy-sell-playbooks.md，多级别/区间套/小转大见 references/multi-level-recursion.md）
5. 动作：用动词 wait / observe / buy_probe / buy_confirmed / hold / reduce / sell_exit / rebuy / reject，附失效点+下一观察点。（仓位/风险见 references/invalidation-risk.md）
6. 过滤器：结构归类完成后，才叠加 MACD/RSI/量/换手/资金流/趋势线/均线/筹码。（见 references/filters.md、references/volume-turnover-money.md）
7. 回测：要做策略/代码时，从一个最小闭环起步，严格定义与可测代理分列输出。回测硬数字与"风控非选股"的诚实口径见 references/empirical-evidence.md。（结构化代理规则见 references/backtest-proxies.md）
8. 自检：新规则或重要结论，对照常见假阳性复核。（见 references/self-test-cases.md）

可视化请求

当用户要求“画出来 / 多周期标注 / 交互查看 / 导出分享”时，优先使用本仓库的本地工作台（见 references/visual-workbench.md），并遵守：

1. 数据必须来自用户 CSV、内置合成示例或显式标注的可选公开行情源；不把合成数据当市场事实。
2. 图上每个分型、笔、线段代理、中枢和背驰对象必须能回到原始 K 线范围及 confirmed_at / available_at。
3. 多周期结果分层展示，不把 5m/30m 指标状态冒充日线结构确认。
4. U1 多角度力度只作为可切换对照证据，不自动覆盖 MACD 基线或升级买卖点。
5. 导出必须保留 definition_mode / approximation_loss / as_of / input_sha256 / execution_allowed=false。

工作台调用协议

1. 先运行 chanlun-visual doctor --json；只把 pass / pass_with_warnings 当作可启动，不把命令存在等同于行情可用。
2. 若找不到命令，说明运行时与 Skill 分开安装，给出 references/visual-workbench.md 中的固定版本安装命令并等待用户授权；不得静默安装。
3. 默认运行 chanlun-visual，只监听 127.0.0.1:8791。除非用户明确要求并理解风险，不绑定局域网或公网地址。
4. 优先使用内置合成示例或用户 CSV。可选公开行情失败时展示逐周期失败原因并回到 CSV，不把缺失历史补零。
5. 若只需机器检查或启动，可运行 python scripts/skill_workbench.py check --json 或 python scripts/skill_workbench.py launch。

输出模板

**级别**
- trade_level / confirm_level / trigger_level / definition_mode / structure_completeness / approximation_loss

**结构**
- current_state / center / trend|oscillation / compared_movements

**信号**
- buy|sell class / divergence / confirmation / lower_level_trigger

**动作**
- action / basis / trigger / invalidation / next watch

何时加载哪个 reference

文件	用途
concepts.md	定义、源头层级、核心术语、状态分类
strict-original-system.md	原文自检门、严格/代理降级矩阵、编码契约
structure-engine.md	K线包含、分型、笔、线段、中枢、延伸/扩张
visual-reading.md	图截图、书图、作者手绘图
visual-workbench.md	本地可视工作台、CSV 契约、图层、时点回放与导出
buy-sell-playbooks.md	一/二/三类买卖点流程、利润最大化模式、小转大
multi-level-recursion.md	区间套、小转大、同级别分解、大小级别冲突
filters.md	MACD、RSI、趋势线、均线、筹码、板块强度
volume-turnover-money.md	量、换手、资金流的匹配规则
invalidation-risk.md	失效模式、止损、仓位、持有/减仓逻辑
backtest-proxies.md	把缠论变成可复现的代理规则
empirical-evidence.md	大样本回测硬数字：买点是试探非 alpha、卖点的风控价值、延迟敏感性
self-test-cases.md	常见假阳性、复核清单、可复用 case prompt

怎么用（安装）

这是一个标准的 Agent Skill，分析规则与可视工作台运行时分开安装：

• Codex / OpenAI：从 GitHub 安装本 Skill，或把发布版 Skill ZIP 解压到 $HOME/.agents/skills/chanlun-trading-system/。需要可视界面时，再按 references/visual-workbench.md 安装 chanlun-visual。
• Claude Code：把发布版 Skill 目录放进 ~/.claude/skills/chanlun-trading-system/，新会话重新加载。
• 其他 Agent / 本地模型：加载 SKILL.md，需要细节时再按表读取对应 references/*.md。
• 不会写代码的人：可使用仓库中的通用 AI Markdown；要获得完整交互界面，使用后续签名桌面安装包或由可信的人协助安装本地运行时。

来源与致谢

• 缠论（缠中说禅技术分析体系）原创归属 缠中说禅，本 Skill 是对其公开理论的操作化整理与研究性解读，用于学习与交流。
• 工作流设计参考了对原著《教你炒股票》及多本技术注解/图解/实战书的交叉精读，并以"严格原文 vs 可测代理"的分层来抑制过拟合。
• Skill 文件按仓库 MIT License 发布；缠论理论原始权利归其原作者。