技术分析报告模板详解:claude-trading-skills 中 technical-analyst 的十段式输出规范

原创2026-11-15 10:12:562,657 阅读
文章标签:金融科技AI 技能人工智能数据分析

技术分析报告模板详解:claude-trading-skills 中 technical-analyst 的十段式输出规范

技术分析容易写成主观叙事,真正的工程难点在于让每次分析都能复现、可比较受力点,并且验收标准一致。claude-trading-skills 仓库里的 analysis_template.md 正是为此设计的“报告契约”:它把一份周线技术分析拆成 10 个强制小节,从趋势、支撑阻力、均线、量能、形态,一直到概率化情景、摘要与免责声明。本文以该模板为主体,逐节拆解每个字段的填写要求,并结合 SKILL.md、technical_analysis_framework.md 与契约测试 test_skill_contract.py,说明模板在真实工作流中如何被加载、填充与校验。读完后你可以把这个模板直接当作可复用的报告骨架,写出结构完整、逻辑自洽、可被下游技能消费的周线技术分析报告。


一、模板在技能体系中的位置:它是“输出契约”,不是“建议格式”

在 technical-analyst 技能里,一份分析报告的生产被切成六个步骤,而模板只出现在第 5 步:

Step 1 接收图表图片 → Step 2 加载方法论 → Step 3 逐图系统分析
→ Step 4 构建概率情景 → Step 5 用模板生成报告 → Step 6 多图逐张重复

对应原文:

Read and use as template: assets/analysis_template.md

这意味着模板的职责边界很清晰:它不负责“怎么分析”,只负责“分析结果怎么落纸”。方法论由 technical_analysis_framework.md 提供,模板只规定“必须回答哪些问题、答案放在哪一节”。

这种分离带来两个工程收益:

  1. 模板可被机器校验。模板是文件系统中的一个真实资产,只要它存在、并且被 SKILL.md 以正确相对路径引用,就说明技能的提示契约完整。这一点由契约测试硬编码保证。
  2. 报告可被比对与复读。所有报告都遵循同一套 10 节顺序,跨标的、跨时间的横向读取成本被压到最低。

模板与小节的强制对应关系

SKILL.md 明确列出报告必须包含的 10 个部分,并与模板文件的一级标题严格一一对应:

序号 模板小节 核心回答问题
1 Chart Overview 这张图是什么、当前在哪里
2 Trend Analysis 趋势方向、强度、持续时间与结构
3 Support and Resistance Levels 关键支撑、关键阻力的具体价位与理由
4 Moving Average Analysis 20/50/200 周均线的位置、排列、斜率、交叉
5 Volume Analysis 量能是否确认价格
6 Chart Patterns and Price Action 形态与近期价格行为
7 Current Market Assessment 综合判断与最重要的观察
8 Scenario Analysis 2–4 个概率情景,含目标位与失效位
9 Summary 最可能结果、关键观察位、风险提示
10 Disclaimer 纯技术、概率化、非投资建议

注意第 8 节在 SKILL.md 中被注明为 “2-4 scenarios with probabilities”;因此模板虽然只铺了 4 个情景槽位,但第 4 个槽位标注为 (Optional):

### Scenario 4 (Optional): [Scenario Name] - **[XX]% Probability**

这说明“3 个情景”是合规下限的常见形态,“4 个”是上限,二者都被模板容纳。


二、报告头部:五个元数据字段

模板最上方是四个定位字段和一个分隔线:

# Technical Analysis Report

**Ticker/Symbol**: [Symbol Name]
**Timeframe**: Weekly
**Analysis Date**: [YYYY-MM-DD]
**Analyst**: Claude Technical Analyst

---

