技术分析报告模板详解:claude-trading-skills 中 technical-analyst 的十段式输出规范
技术分析报告模板详解: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 提供,模板只规定“必须回答哪些问题、答案放在哪一节”。
这种分离带来两个工程收益:
- 模板可被机器校验。模板是文件系统中的一个真实资产,只要它存在、并且被
SKILL.md以正确相对路径引用,就说明技能的提示契约完整。这一点由契约测试硬编码保证。 - 报告可被比对与复读。所有报告都遵循同一套 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),并可扩展。方法论把可识别的形态分成两类:
反转类
- 看多:锤子线(长下影、小实体在顶部、出现在支撑处)、看涨吞没、晨星、双重/三重底;
- 看空:射击之星(长上影、小实体在底部、出现在阻力处)、看跌吞没、黄昏星、双重/三重顶。
持续类
- 看多:牛旗、上升三角(更高的低点配平阻力,向上突破);
- 看空:熊旗、下降三角(更低的高点配平支撑,向下突破)。
关键在方法论给出的形态权重规则——形态在以下情况更有分量:
- 出现在关键支撑/阻力处;
- 突破时量能配合;
- 被均线与趋势结构确认;
- 出现在更长周期上(周线优于日线)。
第 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”是同一份清单:
- Scenario Name —— 清晰、描述性的标题(原文示例:“Bull Case: Breakout Above Resistance”);
- Probability Estimate —— 基于技术因素的百分比,所有情景之和必须为 100%;
- Description —— 该情景意味着什么、会如何展开;
- Supporting Factors —— 支撑该情景的技术证据,至少 2–3 条;
- Target Levels —— 情景成立时的目标价位;
- 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 字段取值时会落空。
十四、模板的隐含写作纪律
模板通过“字段设计”本身传递了一组纪律,值得单独梳理,因为它们比任何提示语都更难违反:
- 不留空。占位符全部用方括号标注了内容类型,空着不填即视为未完成分析。
- 价位必须具体。第 3 节、第 8 节的
Target Levels/Invalidation Level都要求价位;SKILL.md的 Clarity Requirements 直接写明 “Include specific price levels (not vague descriptions)”。 - 禁止主观措辞。Objectivity Requirements 明确 “Do not use subjective language like 'I think' or 'I feel'”。
- 多空必须并存。情景分析至少包含一个上行情景与一个下行情景,避免单向叙事。
- 不确定要承认。“Express uncertainty clearly when signals are ambiguous”。
- 概率必须可辩护。每个百分比都要靠
Supporting Factors里的技术证据支撑,而不是直觉。 - 形态不能硬凑。方法论 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 的完整链路中,它同时承担了四种角色:
- 工作流的落点:第 5 步强制调用的唯一产物;
- 方法论的容器:第 2/3/4/5/6 节分别对应 technical_analysis_framework.md 的趋势、支撑阻力、均线、量能、形态五章;
- 概率纪律的载体:第 8 节的六要素与 100% 合计约束,把“看多/看空”的主观判断变成可检验的概率分布;
- 可被机器校验的地址:test_skill_contract.py 通过
EXPECTED_RESOURCES与文件名模式断言,确保模板永远存在、永远被引用、永远按[SYMBOL]_technical_analysis_[YYYY-MM-DD].md命名。
如果说技术分析的能力上限取决于读图经验,那么它的下限——报告不遗漏关键维度、结论可追溯、多空都被认真考虑、每个数字都有依据——恰恰由这份模板保证。要在本仓库中亲自验证这一机制,可以从三处入手:读一遍模板原文,对照方法论确认每个占位符的判据来源,最后跑一次技能自带的契约测试,观察模板与提示词之间的绑定关系如何被断言。