Claude Code 子代理实战：用 crypto-investment-plays-haiku 构建带风险评分的加密投资机会研究 Agent-育师

Claude Code 子代理实战：用 crypto-investment-plays-haiku 构建带风险评分的加密投资机会研究 Agent

【免费下载链接】claude-code-hooks-masteryMaster Claude Code Hooks项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-hooks-mastery

本指南围绕 claude-code-hooks-mastery 仓库中的 crypto-investment-plays-haiku.md 子代理定义文件，完整讲解"轻量 Agent 定义 + 重型提示词委托"的构建模式、六步研究工作流，以及可落地的投资报告输出模板。读完本文，你将掌握如何在 Claude Code 中部署一个可自动产出"入场/离场/止损/收益风险双面论证"结构化报告的加密投资研究子代理，并理解其与仓库内其他加密 Agent 的协作方式。

一、文件概览：一个"薄壳子代理"的完整骨架

crypto-investment-plays-haiku.md是一个标准的 Claude Code 子代理（Sub-Agent）定义文件，位于项目级 Agent 目录.claude/agents/crypto/下。它的全文只有 YAML frontmatter 加一行指令，但信息密度极高，承担着"何时被调用、能调什么工具、用什么模型、按什么提示词执行"四个关键决策：

--- name: crypto-investment-plays-haiku description: Use proactively to identify actionable crypto investment opportunities with concrete entry/exit strategies, from simple spot buys to DeFi yields. Provides risk-scored plays with clear execution steps. tools: WebSearch, Bash model: haiku color: green --- Read and Execute: .claude/commands/agent_prompts/crypto_investment_plays_agent_prompt.md

1. YAML frontmatter 字段逐项解析

字段	取值	作用
`name`	`crypto-investment-plays-haiku`	Agent 唯一标识，供主 Agent 按名引用
`description`	一段"何时使用"说明	最关键字段：主 Agent 依据它判断何时自动委派本子代理。本文件使用`Use proactively`这样的强触发词，引导主 Agent 在用户提出加密投资机会类需求时优先调用
`tools`	`WebSearch, Bash`	工具白名单：`WebSearch`用于检索行情、新闻、收益率与审计信息；`Bash`用于执行`date`命令打时间戳等本地操作。相比"继承全部工具"的默认行为，这里显式收窄权限
`model`	`haiku`	指定底层模型为 Claude Haiku（轻量快速、成本低），适合高频、结构化输出任务
`color`	`green`	终端中的视觉标识色，便于区分不同 Agent

值得对照的是，仓库在 .claude/agents/crypto/ 下为同一职能提供了三档模型变体：crypto-investment-plays-opus.md（model: opus、color: red）与 crypto-investment-plays-sonnet.md（model: sonnet、color: blue），三者 frontmatter 除模型与颜色外完全一致，说明该仓库用"同一提示词 + 不同模型档位"实现了成本与质量的按需切换。

2. "Read and Execute" 委托模式

文件正文只有一行：Read and Execute: .claude/commands/agent_prompts/crypto_investment_plays_agent_prompt.md。这是一种刻意设计的两层结构：

Agent 文件保持"薄"：只负责元信息（何时调用、用什么工具和模型），避免在 frontmatter 之后堆叠大量指令造成维护负担；
提示词文件保持"专"：完整的角色设定、变量、工作流与输出模板全部沉淀在 crypto_investment_plays_agent_prompt.md 中，可被 opus / sonnet / haiku 三个变体共享引用，实现"一处维护、三档复用"。

这正是本仓库 README 强调的核心概念：Agent 文件中的内容是系统提示词（system prompt）而非用户提示词，它配置子代理的行为边界；主 Agent 根据description决定何时委派，子代理以全新上下文启动、直接对主 Agent 汇报。

二、委托的提示词：角色、变量与硬性约束

子代理被唤醒后，会读取并执行 crypto_investment_plays_agent_prompt.md。该文件首先定义一个角色：crypto investment strategist（加密投资策略师），专门负责从简单现货买入到高级 DeFi 策略的具体可执行投资机会识别。

1. 模板变量（Variables）

提示词文件顶部声明了两个可调参数，是控制输出规模与调研深度的核心旋钮：

NUMBER_OF_PLAYS: 3：每次报告必须恰好输出 3 个投资机会（play），防止 Agent 泛泛列举；
MINIMUM_SOURCES: 5：定稿前必须从至少 5 个不同信源完成调研，强制多源交叉验证，降低单一信源偏差。

2. 行为指令（Instructions）

文件用 14 条硬性指令约束产出质量，可归纳为四类：

输出纪律