这四个字段的取值约束,在仓库其它位置有明确依据:

  • Ticker/Symbol:必须与输出文件名中的 [SYMBOL] 一致。文件名规则是 [SYMBOL]_technical_analysis_[YYYY-MM-DD].md,示例为 SPY_technical_analysis_2025-11-02.md。符号一致是下游脚本按路径取报告的前提。
  • Timeframe:模板已把值写死为 Weekly,这是技能的核心身份约束。前置条件明确要求 “Chart Images: User must provide weekly timeframe chart images”,SKILL.md 的对比确认模式里也重申 “Weekly timeframe only”。日线图不应套用本模板的报告口吻而不加说明。
  • Analysis Date:采用 YYYY-MM-DD 格式,与文件名中的日期保持一致,便于按时间序列排序。
  • Analyst:固定署名 Claude Technical Analyst,用于在 reports/ 目录中区分人工报告与技能产出。

从源码结构看,这里的日期字段目前只用于命名与阅读,不参与计算;而对比确认模式(见第八节)另有一套带 run_context.as_of 的数据截止逻辑。两者不要混用。


三、第 1 节 Chart Overview:用一句话锁定上下文

## 1. Chart Overview

[Brief description of what the chart shows - instrument type, current price level, etc.]

这一节是全篇最短、但最容易被省略的一节。占位符明确要求三件事:品种类型、当前价格水平、图表覆盖范围。

为什么不能省:模板的其余九节都在做“相对判断”(相对前高、相对均线、相对支撑),而相对判断需要一个锚点。第 1 节就是这个锚点——它告诉后来的读者,后面的 [Price Level 1] 究竟处在什么量级的坐标系里。技能适用的品种范围包括股票、股指、加密货币与外汇(见 SKILL.md 的 When to Use),而这些品种的价格量级差异极大,缺少锚点会让整份报告失去可读性。


四、第 2 节 Trend Analysis:方向、强度、时长三件套

结构骨架

## 2. Trend Analysis

### Current Trend
- **Direction**: [Uptrend / Downtrend / Sideways]
- **Strength**: [Strong / Moderate / Weak]
- **Duration**: [How long has this trend been in place]

### Trend Details
[Detailed analysis of the trend structure - higher highs/lows, lower highs/lows, etc.]

三个字段都是枚举 + 白话理由的组合。枚举值并非随意设定,它们与方法论文档的分类标准一一对应:

方向 方法论判据(framework §1)
Uptrend 更高的高点与更高的低点(HH/HL);价格在关键均线之上;均线呈多头排列(短周期 > 长周期)
Downtrend 更低的高点与更低的低点(LH/LL);价格在关键均线之下;均线呈空头排列
Sideways 无清晰 HH/HL 或 LH/LL;价格在既定支撑阻力间来回;均线走平或交织

Strength 的判据同样来自方法论:强趋势对应连续的高低点推进、回撤浅、量能配合方向;弱趋势对应高低点凌乱、回撤超过前一段行情的 50%、价格与量能背离。

Duration 是三者中最容易被写成空话的字段。模板要求 “How long has this trend been in place”,实践中应优先用周数而非模糊词汇(例如“约 34 周”而不是“有一段时间”),因为周线图上的一根 K 线就是一周,周数可以由图上的价格行为直接数出。

Trend Details 该写什么

该字段承接的是结构描述,而不是重复上面三个标签。方法论给出的可写素材包括:更高高点/更高低点的序列是否完整、最近的推进是否被破坏、趋势末端的衰竭信号(动能递减、量能下滑、价格远离均线、出现射击之星/锤子/吞没等反转 K 线)。

方法论在 “Trend Exhaustion Signals” 一节把这些列成清单,模板的 Trend Details 就是清单的落点。若图表确实没有衰竭迹象,也应当明确写“未见明显衰竭信号”,而不是留空。


五、第 3 节 Support and Resistance Levels:价位必须带理由

结构骨架

### Key Support Levels
1. **[Price Level 1]**: [Description - why this level is significant]
2. **[Price Level 2]**: [Description]
3. **[Price Level 3]**: [Description]

### Key Resistance Levels
1. **[Price Level 1]**: [Description - why this level is significant]
2. **[Price Level 2]**: [Description]
3. **[Price Level 3]**: [Description]

