用 Claude Code 构建实时加密市场数据 Subagentcrypto-market-agent-sonnet 完整实战指南【免费下载链接】claude-code-hooks-masteryMaster Claude Code Hooks项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-hooks-mastery本文以当前仓库中的 crypto-market-agent-sonnet.md 及其背后的执行提示词 crypto_market_agent_prompt.md 为骨架完整拆解「如何用 Claude Code Subagent 体系封装一个按市值排名 Top N 的加密货币实时行情检索与汇总代理」。读完本文你将掌握 Subagent 文件的前置元数据写法、薄代理 独立提示词文件的工程化组织方式、TOP_N 参数化传参、标准化 Markdown 表格输出约定以及它与仓库中 12 个加密 Agent 并行编排crypto_research.md的联动关系。一图看懂agent 定义文件与执行提示词的分层设计crypto-market-agent-sonnet是一个典型的 Claude Code 项目级 Subagent位于.claude/agents/crypto/完整文件只有 9 行--- name: crypto-market-agent-sonnet description: Use proactively for real-time cryptocurrency market data retrieval and analysis for Top N cryptocurrencies by market cap tools: WebSearch, Write model: sonnet color: blue --- Read and Execute: .claude/commands/agent_prompts/crypto_market_agent_prompt.md它的设计非常克制由两部分组成YAML 前置元数据frontmatter定义代理的身份、触发条件、工具权限与模型档位正文一条指令Read and Execute指向独立的执行提示词文件将完整系统提示词从 agent 文件中剥离。这是一种值得借鉴的**薄代理thin agent模式**代理定义文件只负责注册真正的工作逻辑全部沉淀在 crypto_market_agent_prompt.md 中方便独立维护、版本管理与复用。前置元数据逐字段解析字段本文件取值作用namecrypto-market-agent-sonnet唯一标识使用小写字母与连字符命名Claude 依据它与 description 决定何时委托任务descriptionUse proactively for real-time cryptocurrency market data retrieval and analysis for Top N cryptocurrencies by market cap触发委托的关键字段。官方文档见仓库内 ai_docs/claude_code_subagents_docs.md明确Claude 通过每个 Subagent 的description判断何时把任务委派给它建议在描述中加入 use proactively 这类措辞鼓励主动委托toolsWebSearch, Write工具白名单。WebSearch负责实时行情检索Write用于把结果写入文件在crypto_research编排中要求落盘。若省略该字段Subagent 将继承主会话的全部工具modelsonnet模型档位可选sonnet、opus、haiku或inherit继承主会话模型。sonnet 在能力与速度/成本之间取得平衡colorblue终端 UI 中标识该代理的背景色便于在运行时区分当前是哪个 Subagent 在工作三档模型矩阵同一套分工haiku / sonnet / opus 各司其职仓库用同一套执行提示词声明了三个仅模型档位与颜色不同的市场数据代理文件modelcolor适用场景crypto-market-agent-haiku.mdhaikugreen快速、低成本的行情速览适合高频调用crypto-market-agent-sonnet.mdsonnetblue能力与成本均衡的默认档位crypto-market-agent-opus.mdopusred复杂市场解读与多源交叉验证三个文件的description完全相同因此 Claude 在自动委托时会把行情类任务路由给该家族而模型档位的差异则让使用者可以在成本敏感haiku与分析深度优先opus之间显式选择。仓库 README.md 的 Sub-Agents 章节也点明了这一设计动机通过把任务路由到更快更便宜的模型如 Haiku来控制成本。需要留意一个细节差异官方文档副本ai_docs/claude_code_subagents_docs.md指出model字段省略时默认值为inherit继承主会话模型而 README.md 的注释示例写作defaults to sonnet。本仓库的三款代理都显式声明了model这本身也是最稳妥的做法——不依赖默认值语义行为完全可预期。执行提示词深度解析市场数据专家如何工作被Read and Execute指向的 crypto_market_agent_prompt.md 才是这套代理真正的工作说明书共四部分Purpose角色定位、Variables变量、Instructions工作守则与 Output Format输出格式。角色定位PurposeYou are a cryptocurrency market data specialist focused on retrieving and summarizing real-time market information for major cryptocurrencies.代理被定义为加密货币市场数据专家职责是检索并汇总主流币种的实时市场信息而非做深度投资分析那是 crypto-coin-analyzer 与 crypto-investment-plays 家族的职责见下文编排章节。变量TOP_N 参数化- **TOP_N**: $ARGUMENTS or 10 - The number of top cryptocurrencies to retrieve (defaults to 10 if not specified) - Used for: Determining how many cryptocurrencies to include in the market summary$ARGUMENTS是 Claude Code 的运行时参数占位符当用户以agent-crypto-market-agent-sonnet 20之类方式带参调用时TOP_N取传入值如上例为 20未传参时回退为默认值10。该变量直接决定市场摘要中包含多少只币种。工作守则Instructions提示词为代理规定了七条硬性行为约束核心要点如下锁定实时数据检索词应面向实时/最新行情例如BTC ETH current price market cap live优先聚合页寻找能在单页展示多币种的数据聚合器减少搜索调用次数多源交叉验证若初次结果看起来过期或不一致须交叉核对多个数据源标注来源与时间戳最终摘要尽量附上数据来源与抓取时间保证可溯源优雅降级某项指标取不到时明确注明哪些指标未能获取而非编造数字遵守输出格式必须以下方 Output Format 规定的格式输出不得自由发挥。工作流Workflow调用后必须按序执行 7 步确定要检索的币种数量有TOP_N用它否则用默认值 10按市值搜索 Top N 币种的实时行情检索词形如Top [TOP_N] cryptocurrencies by market cap live prices对每只币种收集 4 项指标当前价格美元市值Market Capitalization24 小时交易量24 小时价格涨跌幅百分比优先用一次查询覆盖多币种的检索词如top [TOP_N] cryptocurrencies by market cap live prices最小化搜索调用聚焦可靠信源CoinMarketCap、CoinGecko 或主流财经新闻站点通过时间戳核验数据新鲜度规范数值格式价格保留 24 位小数大数用 B十亿/ M百万后缀。输出格式标准化 Markdown 表格提示词要求代理严格按以下模板输出这是可被下游消费的关键设计——结构化表格既便于主 Agent 二次加工也便于直接落盘为报告## Cryptocurrency Market Summary | Cryptocurrency | Current Price | Market Cap | 24h Volume | 24h Change | | -------------- | ------------- | ---------- | ---------- | ---------- | | [Crypto 1] | $X,XXX.XX | $XXX.XX B | $XX.XX B | ±X.XX% | | [Crypto 2] | $X,XXX.XX | $XXX.XX B | $XX.XX B | ±X.XX% | | [Crypto 3] | $X.XXXX | $XX.XX B | $X.XX B | ±X.XX% | | ... | ... | ... | ... | ... | | [Crypto N] | $X.XXXX | $XX.XX B | $X.XX B | ±X.XX% | **Data Source:** [Source Name] **Last Updated:** [Timestamp if available]表格末尾强制附带Data Source与Last Updated两行元信息配合工作守则中的多源交叉验证从提示词层面杜绝了 AI 编造行情数据的可能。实战使用如何触发这个 Subagent有三种典型触发方式1. 显式指名调用最直接Use the crypto-market-agent-sonnet to get the current top 10 crypto prices主 Agent 会据此把任务委派给该代理代理在独立上下文窗口中执行并把摘要结果返回给主会话。2. 自动委托由于description中带有 Use proactively for real-time cryptocurrency market data retrieval...当你在对话中提出查一下当前市值前 10 的币种行情这类需求时Claude 会自动判断并路由到该代理家族。3. 带参调用配合TOP_N变量传入币种数量参数即可改变摘要规模默认不传则取 10。触发后你可以通过仓库的 Subagent 生命周期 Hook 观察执行痕迹.claude/hooks/subagent_start.py会在 Subagent 启动时写入日志README 中描述为 Subagent spawn logging with optional TTS announcement.claude/hooks/subagent_stop.py则记录完成事件日志统一落在logs/目录。关于信息流需要牢记 Subagent 机制的一条核心原则README 称之为最常见的误解agent 文件中的正文是系统提示词不是用户提示词Subagent 从不直接与你对话它响应主 Agent 的委托并把结果回报给主 Agent再由主 Agent 综合呈现给你。仓库级联动12 个加密 Agent 的并行编排单个市场代理的价值在仓库的 crypto_research.md 编排命令中被放大为完整的加密研究工作流。该命令使用agent-*引用语法一次并行调度 12 个代理分为四组组别代理家族职责Market Data Agentscrypto-market-agent-{haiku,sonnet,opus}市值 Top N 实时行情汇总本文主题Coin Analysis Agentscrypto-coin-analyzer-{haiku,sonnet,opus}针对指定 TICKER 的价格、新闻、情绪与技术指标分析Macro Correlation Agentsmacro-crypto-correlation-scanner-{haiku,sonnet,opus}宏观与加密相关性扫描Investment Plays Agentscrypto-investment-plays-{haiku,sonnet,opus}带入场/出场策略与风险评分的投资机会命令前置元数据中还声明了allowed-tools: Bash(date:*), Bash(mkdir:*), Task, Write与argument-hint: [crypto_ticker_symbol]即允许执行时间戳与建目录命令、调度 Task、写文件并提示用户可传币种代码如 BTC、ETH、SOL。执行流程要点先执行date %Y-%m-%d_%H-%M-%S生成人类可读时间戳创建输出目录outputs/timestamp/并行调用全部 12 个代理每个代理的完整、未修改输出原样写入对应文件outputs/timestamp/crypto_market/agent-name.md← 市场代理本文主题的落盘位置outputs/timestamp/crypto_analysis/、crypto_macro/、crypto_plays/分别承接其余三组全部完成后报告outputs/timestamp/目录路径及成功代理数/总数。这也是一个链式编排的范例市场代理输出的行情快照可以无缝喂给投资策略代理做下一步分析——正如 README.md 中举例的 First analyze the market with crypto-market-agent, then use crypto-investment-plays to find opportunities。Subagent 机制要点回顾结合仓库内的官方文档副本 ai_docs/claude_code_subagents_docs.md 与 README.md本代理依赖的机制要点可总结为文件格式Markdown YAML frontmatterfrontmatter 定义元数据正文成为该代理的系统提示词。Subagent 只接收自己的系统提示词与基础环境信息不继承主会话完整上下文作用域与优先级--agentsCLI 传入 项目级.claude/agents/ 用户级~/.claude/agents/ 插件目录本项目级代理随仓库提交到版本控制团队成员可协作改进工具控制tools白名单 /disallowedTools黑名单本代理仅授予WebSearch, Write体现最小权限原则自动委托委托决策依据 你的请求任务描述 代理的description 当前上下文description写得越具体路由越精准独立上下文每次调用都是全新实例无历史记忆——因此提示词中把所有必要信息如 TOP_N 默认值、指标清单、输出模板全部写死这正是该提示词文件自包含的设计价值。工程实践小结从crypto-market-agent-sonnet这个例子可以提炼出三条可复用的 Subagent 工程经验薄代理 独立提示词文件agent 文件只做注册name/description/tools/model/color 一条Read and Execute指令把体量较大的系统提示词放到.claude/commands/agent_prompts/下独立维护。同类代理共享同一提示词避免三份文件三份拷贝的维护噩梦用 description 驱动路由在描述中明确职责范围real-time ... Top N cryptocurrencies by market cap并加上 use proactively让主 Agent 精准自动委托输出契约先行在执行提示词里定义标准化的 Markdown 表格输出模板与元信息数据来源、时间戳既约束了 AI 行为的确定性又让结果能被下游代理与文件系统直接消费。【免费下载链接】claude-code-hooks-masteryMaster Claude Code Hooks项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-hooks-mastery创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
用 Claude Code 构建实时加密市场数据 Subagent：crypto-market-agent-sonnet 完整实战指南
用 Claude Code 构建实时加密市场数据 Subagentcrypto-market-agent-sonnet 完整实战指南【免费下载链接】claude-code-hooks-masteryMaster Claude Code Hooks项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-hooks-mastery本文以当前仓库中的 crypto-market-agent-sonnet.md 及其背后的执行提示词 crypto_market_agent_prompt.md 为骨架完整拆解「如何用 Claude Code Subagent 体系封装一个按市值排名 Top N 的加密货币实时行情检索与汇总代理」。读完本文你将掌握 Subagent 文件的前置元数据写法、薄代理 独立提示词文件的工程化组织方式、TOP_N 参数化传参、标准化 Markdown 表格输出约定以及它与仓库中 12 个加密 Agent 并行编排crypto_research.md的联动关系。一图看懂agent 定义文件与执行提示词的分层设计crypto-market-agent-sonnet是一个典型的 Claude Code 项目级 Subagent位于.claude/agents/crypto/完整文件只有 9 行--- name: crypto-market-agent-sonnet description: Use proactively for real-time cryptocurrency market data retrieval and analysis for Top N cryptocurrencies by market cap tools: WebSearch, Write model: sonnet color: blue --- Read and Execute: .claude/commands/agent_prompts/crypto_market_agent_prompt.md它的设计非常克制由两部分组成YAML 前置元数据frontmatter定义代理的身份、触发条件、工具权限与模型档位正文一条指令Read and Execute指向独立的执行提示词文件将完整系统提示词从 agent 文件中剥离。这是一种值得借鉴的**薄代理thin agent模式**代理定义文件只负责注册真正的工作逻辑全部沉淀在 crypto_market_agent_prompt.md 中方便独立维护、版本管理与复用。前置元数据逐字段解析字段本文件取值作用namecrypto-market-agent-sonnet唯一标识使用小写字母与连字符命名Claude 依据它与 description 决定何时委托任务descriptionUse proactively for real-time cryptocurrency market data retrieval and analysis for Top N cryptocurrencies by market cap触发委托的关键字段。官方文档见仓库内 ai_docs/claude_code_subagents_docs.md明确Claude 通过每个 Subagent 的description判断何时把任务委派给它建议在描述中加入 use proactively 这类措辞鼓励主动委托toolsWebSearch, Write工具白名单。WebSearch负责实时行情检索Write用于把结果写入文件在crypto_research编排中要求落盘。若省略该字段Subagent 将继承主会话的全部工具modelsonnet模型档位可选sonnet、opus、haiku或inherit继承主会话模型。sonnet 在能力与速度/成本之间取得平衡colorblue终端 UI 中标识该代理的背景色便于在运行时区分当前是哪个 Subagent 在工作三档模型矩阵同一套分工haiku / sonnet / opus 各司其职仓库用同一套执行提示词声明了三个仅模型档位与颜色不同的市场数据代理文件modelcolor适用场景crypto-market-agent-haiku.mdhaikugreen快速、低成本的行情速览适合高频调用crypto-market-agent-sonnet.mdsonnetblue能力与成本均衡的默认档位crypto-market-agent-opus.mdopusred复杂市场解读与多源交叉验证三个文件的description完全相同因此 Claude 在自动委托时会把行情类任务路由给该家族而模型档位的差异则让使用者可以在成本敏感haiku与分析深度优先opus之间显式选择。仓库 README.md 的 Sub-Agents 章节也点明了这一设计动机通过把任务路由到更快更便宜的模型如 Haiku来控制成本。需要留意一个细节差异官方文档副本ai_docs/claude_code_subagents_docs.md指出model字段省略时默认值为inherit继承主会话模型而 README.md 的注释示例写作defaults to sonnet。本仓库的三款代理都显式声明了model这本身也是最稳妥的做法——不依赖默认值语义行为完全可预期。执行提示词深度解析市场数据专家如何工作被Read and Execute指向的 crypto_market_agent_prompt.md 才是这套代理真正的工作说明书共四部分Purpose角色定位、Variables变量、Instructions工作守则与 Output Format输出格式。角色定位PurposeYou are a cryptocurrency market data specialist focused on retrieving and summarizing real-time market information for major cryptocurrencies.代理被定义为加密货币市场数据专家职责是检索并汇总主流币种的实时市场信息而非做深度投资分析那是 crypto-coin-analyzer 与 crypto-investment-plays 家族的职责见下文编排章节。变量TOP_N 参数化- **TOP_N**: $ARGUMENTS or 10 - The number of top cryptocurrencies to retrieve (defaults to 10 if not specified) - Used for: Determining how many cryptocurrencies to include in the market summary$ARGUMENTS是 Claude Code 的运行时参数占位符当用户以agent-crypto-market-agent-sonnet 20之类方式带参调用时TOP_N取传入值如上例为 20未传参时回退为默认值10。该变量直接决定市场摘要中包含多少只币种。工作守则Instructions提示词为代理规定了七条硬性行为约束核心要点如下锁定实时数据检索词应面向实时/最新行情例如BTC ETH current price market cap live优先聚合页寻找能在单页展示多币种的数据聚合器减少搜索调用次数多源交叉验证若初次结果看起来过期或不一致须交叉核对多个数据源标注来源与时间戳最终摘要尽量附上数据来源与抓取时间保证可溯源优雅降级某项指标取不到时明确注明哪些指标未能获取而非编造数字遵守输出格式必须以下方 Output Format 规定的格式输出不得自由发挥。工作流Workflow调用后必须按序执行 7 步确定要检索的币种数量有TOP_N用它否则用默认值 10按市值搜索 Top N 币种的实时行情检索词形如Top [TOP_N] cryptocurrencies by market cap live prices对每只币种收集 4 项指标当前价格美元市值Market Capitalization24 小时交易量24 小时价格涨跌幅百分比优先用一次查询覆盖多币种的检索词如top [TOP_N] cryptocurrencies by market cap live prices最小化搜索调用聚焦可靠信源CoinMarketCap、CoinGecko 或主流财经新闻站点通过时间戳核验数据新鲜度规范数值格式价格保留 24 位小数大数用 B十亿/ M百万后缀。输出格式标准化 Markdown 表格提示词要求代理严格按以下模板输出这是可被下游消费的关键设计——结构化表格既便于主 Agent 二次加工也便于直接落盘为报告## Cryptocurrency Market Summary | Cryptocurrency | Current Price | Market Cap | 24h Volume | 24h Change | | -------------- | ------------- | ---------- | ---------- | ---------- | | [Crypto 1] | $X,XXX.XX | $XXX.XX B | $XX.XX B | ±X.XX% | | [Crypto 2] | $X,XXX.XX | $XXX.XX B | $XX.XX B | ±X.XX% | | [Crypto 3] | $X.XXXX | $XX.XX B | $X.XX B | ±X.XX% | | ... | ... | ... | ... | ... | | [Crypto N] | $X.XXXX | $XX.XX B | $X.XX B | ±X.XX% | **Data Source:** [Source Name] **Last Updated:** [Timestamp if available]表格末尾强制附带Data Source与Last Updated两行元信息配合工作守则中的多源交叉验证从提示词层面杜绝了 AI 编造行情数据的可能。实战使用如何触发这个 Subagent有三种典型触发方式1. 显式指名调用最直接Use the crypto-market-agent-sonnet to get the current top 10 crypto prices主 Agent 会据此把任务委派给该代理代理在独立上下文窗口中执行并把摘要结果返回给主会话。2. 自动委托由于description中带有 Use proactively for real-time cryptocurrency market data retrieval...当你在对话中提出查一下当前市值前 10 的币种行情这类需求时Claude 会自动判断并路由到该代理家族。3. 带参调用配合TOP_N变量传入币种数量参数即可改变摘要规模默认不传则取 10。触发后你可以通过仓库的 Subagent 生命周期 Hook 观察执行痕迹.claude/hooks/subagent_start.py会在 Subagent 启动时写入日志README 中描述为 Subagent spawn logging with optional TTS announcement.claude/hooks/subagent_stop.py则记录完成事件日志统一落在logs/目录。关于信息流需要牢记 Subagent 机制的一条核心原则README 称之为最常见的误解agent 文件中的正文是系统提示词不是用户提示词Subagent 从不直接与你对话它响应主 Agent 的委托并把结果回报给主 Agent再由主 Agent 综合呈现给你。仓库级联动12 个加密 Agent 的并行编排单个市场代理的价值在仓库的 crypto_research.md 编排命令中被放大为完整的加密研究工作流。该命令使用agent-*引用语法一次并行调度 12 个代理分为四组组别代理家族职责Market Data Agentscrypto-market-agent-{haiku,sonnet,opus}市值 Top N 实时行情汇总本文主题Coin Analysis Agentscrypto-coin-analyzer-{haiku,sonnet,opus}针对指定 TICKER 的价格、新闻、情绪与技术指标分析Macro Correlation Agentsmacro-crypto-correlation-scanner-{haiku,sonnet,opus}宏观与加密相关性扫描Investment Plays Agentscrypto-investment-plays-{haiku,sonnet,opus}带入场/出场策略与风险评分的投资机会命令前置元数据中还声明了allowed-tools: Bash(date:*), Bash(mkdir:*), Task, Write与argument-hint: [crypto_ticker_symbol]即允许执行时间戳与建目录命令、调度 Task、写文件并提示用户可传币种代码如 BTC、ETH、SOL。执行流程要点先执行date %Y-%m-%d_%H-%M-%S生成人类可读时间戳创建输出目录outputs/timestamp/并行调用全部 12 个代理每个代理的完整、未修改输出原样写入对应文件outputs/timestamp/crypto_market/agent-name.md← 市场代理本文主题的落盘位置outputs/timestamp/crypto_analysis/、crypto_macro/、crypto_plays/分别承接其余三组全部完成后报告outputs/timestamp/目录路径及成功代理数/总数。这也是一个链式编排的范例市场代理输出的行情快照可以无缝喂给投资策略代理做下一步分析——正如 README.md 中举例的 First analyze the market with crypto-market-agent, then use crypto-investment-plays to find opportunities。Subagent 机制要点回顾结合仓库内的官方文档副本 ai_docs/claude_code_subagents_docs.md 与 README.md本代理依赖的机制要点可总结为文件格式Markdown YAML frontmatterfrontmatter 定义元数据正文成为该代理的系统提示词。Subagent 只接收自己的系统提示词与基础环境信息不继承主会话完整上下文作用域与优先级--agentsCLI 传入 项目级.claude/agents/ 用户级~/.claude/agents/ 插件目录本项目级代理随仓库提交到版本控制团队成员可协作改进工具控制tools白名单 /disallowedTools黑名单本代理仅授予WebSearch, Write体现最小权限原则自动委托委托决策依据 你的请求任务描述 代理的description 当前上下文description写得越具体路由越精准独立上下文每次调用都是全新实例无历史记忆——因此提示词中把所有必要信息如 TOP_N 默认值、指标清单、输出模板全部写死这正是该提示词文件自包含的设计价值。工程实践小结从crypto-market-agent-sonnet这个例子可以提炼出三条可复用的 Subagent 工程经验薄代理 独立提示词文件agent 文件只做注册name/description/tools/model/color 一条Read and Execute指令把体量较大的系统提示词放到.claude/commands/agent_prompts/下独立维护。同类代理共享同一提示词避免三份文件三份拷贝的维护噩梦用 description 驱动路由在描述中明确职责范围real-time ... Top N cryptocurrencies by market cap并加上 use proactively让主 Agent 精准自动委托输出契约先行在执行提示词里定义标准化的 Markdown 表格输出模板与元信息数据来源、时间戳既约束了 AI 行为的确定性又让结果能被下游代理与文件系统直接消费。【免费下载链接】claude-code-hooks-masteryMaster Claude Code Hooks项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-hooks-mastery创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考