恰好输出NUMBER_OF_PLAYS个机会、调研至少MINIMUM_SOURCES个信源；
给出具体价格点位，禁止模糊建议；
明确声明"这是分析而非财务建议"。

策略均衡

在简单策略（现货买入）与进阶策略（收益、套利）之间保持平衡；
覆盖不同投资者画像与资金规模。

风险与退出

每个机会同时给出多空两面论证（bull/bear case）；
为每个策略附风险评分、预期收益与相关风险警告；
定义明确的 kill criteria（失效条件），含获胜与亏损两种离场触发点。

可执行性

聚焦信誉良好的协议与高流动性市场；
提供逐步执行说明。

三、六步研究工作流

提示词文件为子代理规定了严格的执行顺序，保证从"取时间戳"到"输出报告"全程可复现：

步骤	名称	关键动作
1	Timestamp and Market Context	用`date`命令为分析打时间戳；检索当前市场状况与情绪；识别影响决策的主要趋势
2	Scan Investment Opportunities	至少`MINIMUM_SOURCES`个信源调研；搜索处于技术支撑/阻力位的币种、主流协议 DeFi 收益率、板块轮动机会、叙事驱动型行情、质押与流动性质押选项
3	Analyze Risk/Reward Profiles	检索波动率与风险指标；与历史均值对比收益率；评估协议安全性与审计状态；计算风险调整后收益
4	Identify Top NUMBER_OF_PLAYS Plays	简单/复杂策略混搭；时间跨度从即期到最长 3 年；风险从保守到激进分层；覆盖不同资金门槛
5	Research Execution Details	确定每个机会的最佳平台/协议；检查流动性与滑点；核实当前利率与 APY；查明锁定期等限制
6	Compile Risk Management Guidelines	汇总仓位配置建议、对冲策略与需监控的警示信号

这六步形成"环境 → 扫描 → 评估 → 筛选 → 执行细节 → 风控"的完整漏斗，其中Bash工具在步骤 1 中承担时间戳职责，WebSearch贯穿全程提供数据源。

四、结构化输出模板（完整继承）

提示词文件定义了严格的 Markdown 输出模板，子代理必须按此格式返回结果，这也是本 Agent 最大的工程价值——输出是可解析、可存档、可二次消费的固定 schema。完整模板如下：

# CRYPTO INVESTMENT PLAYS REPORT Generated on: [timestamp] ## MARKET CONTEXT [Brief overview of current conditions affecting investment decisions] ## TOP INVESTMENT PLAYS ### PLAY #1: [Descriptive name, e.g., "Bitcoin Accumulation at Support"] Category: Spot Buy | Yield Strategy | Arbitrage | Narrative Play Timeframe: Immediate | 1-3 months | 3-6 months | 6+ months Risk Score: [1-10, where 1 is safest] Expected Return: [% gain or APY] Minimum Investment: $[amount] (optional) ### THESIS: [2-3 sentences explaining why this opportunity exists now] ### EXECUTION: 1. [Specific steps to implement] 2. [Which platform/protocol to use] 3. [Any timing considerations] ### ENTRY STRATEGY: - Entry Zone: $[specific price range or conditions] - Position Sizing: [% of portfolio or DCA strategy] - Confirmation Signals: [What to watch for] ### BULL CASE: Target $[price] or [return]% - [Specific catalyst or condition] - [Supporting factors] - [Upside potential] ### BEAR CASE: Risk of -[%] decline - [Main risk factor] - [Downside scenario] - [Mitigation strategy] ### EXIT STRATEGY: - Take Profit: $[level] or [condition] - Stop Loss: $[level] or -[%] - Reassess Date: [specific timeframe] ### KILL CRITERIA (Play Becomes Void When): #### WIN SIDE EXITS: - [Specific condition, e.g., "BTC breaks $150,000"] - [Time-based, e.g., "Target hit within 30 days"] - [Indicator-based, e.g., "RSI > 80 on daily"] #### LOSS SIDE EXITS: - [Price trigger, e.g., "Falls below $110,000 support"] - [Fundamental change, e.g., "Protocol gets hacked"] - [Macro trigger, e.g., "Fed raises rates above 6%"] - [Time stop, e.g., "No movement after 60 days"] --- [Repeat for each play] ## PORTFOLIO ALLOCATION MODELS ### Conservative (Risk Score 1-3): - [Allocation percentages and strategies] ### Balanced (Risk Score 4-6): - [Allocation percentages and strategies] ### Aggressive (Risk Score 7-10): - [Allocation percentages and strategies] ### PLAYS TO AVOID - [Overvalued assets or risky protocols] - [Reasons to avoid] ### MONITORING CHECKLIST - [Key metrics to track] - [Warning signs to watch] - [Rebalancing triggers] ### DISCLAIMER This analysis is for informational purposes only and does not constitute financial advice. Cryptocurrency investments carry substantial risk including total loss of capital. Always conduct your own research and consider your risk tolerance before investing.