### Support/Resistance Notes
[Additional observations about S/R dynamics, role reversals, or confluence zones]

三个支撑位、三个阻力位是模板的默认密度。这个“3”不是硬性上限,但它与方法论对“有效支撑/阻力”的判定标准相呼应:

  • 有效支撑:价格至少从该位反弹 2–3 次;反弹时伴随量能放大;时间跨度越长权重越高;整数关口常构成心理支撑。
  • 有效阻力:价格至少从该位被拒绝 2–3 次;拒绝时放量;此前的重要高点;整数关口。
  • 强弱分级:3 次以上触及、存续数月到数年、历史触及处放量、与其它技术因子(斐波那契、整数关口、均线) confluence ⇒ 强;仅 1–2 次触及、形成时间短、触及处量能低 ⇒ 弱。

合起来看,模板要求“每个价位都写清 why this level is significant”,本质上是在逼作者把上面这组判据显式化。写“$182.40:前两次周线级反弹起点,且与 50 周均线重合”比写“支撑在 182 附近”有效得多。

Support/Resistance Notes 的价值

这一栏是模板里少数专门为“角色互换”留出位置的字段。方法论明确:支撑被跌破后常在回抽时转为阻力,阻力被突破后常在回踩时转为支撑。这种 role reversal 以及多点重合的 confluence 区域,无法塞进“支撑 1/2/3”的有序列表,因此单独给了备注栏。同一栏也适合记录:趋势线支撑/阻力、动态均线支撑与静态水平的叠加区域。


六、第 4 节 Moving Average Analysis:三条周线均线的固定剧本

结构骨架

### Current MA Structure
- **Price vs 20-week MA**: [Above / Below / At] - [Current relationship]
- **Price vs 50-week MA**: [Above / Below / At] - [Current relationship]
- **Price vs 200-week MA**: [Above / Below / At] - [Current relationship]

### MA Configuration
- **Alignment**: [Bullish / Bearish / Neutral]
- **Slope**: [Rising / Falling / Flat]
- **Crossovers**: [Any recent or pending crossovers]

### MA as Support/Resistance
[Observations about MAs acting as dynamic support or resistance]

模板把均线周期固定为 20 / 50 / 200 周,这在方法论里给出了明确的时间含义:

均线 定位 大致等价时长
20 周 MA 短期趋势指标 约 4 个月
50 周 MA 中期趋势指标 约 1 年
200 周 MA 长期趋势指标 约 4 年

三个 Price vs xx-week MA 字段共享同一组枚举:Above / Below / At。方法论给出的组合解释是:价格在三线之上 ⇒ 强多头结构;三线之下 ⇒ 强空头结构;夹在均线之间 ⇒ 过渡阶段,趋势不明。最后这种状态恰恰是最需要如实标注的,因为模板的枚举里不存在“不清楚”以外的模糊选项。

Alignment 对应方法论中的均线排列规则:

  • Bullish:20 周 > 50 周 > 200 周,且三线均上行;
  • Bearish:20 周 < 50 周 < 200 周,且三线均下行;
  • Neutral:走平、交织或排列不成立。

Crossovers 字段绑定两个具名信号:

  • Golden Cross:20 周 MA 上穿 50 周 MA(看多);
  • Death Cross:20 周 MA 下穿 50 周 MA(看空)。

注意枚举里写的是 “recent or pending”,即尚未发生但即将发生的交叉也属于该字段的合法内容。这与方法论“Compressed/Converging MAs: Often precedes significant directional move”(均线压缩往往预示大幅方向性移动)的观察直接挂钩。

MA as Support/Resistance 则承接方法论中“上升趋势里 20 周与 50 周均线常提供动态支撑、下降趋势里提供动态阻力、反复在同一条均线上反弹或受阻会提升其重要性”的判断。


七、第 5 节 Volume Analysis:让量能给结论,而不是罗列数字

结构骨架

### Volume Trend
[Description of recent volume patterns - increasing, decreasing, or stable]

### Volume Observations
- [Key observation 1 - e.g., volume spike at support]
- [Key observation 2 - e.g., declining volume on rally]
- [Key observation 3 - e.g., volume divergence]

### Volume Confirmation
[Assessment of whether volume confirms or contradicts the price action]

这一节的三个子块构成一条推理链:趋势 → 现象 → 结论。

Volume Observations 的占位符直接给了三个范例,对应三类高价值观察:

  • volume spike at support:支撑处放量反弹 ⇒ 买盘意愿强(偏多);
  • declining volume on rally:上涨过程中量能递减 ⇒ 上行缺乏信心(偏空);
  • volume divergence:价格新高但量能下滑(看空背离)或价格新低但量能下滑(看多背离)。

Volume Confirmation 是唯一的结论位,必须回答“确认还是矛盾”。方法论给出的四象限可以直接作为判定表:

价格 量能 方法论解读
上涨 放大 健康上升趋势,买盘强劲
下跌 放大 健康下降趋势,卖盘强劲
上涨 萎缩 上行偏弱,缺乏信心
下跌 萎缩 下行偏弱,卖压可能衰竭

此外还有两类必须落进本节的现象:突破时的量能(放量突破验证有效性,缩量突破常导致假突破)与量能高潮(极端放量常标记趋势极点,即恐慌抛售或亢奋买入)。方法论把这些视为量能分析的固定检查项,模板的三条观察槽位正好容纳。


八、第 6 节 Chart Patterns and Price Action:形态要落到“在哪出现”

结构骨架

### Identified Patterns
[List any chart patterns, candlestick patterns, or notable price action]

- **Pattern 1**: [Name and description]
- **Pattern 2**: [Name and description]

### Price Action Notes
[Additional observations about recent price behavior, breakouts, rejections, etc.]

模板默认两条形态位(Pattern 1 / Pattern 2),并可扩展。方法论把可识别的形态分成两类:

反转类

  • 看多:锤子线(长下影、小实体在顶部、出现在支撑处)、看涨吞没、晨星、双重/三重底;
  • 看空:射击之星(长上影、小实体在底部、出现在阻力处)、看跌吞没、黄昏星、双重/三重顶。

持续类

  • 看多:牛旗、上升三角(更高的低点配平阻力,向上突破);
  • 看空:熊旗、下降三角(更低的高点配平支撑,向下突破)。

关键在方法论给出的形态权重规则——形态在以下情况更有分量:

  1. 出现在关键支撑/阻力处;
  2. 突破时量能配合;
  3. 被均线与趋势结构确认;
  4. 出现在更长周期上(周线优于日线)。

第 4 条对本技能尤其重要:因为分析对象本来就是周线图,形态的“周期加权”天然成立,但这也意味着不要把日线级别的噪音形态搬进周线报告。模板的 Price Action Notes 则承担突破、被拒、假突破等无法归入具名形态的近期行为。


九、第 7 节 Current Market Assessment:从证据到观点的转换点

### Overall Structure
[Synthesize all the above elements into a coherent view of the current chart structure]

### Key Observations
1. [Most important observation]
2. [Second important observation]
3. [Third important observation]

这是模板中唯一明确要求**“综合(synthesize)”**的一节。SKILL.md 的 3.6 步给出了这一节的四条写作指令:整合全部技术要素成连贯判断、找出最有影响力的因素、标注互相冲突的信号或含糊之处、确立决定后续方向的关键价位。

Key Observations 固定为三条,且有序(最重要 → 次重要 → 第三)。这种排序要求对写作者是有效的约束:如果三条观察可以任意互换顺序,说明还没有真正完成优先级判断。

值得强调的是“冲突信号”这一项。方法论在 Objectivity Reminders 中要求“考虑多空两种情景以避免确认偏误”,在 Common Pitfalls 中警告“强行识别形态”和“过度确定”。第 7 节是这些纪律最容易失守的地方,也是它们最应该被落实的地方。


十、第 8 节 Scenario Analysis:模板最核心的工程化部分

单个情景的六要素结构