模板设计要点

单 Play 结构 = 完整投资决策单：THESIS（机会成因）→EXECUTION（执行路径）→ENTRY STRATEGY（入场区间/仓位/确认信号）→BULL/BEAR CASE（双向论证）→EXIT STRATEGY（止盈/止损/复查日）→KILL CRITERIA（胜/败双向失效条件）。其中 KILL CRITERIA 将"何时离场"进一步拆为价格触发、时间触发、指标触发、基本面触发、宏观触发五类，把模糊的"注意风险"落地为可编程的硬条件；
风险评分贯穿全程：1–10 分制（1 最安全）在每个 Play 头部标注，并在末尾映射到保守（1–3）、均衡（4–6）、激进（7–10）三档仓位配置模型，形成"单标的评分 → 组合配置"的闭环；
强制免责声明：模板末尾固定输出 DISCLAIMER，从机制上保证每份报告都附带风险提示。

五、与仓库内其他加密 Agent 的协作链

crypto-investment-plays-haiku并非孤立存在。在 .claude/agents/crypto/ 目录下，仓库围绕加密研究构建了分工明确的 Agent 矩阵：

Agent 文件	职责
crypto-market-agent-haiku.md	按市值检索 Top N 币种的实时市场数据（工具：`WebSearch, Write`）
crypto-coin-analyzer-haiku.md	针对单个 ticker 分析价格、新闻、情绪与技术指标（工具：`WebSearch, Bash, Write`）
crypto-movers-haiku.md	追踪指定时间窗口内涨跌幅最大的币种（工具：`WebSearch`）
macro-crypto-correlation-scanner-haiku.md	分析美联储政策、通胀、传统市场与加密板块的宏观联动（工具：`WebSearch, Bash`）
crypto-investment-plays-haiku	将上述市场信号收敛为带风险评分与执行步骤的投资机会

仓库 README 在"Complex Workflows & Agent Chaining"一节给出了典型的链式用法：

"First analyze the market with crypto-market-agent, then use crypto-investment-plays to find opportunities"

即：先由crypto-market-agent摸清市场全景，再委派crypto-investment-plays基于该背景生成投资机会。子代理各自持有独立上下文窗口，主 Agent 负责调度与结果汇总——这正是 Claude Code 子代理系统"任务专业化 + 上下文隔离 + 自动委派"三大能力的组合应用，也解释了为何crypto-investment-plays的提示词会内置MINIMUM_SOURCES约束：它需要独立调研验证，而非仅依赖上游 Agent 的转述。

六、部署与使用

1. 放置路径

将 Agent 文件放入项目级目录.claude/agents/（本仓库即此结构），或用户级目录~/.claude/agents/实现跨项目可用。项目级优先级更高。Agent 采用 Markdown + YAML frontmatter 格式，Claude Code 启动时自动扫描加载。

2. 触发方式

自动委派：主 Agent 依据description中的Use proactively措辞，在用户提出"寻找加密投资机会/出入场策略/DeFi 收益"类需求时自动调用本子代理；
手动指定：在对话中显式点名该 Agent，例如结合链式编排："先用 crypto-market-agent 分析大盘，再用 crypto-investment-plays-haiku 找出投资机会"。

3. 运行前提

本 Agent 依赖 Claude Code 环境（详见仓库 README.md 的前置要求），无需额外安装；Bash工具仅用于date等轻量命令，项目 .claude/settings.json 中的权限白名单已放行常见 Bash 操作；
子代理启动时无对话历史，须在提示词中显式告知其所需背景信息——这正是提示词文件将"Timestamp and Market Context"列为第一步的原因。

七、小结

crypto-investment-plays-haiku展示了 Claude Code 子代理的一个高质量工程范式：元数据（frontmatter）定义"何时/用什么"，提示词文件定义"怎么做/输出什么"，多模型变体共享同一提示词以权衡成本与质量。其核心价值不在"会找机会"，而在把投资研究固化为可复现的流程——多源调研下限、固定报告 schema、双向 kill criteria、风险评分到仓位配置的映射，以及强制免责声明。这套"薄 Agent + 厚提示词 + 结构化输出"的模式，同样可以直接迁移到行情、宏观、审计等其他任何需要高频、结构化产出的研究场景。

【免费下载链接】claude-code-hooks-masteryMaster Claude Code Hooks项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-hooks-mastery

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考