模板为每个情景给出完全一致的六个字段:

### Scenario N: [Scenario Name] - **[XX]% Probability**

**Description**: [What this scenario entails]

**Supporting Factors**:
- [Factor 1]
- [Factor 2]
- [Factor 3]

**Target Levels**: [Upside or downside targets if this scenario plays out]

**Invalidation Level**: [Price level that would negate this scenario]

这六个字段与 SKILL.md 第 4 步列出的“Each scenario must include”是同一份清单:

  1. Scenario Name —— 清晰、描述性的标题(原文示例:“Bull Case: Breakout Above Resistance”);
  2. Probability Estimate —— 基于技术因素的百分比,所有情景之和必须为 100%;
  3. Description —— 该情景意味着什么、会如何展开;
  4. Supporting Factors —— 支撑该情景的技术证据,至少 2–3 条;
  5. Target Levels —— 情景成立时的目标价位;
  6. Invalidation Level —— 具体到价位的失效条件。

注意 Supporting Factors 的数量要求:主线情景(Scenario 1/2/3)模板铺了 3 个槽位,而 Scenario 4 (Optional) 只铺了 2 个。这与“2–3 条”的下限一致——概率越低的情景,越不该硬凑理由。

概率分配的参考框架

SKILL.md 给出的典型情景框架是分层的:

情景 概率区间 含义
Base Case 40–60% 当前结构下最可能的结果
Bull Case 20–40% 需要向上突破的乐观情景
Bear Case 20–40% 需要向下破位的悲观情景
Alternative 5–15% 概率较低但技术上成立

同时明确一句硬约束:“Ensure probabilities are realistic and sum to 100%.”

方法论把“为什么是某个概率”进一步拆成三档依据:

  • 高概率(50–70%):情景与当前趋势同向、多重因素(趋势/支撑阻力/均线/量能)共同确认、近期价格行为支持、且存在清晰的失效位;
  • 中概率(25–45%):情景需要趋势改变或重大突破、支持因素只具备一部分、成败取决于关键位是否守住/被破;
  • 低概率(5–20%):情景与多数技术因素相反、需要结构发生显著转变、证据有限但技术上可能。

方法论还给了一个可直接照抄结构的示例(结构为:上升趋势、价格在全部均线之上、守住支撑):

Bull Case (60%): 回踩支撑后继续上行
  —— 趋势完好、守住关键支撑、量能确认
Base Case (30%): 下一波之前先横盘/区间整理
  —— 接近阻力、出现部分获利了结迹象
Bear Case (10%): 跌破支撑、趋势反转
  —— 目前尚无明确反转信号,但始终可能

这个例子揭示了一个容易被忽略的点:Base Case 不一定是概率最高的那一个。上例中 Bull Case 60% 才是主线,Base Case 30% 只是“最常见的名义分类”。模板中的 Scenario 1/2/3 只表示顺序,不暗示概率高低——真正的优先级只能靠百分比和 Summary 里的 “Most Likely Outcome” 表达。

失效位的定义方式

方法论给出了每种情景的失效位语义:

  • 看多情景的失效位 = 跌破关键支撑;
  • 看空情景的失效位 = 突破关键阻力;
  • 基准(区间)情景的失效位 = 向任一方向的区间突破。

模板要求 Invalidation Level 写到具体价位,而不是“如果跌破支撑则失效”——后者与第 3 节重复,等于没有写。

情景之间必须互斥

SKILL.md 的 Clarity Requirements 明确要求 “Make scenarios distinct and mutually exclusive”。这条约束与“概率之和为 100%”是配套的:如果两个情景可以同时成立,概率加总就失去了意义。实践中的检查方法是:把每个情景的 Invalidation Level 单独看一遍,若两个情景的失效位完全一致,说明它们的边界没有划开。


十一、第 9 节 Summary 与第 10 节 Disclaimer:收口与边界

### Most Likely Outcome
[Brief statement of the highest probability scenario]

### Key Levels to Watch
- **Critical Support**: [Level]
- **Critical Resistance**: [Level]

### Risk Considerations
[Important caveats, limitations of the analysis, or factors that could disrupt scenarios]

Most Likely Outcome 不是第 8 节的复制,而是一句话结论;Key Levels to Watch 把整份报告收敛到两个价位(一个关键支撑、一个关键阻力),这是读者真正会拿走的部分。

Risk Considerations 是模板里最容易被写成套话的字段。它应该承载方法论 Objectivity Reminders 中的内容:分析会随新数据变化、并非每张图都有清晰信号、概率而非预测。同时也可以记录图表本身的可读性限制(例如均线数据不全、量能柱难以精确辨识)。

第 10 节 Disclaimer 在模板中是全文已经写好的固定段落,无需改写:

This analysis is based purely on technical chart data and does not consider fundamental factors, news, or market sentiment. It represents a probabilistic assessment of potential scenarios, not a prediction or investment recommendation. All probabilities are estimates based on technical factors and subject to change as new data emerges.

这段话把该技能的三个不可越界的边界一次讲清:只看图表数据、只给概率不给预测、不构成投资建议。它与 SKILL.md 的 Core Principles 中“Pure Chart Analysis / Objective Assessment / Probabilistic Scenarios”三条是同一套表述的两种写法。报告以 **End of Analysis** 结束,作为文件终止标记。


十二、模板如何被加载、命名与校验

调用方式

模板不是被脚本读取的,而是被提示词指令引用的。SKILL.md 第 5 步的写法是:

Read and use as template: assets/analysis_template.md

这是一条相对技能根目录的路径指令。换言之,Agent 在执行时需解析到 skills/technical-analyst/assets/analysis_template.md,把其中的占位符替换为实际内容,而不是“参考风格自由发挥”。

文件命名

SKILL.md 给出的命名规则与示例:

[SYMBOL]_technical_analysis_[YYYY-MM-DD].md
SPY_technical_analysis_2025-11-02.md

报告统一保存到 reports/ 目录(仓库根目录下的 reports/ 即该落点,现有文件如 position_sizer_2026-11-14_073121.md 展示了同目录下的命名风格)。仓库内其它工作流示例也沿用同一模式,例如 PEAD 剧本 中即按 reports/PEADY_technical_analysis_{run_date}.md 构造路径——这说明文件名格式不只是约定,而是被下游代码拼接使用的字符串。

契约测试的硬校验

模板的存在性与引用关系由 test_skill_contract.py 直接断言:

EXPECTED_RESOURCES = (
    "references/technical_analysis_framework.md",
    "assets/analysis_template.md",
    "references/contrarian-confirmation-checklist.md",
    "scripts/check_weekly_price_action.py",
)

def test_required_framework_and_template_are_present_and_named() -> None:
    text = _skill_text()
    for rel_path in EXPECTED_RESOURCES:
        assert (SKILL_DIR / rel_path).is_file()
        assert rel_path in text

这个测试同时验证两件事:文件真实存在,且**SKILL.md 正文中出现了该相对路径**。因此“模板被删掉”或“SKILL.md 不再提及模板”都会导致测试失败。

测试还进一步锁定了技能的提示契约:

def test_prompt_contract_requires_chart_input_and_probabilistic_output() -> None:
    text = _skill_text()
    assert "Chart Images" in text
    assert "Pure Chart Analysis" in text
    assert "Probabilistic Scenarios" in text
    assert "[SYMBOL]_technical_analysis_[YYYY-MM-DD].md" in text

也就是说,纯图表分析、概率化输出、固定文件命名这三项,连同“必须输入图表图片”,都是被测试固化的技能身份,而不是可以随手调整的风格选项。


十三、模板之外的第二个输出契约:不要混用

technical-analyst 现在还带有一个可加(additive)模式:Contrarian Confirmation Mode(Shapiro 流程第 3 步)。它不产出上面这份 10 节 Markdown 报告,而是产出结构化的 JSON 判定:

symbol: BT
direction: CROWDED_LONG
mode: data
verdict: CONFIRMED | NOT_CONFIRMED | INSUFFICIENT_DATA
confidence: HIGH | MEDIUM | LOW
verdict_reason: key_reversal | failed_extreme | failed_breakout |
  continuation_intact | no_reversal_evidence |
  insufficient_weekly_bars | no_price_source | ...

文件命名为 ta_confirmation_<SYMBOL>_<as-of>.json / .md,与 [SYMBOL]_technical_analysis_[YYYY-MM-DD].md 是两套完全不同的契约。SKILL.md 对此有明确边界说明:

This is an ADDITIVE mode, separate from the pure chart-analysis workflow above. It activates only on an explicit contrarian-confirmation request.

并重申:一次普通的 “analyze this chart” 请求仍然走原来的 Steps 1–6,工作流不变。二者不可互相替代:

维度 纯图表工作流(本模板) 对比确认模式
触发 用户提供周线图并要求技术分析 显式请求对比确认
输入 图表图片(主) 图表图片(主)/ 脚本(兜底)
输出 10 节 Markdown 报告 JSON + Markdown 判定
核心结论 概率化情景(合计 100%) 三态 verdict
下游消费者 人工阅读、后续剧本 contrarian-setup-gate 的 handoff.price_action

尤其是 stop_reference(最近的 fractal swing high/low)只存在于对比确认模式的输出中,本模板没有对应的止损参考字段。若把两者混写,下游按 JSON 字段取值时会落空。


十四、模板的隐含写作纪律

模板通过“字段设计”本身传递了一组纪律,值得单独梳理,因为它们比任何提示语都更难违反:

  1. 不留空。占位符全部用方括号标注了内容类型,空着不填即视为未完成分析。
  2. 价位必须具体。第 3 节、第 8 节的 Target Levels / Invalidation Level 都要求价位;SKILL.md 的 Clarity Requirements 直接写明 “Include specific price levels (not vague descriptions)”。
  3. 禁止主观措辞。Objectivity Requirements 明确 “Do not use subjective language like 'I think' or 'I feel'”。
  4. 多空必须并存。情景分析至少包含一个上行情景与一个下行情景,避免单向叙事。
  5. 不确定要承认。“Express uncertainty clearly when signals are ambiguous”。
  6. 概率必须可辩护。每个百分比都要靠 Supporting Factors 里的技术证据支撑,而不是直觉。
  7. 形态不能硬凑。方法论 Common Pitfalls 首条即警告“过度复杂化”与“强行识别形态”。

此外,SKILL.md 还要求逐张分析、逐张保存,不得批量处理:

Do not batch analyses. Complete and save each report before moving to the next chart.

这条规则与模板配套的原因很实际:模板的 10 节结构是“单标的深度分析”的容器,一次性并行处理多图时,作者会不自觉地复制粘贴上一张图的措辞,导致 Key Observations 与 Invalidation Level 失去针对性。


十五、一次填充过程的示例(数值为占位示意)

下面用一份结构示意展示填充顺序。所有价位与百分比均为示例占位值,不代表任何真实行情。

# Technical Analysis Report

**Ticker/Symbol**: EXMPL
**Timeframe**: Weekly
**Analysis Date**: 2026-11-15
**Analyst**: Claude Technical Analyst

## 1. Chart Overview
周线图,覆盖约 3 年;当前价格位于区间中部,量能柱可用。

## 2. Trend Analysis
### Current Trend
- **Direction**: Uptrend
- **Strength**: Moderate
- **Duration**: 约 34 周
### Trend Details
HH/HL 序列完整,但最近一次高点推进幅度收窄;未见放量背离。

## 3. Support and Resistance Levels
### Key Support Levels
1. **100.00**:前两次周线反弹起点,与 50 周均线重合
2. **92.50**:整数关口下方的次级低点聚集区
3. **85.00**:200 周均线所在区域
### Key Resistance Levels
1. **118.00**:最近一次冲高被拒价位
2. **125.00**:整数心理关口 + 前高
3. **133.00**:区间上沿
### Support/Resistance Notes
118.00 一旦被周线收盘突破,按角色互换应转为回踩支撑。

## 4. Moving Average Analysis
### Current MA Structure
- **Price vs 20-week MA**: Above
- **Price vs 50-week MA**: Above
- **Price vs 200-week MA**: Above
### MA Configuration
- **Alignment**: Bullish
- **Slope**: Rising
- **Crossovers**: 20 周与 50 周间距压缩,暂无交叉
### MA as Support/Resistance
50 周均线与 100.00 支撑重合,构成动态+静态 confluence。

## 5. Volume Analysis
### Volume Trend
近 8 周量能温和递增。
### Volume Observations
- 支撑处放量反弹
- 上攻 118.00 时量能未同步放大
- 尚未出现量能高潮
### Volume Confirmation
价格方向获部分确认,但阻力前的量能配合不足。

## 6. Chart Patterns and Price Action
### Identified Patterns
- **Pattern 1**: 上升三角,更高的低点配 118.00 平阻力
- **Pattern 2**: 最近一根周线长上影,出现在阻力下方
### Price Action Notes
尚未出现周线收盘级别的突破确认。

## 7. Current Market Assessment
### Overall Structure
多头结构完好但动能边际减弱,处于阻力下方的整理末端。
### Key Observations
1. 均线多头排列且斜率向上
2. 阻力前量能未放大
3. 支撑与 50 周均线重合,容错空间明确

## 8. Scenario Analysis
### Scenario 1: 突破上行 - **45% Probability**
**Description**: 周线收盘站上 118.00 并回踩确认。
**Supporting Factors**:
- 均线多头排列
- 更高的低点持续推进
- 支撑处曾放量
**Target Levels**: 125.00
**Invalidation Level**: 100.00

### Scenario 2: 区间整理 - **35% Probability**
...
### Scenario 3: 跌破支撑 - **20% Probability**
...

## 9. Summary
### Most Likely Outcome
阻力下方整理后尝试突破,成败取决于 118.00。
### Key Levels to Watch
- **Critical Support**: 100.00
- **Critical Resistance**: 118.00
### Risk Considerations
量能数据为图中的柱体目测,精度有限;情景概率随新数据变化。

## 10. Disclaimer
(模板固定段落,原文照录)

**End of Analysis**

这份示意里值得注意的三处细节:

  • 概率合计 45 + 35 + 20 = 100,符合硬约束;
  • 每个情景的失效位都不同(100.00 / 区间边界 / 118.00),满足互斥要求;
  • Key Levels to Watch 只有两个价位,与第 3 节的六个价位形成信息压缩,这是 Summary 的正确用法。

十六、结语:模板的价值在于让判断可被审查

把 analysis_template.md 单独拿出来看,它只是一份带占位符的 Markdown 骨架。但放到 technical-analyst 的完整链路中,它同时承担了四种角色:

  1. 工作流的落点:第 5 步强制调用的唯一产物;
  2. 方法论的容器:第 2/3/4/5/6 节分别对应 technical_analysis_framework.md 的趋势、支撑阻力、均线、量能、形态五章;
  3. 概率纪律的载体:第 8 节的六要素与 100% 合计约束,把“看多/看空”的主观判断变成可检验的概率分布;
  4. 可被机器校验的地址:test_skill_contract.py 通过 EXPECTED_RESOURCES 与文件名模式断言,确保模板永远存在、永远被引用、永远按 [SYMBOL]_technical_analysis_[YYYY-MM-DD].md 命名。

如果说技术分析的能力上限取决于读图经验,那么它的下限——报告不遗漏关键维度、结论可追溯、多空都被认真考虑、每个数字都有依据——恰恰由这份模板保证。要在本仓库中亲自验证这一机制,可以从三处入手:读一遍模板原文,对照方法论确认每个占位符的判据来源,最后跑一次技能自带的契约测试,观察模板与提示词之间的绑定关系如何被断言。

登录后查看全文
claude-trading-skills