@caidazi/mcp 0.2.0

package/README.md

@@ -0,0 +1,169 @@
+# 财搭子外部 Skills
+
+面向通用 AI Agent 的公开 skill 包。
+
+本仓库包含两部分：
+
+- `@caidazi/mcp`：通用 stdio MCP bridge。Agent 通过标准 MCP 调用工具，bridge 内部转发到财搭子后端。
+- `caidazi-*` skills：告诉 Agent 什么时候调用财搭子工具、如何处理 API Key/工具不可用、结果如何组织。
+
+投资逻辑、数据拼接、候选生成、打分和私有账户访问都留在服务端 wrapper 内部。
+
+统一使用 `CAIDAZI_API_KEY`。
+
+## Agent 安装契约
+
+如果你是正在安装本仓库的 AI Agent，请以 `manifest.yaml` 为真源，不要写死某个客户端的旧配置路径。
+
+1. 拉取 `https://github.com/caidazi/dafa-skills.git`，读取 `manifest.yaml`。
+2. 安装 `skills.included` 中的 skill 目录；如果当前 Agent 不支持 skills，继续配置 MCP，并在报告中说明没有 skill 路由增强。
+3. 配置 MCP，默认使用 stdio bridge：
+   - name: `mcp.server_name`
+   - transport: `mcp.transport`
+   - command: `mcp.command`
+   - args: `mcp.args`
+   - env: `CAIDAZI_API_KEY`，key 必须来自 secret/env 引用
+   - config: 使用当前 Agent 官方支持的 MCP 配置方式；不要猜测旧配置路径。
+4. 处理 API Key：
+   - 不要生成 key，不要要求用户把完整 key 发到聊天里。
+   - 不要通过 `printenv`、`echo`、日志、截图或最终报告回显完整 key。
+   - 不要把 key 写入仓库、README、issue、PR 或普通项目配置文件。
+   - 如果缺 key，引导用户到财搭子 App 领取，并用 secret store、MCP 配置 UI、本机环境变量或交互式 secret 输入设置。
+5. 处理 endpoint 安全：
+   - 默认不要把后端 REST API 配成 Agent 的 MCP endpoint。
+   - `backend_api.test_base_url` 是 bridge 的临时后端地址，不是 Agent-facing MCP endpoint。
+   - 如果后端地址是 HTTP，必须显式设置 `CAIDAZI_ALLOW_HTTP=true`，表示用户确认这是可信测试环境。
+   - hosted HTTPS MCP 端点上线并通过健康检查后，才可改用 `mcp.hosted_endpoint`。
+6. 验证：
+   - 先做本地验证：manifest 可解析、skills 已索引或 MCP-only、MCP 配置已写入或生成草案。
+   - MCP 必须完成当前 Agent 的 MCP 健康检查；只安装 skills 不能算 MCP 已接入。
+   - Agent 必须能通过 MCP tools/list 发现 `required_mcp.public_tools`。
+   - 网络 smoke test 只能使用 `required_mcp.smoke_safe_tools`。
+   - 禁止用自选、持仓、组合工具做安装验证；这些账户工具只在用户主动询问个人资产时使用。
+7. 安装后向用户说明能做什么，区分公开能力和账户能力，并询问用户想先做哪类任务。
+
+安装报告请保持简短，包含：skills 模式、MCP 配置状态、API Key 状态（不回显 key）、传输安全、公开工具可见性、smoke test 结果或跳过原因。
+
+### 通用 MCP 配置
+
+具体 server name、command、args、env 和验证规则以 `manifest.yaml` 为准。大多数支持 stdio MCP 的 Agent 都可以使用下面的形状；具体写入位置必须使用当前 Agent 官方支持的 MCP 配置方式。
+
+```json
+{
+  "mcpServers": {
+    "caidazi": {
+      "command": "npx",
+      "args": ["-y", "@caidazi/mcp"],
+      "env": {
+        "CAIDAZI_API_KEY": "<set by your Agent secret/env>",
+        "CAIDAZI_ALLOW_HTTP": "true"
+      }
+    }
+  }
+}
+```
+
+`CAIDAZI_ALLOW_HTTP=true` 只用于当前临时测试后端。生产后端改为 HTTPS 后应移除。
+
+如果 `@caidazi/mcp` 还没有发布到 npm registry，安装 Agent 可以临时把 args 中的 `@caidazi/mcp` 替换为 `github:caidazi/dafa-skills`。正式对外安装仍应发布 npm 包，因为这是 `npx -y @caidazi/mcp` 能跨 Agent 稳定工作的前提。
+
+本地开发验证：
+
+```bash
+npm install
+CAIDAZI_API_KEY=<redacted> CAIDAZI_ALLOW_HTTP=true npm run validate
+```
+
+## 用户快速开始
+
+复制下面这段发给你的 AI Agent：
+
+```text
+请为我安装财搭子（Caidazi）Skills 和 MCP。
+
+Repo: https://github.com/caidazi/dafa-skills.git
+
+请读取 README.md 和 manifest.yaml，以 manifest.yaml 为安装真源。
+
+要求：
+1. 安装 manifest.yaml 中列出的 skills；如果当前 Agent 不支持 skills，请进入 MCP-only 模式并说明限制。
+2. 配置 caidazi MCP，server name、transport、command、args、env 都从 manifest.yaml 读取。
+3. 检查 CAIDAZI_API_KEY。
+4. 如果没有 key，不要生成 key，不要让我把完整 key 发到聊天里。请告诉我到财搭子 App -> 大发 agent 页面 -> 左上角 skill icon -> Skills 页面领取，然后用当前 Agent 支持的安全方式设置为 CAIDAZI_API_KEY。
+5. 默认使用 `@caidazi/mcp` stdio bridge。如果 npm registry 还找不到该包，请按 manifest.yaml 的 unpublished_fallback 临时从 GitHub 运行，并在安装报告里说明。当前测试后端是 HTTP，只有我明确授权时才设置 `CAIDAZI_ALLOW_HTTP=true`。
+6. 验证时只调用 smoke_safe_tools，不要调用我的自选、持仓或组合工具。
+7. 安装完成后，请简短说明财搭子能做什么，并问我想先做哪类任务。
+```
+
+## API Key
+
+在财搭子 App 中领取：
+
+1. 打开财搭子 App。
+2. 进入大发 agent 页面。
+3. 点击左上角的 skill icon。
+4. 进入 Skills 页面，领取或复制 API Key。
+5. 用安全方式设置为 `CAIDAZI_API_KEY`。
+
+不要把完整 API Key 粘贴到聊天、日志或公开文件里。Agent 只能报告 key 是否存在、是否可用，不应回显完整 key。
+
+## Endpoint 安全
+
+Agent-facing MCP 默认使用 `@caidazi/mcp` stdio bridge。bridge 内部会调用后端 REST API，但 Agent 侧看到的是标准 MCP tools/list 和 tools/call。
+
+`backend_api.test_base_url` 是临时测试后端，不是 Agent-facing MCP endpoint。不要把 `/api/tools/registered` 或 `/api/tools/call` 直接配置成 MCP endpoint。hosted HTTPS MCP 端点上线后，必须先通过 MCP initialize/tools-list 健康检查，再作为 `mcp.hosted_endpoint` 使用。
+
+## 发布 npm 包
+
+`@caidazi/mcp` 要对外支持 `npx -y @caidazi/mcp`，必须发布到 npm registry。只放在 GitHub repo 里，可以被临时 GitHub package spec 使用，但不是最丝滑的默认安装路径。
+
+发布前检查：
+
+```bash
+npm test
+CAIDAZI_API_KEY=<redacted> CAIDAZI_ALLOW_HTTP=true npm run validate
+npm pack --dry-run
+```
+
+首次发布需要：
+
+```bash
+npm login
+npm whoami
+npm publish
+```
+
+发布账号必须有 `@caidazi` scope 的发布权限。本仓库尚未声明 license；正式公开发布前请先确认公司希望使用的开源授权，再补 `license` 字段和 LICENSE 文件。
+
+## 能做什么
+
+公开能力：
+
+- 市场脉搏：热点、大盘走势、板块概览、盘前盘中盘后摘要。
+- 单标的研究：股票、ETF、基金、指数的快速研究和原因分析。
+- 多标的比较：比较多个股票、ETF、基金或指数。
+- 自然语言选股：用自然语言筛选候选股票或 ETF。
+- 财经搜索：搜索资讯、公告、研报、政策和事件进展。
+- 基金/ETF 研究：查询 ETF 持仓、指数相关 ETF、基金和 ETF 对比。
+- 宏观研究：分析政策、利率、通胀、汇率和大类资产影响。
+
+账户能力需要 API Key 已绑定财搭子账户，且只能在用户主动询问个人资产时使用：
+
+- 用户资产上下文：查询并使用财搭子自选、持仓和组合快照。
+- 组合复盘：基于财搭子自选、持仓或组合快照做轻量复盘。
+
+样例 query：
+
+- 今天 A 股市场热点是什么？
+- 帮我看下宁德时代最近的核心矛盾。
+- 比亚迪和宁德时代谁更值得跟踪？
+- 找出最近资金强、估值不贵的新能源股票。
+- 纳指 ETF 和恒生科技 ETF 怎么选？
+- 我的自选里今天哪些最值得关注？（会读取账户资产，需你主动发起）
+
+## 边界
+
+- 不要暴露 API Key、内部表名、原始查询指令、内部账户工具名或具体打分规则。
+- 不要编造行情、公告、研报、宏观数据或用户资产。
+- 不要把候选标的表述为收益承诺或确定性买卖建议。
+- 不要默认读取用户持仓或自选作为安装验证。

package/bin/caidazi-mcp.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { main } from "../src/cli.js";
+
+main().catch((error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  process.stderr.write(`${message}\n`);
+  process.exitCode = 1;
+});

package/caidazi-asset-research/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: caidazi-asset-research
+description: 当用户询问股票、ETF、基金、指数的快速研究，或想比较多个标的时使用。
+---
+
+# 财搭子资产研究
+
+用这个 skill 处理单个标的研究和简单多标的比较。公开流程要尽量少调用、少澄清，优先通过 MCP wrapper 完成。
+
+## 适用场景
+
+- "帮我看看贵州茅台"
+- "这个 ETF 怎么样"
+- "纳指和恒生科技对比一下"
+- "比亚迪和宁德时代谁更强"
+- "这只股票最近为什么动"
+- "我的自选里哪几个值得重点关注"
+
+不要用于完整组合诊断、交易执行、自然语言选股或长篇研报。
+
+## 可用工具
+
+- `extract_assets`
+- `get_asset_overview`
+- `investment_search_pro`
+- `compare_assets`
+- `get_caidazi_user_watchlist`
+- `get_caidazi_positions_summary`
+
+## 标的识别
+
+用户给出明确代码或名称时直接继续。名称有歧义时调用 `extract_assets`。如果多个标的都可能匹配，且用户只想看一个，最多问一个澄清问题。
+
+当用户提到财搭子私有数据：
+
+- "我的自选"：调用 `get_caidazi_user_watchlist()`。
+- "我的持仓"：调用 `get_caidazi_positions_summary(mask_sensitive=true)`。
+
+如果账户数据不可用，说明用户可到 财搭子 App -> 大发 agent -> 左上角 skill icon -> Skills 页面领取或绑定账户关联 API Key；在有价值时继续用公开行情数据回答。
+
+## 单标的流程
+
+1. 识别标的。
+2. 调用 `get_asset_overview(symbol=...)`。
+3. 用户问"为什么"、"最新"、"新闻"，或提到具体事件时，再调用 `investment_search_pro`。
+4. 只基于工具返回内容回答。
+
+## 多标的比较
+
+两个或更多标的时优先使用 `compare_assets`。
+
+推荐参数：
+
+- `symbols`：来自用户或 `extract_assets` 的规范化代码/名称。
+- `metrics`：按用户问题推断，默认 `["price", "valuation", "overview"]`。
+- `period`：默认 `"latest"`；用户提到今天、本周、本月时分别使用对应周期。
+
+当 `compare_assets` 能完成任务时，不要手动循环调用原始工具。
+
+## 澄清策略
+
+最多问一个问题，限于这些情况：
+
+- 标的无法确定；
+- 比较对象缺失；
+- 用户问"我的资产"，但 API Key 未关联账户且任务无法继续。
+
+不要询问风险偏好。这个 skill 只做研究和比较。
+
+## 输出结构
+
+单标的：
+
+1. 一句话观点。
+2. 概况：业务、位置、近期变化。
+3. 催化：事件、行业或资金线索。
+4. 估值/资金/风险：只展示工具返回内容。
+5. 待验证问题：哪些数据会改变当前判断。
+
+多标的：
+
+1. 简短结论。
+2. 表格列出每个标的和用户关心的指标。
+3. 主要差异。
+4. 数据缺口。
+
+## 错误处理
+
+- API Key 无效或过期：引导用户到 财搭子 App -> 大发 agent -> 左上角 skill icon -> Skills 页面重新领取。
+- 工具调用失败：按工具返回的 `message` 说明，不自行推断后台策略。
+- 标的未找到：请用户补充更清晰的代码或名称。
+- 工具未开放：说明该能力暂未对外部 Agent 开放。
+
+## 边界
+
+- 不要说"如果我是你"，不要给直接买卖指令。
+- 不要暴露内部打分、字段映射或工具编排细节。
+- 不要提内部服务名。
+- 不要透露 API Key。

package/caidazi-finance-search/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: caidazi-finance-search
+description: 当用户搜索财经新闻、公告、研报、政策、事件进展，或想查某个主题的最新公开信息时使用。
+---
+
+# 财搭子财经搜索
+
+用这个 skill 处理高时效的资讯、公告、研报和政策检索。公开 skill 只描述检索目标和输出方式，信源权重、事件聚类和关联分析留在 MCP 内部。
+
+## 适用场景
+
+- "搜一下今天半导体有什么新闻"
+- "宁德时代最近公告有哪些"
+- "这个政策原文和市场解读是什么"
+- "最近有哪些关于机器人产业链的研报"
+- "帮我查一下某公司为什么大涨"
+
+不要用于纯行情查询、自然语言选股或完整研报生成。
+
+## 可用工具
+
+- `investment_search_pro`
+- `get_asset_overview`，仅当用户追问某个标的研究时使用。
+- `get_hot_report` 或 `get_real_time_market_summary`，仅当用户从资讯转向大盘或热点概览时使用。
+
+## 流程
+
+1. 提取检索 query：公司、行业、政策、事件或关键词。
+2. 推断 `channels`：新闻、公告、研报、政策；不确定时留空交给 wrapper。
+3. 推断 `time_range`：默认最近 7 天；用户说"今天"、"最近"、"今年"时分别传入。
+4. 调用 `investment_search_pro(query=...)`。
+5. 只总结工具返回的来源、发布时间和摘要。
+
+## 澄清策略
+
+最多问一个问题，且只在关键词过短、无法判断领域时提问。
+
+如果用户给出公司或主题，即使没有指定时间，也直接用默认时间范围。
+
+## 输出结构
+
+1. 一句话结论。
+2. 信息列表：标题、时间、来源、摘要。
+3. 可能影响：只引用工具返回内容。
+4. 数据覆盖和时效限制。
+5. 下一步建议：看某个标的、筛相关候选或查看市场影响。
+
+## 错误处理
+
+- API Key 无效：引导用户到 财搭子 App -> 大发 agent -> 左上角 skill icon -> Skills 页面重新领取。
+- 工具调用失败：按工具返回的 `message` 说明，不自行推断后台策略。
+- 没有结果：建议放宽关键词、时间范围或渠道。
+- 工具未开放：说明资讯搜索暂未对外部 Agent 开放。
+
+## 边界
+
+- 不要编造新闻、公告或研报来源。
+- 不要暴露搜索召回、排序、信源权重或事件聚类规则。
+- 不要把未经验证的传闻写成事实。
+- 不要输出内部 endpoint、密钥或私有路径。

package/caidazi-fund-etf-research/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: caidazi-fund-etf-research
+description: 当用户询问基金、ETF、指数基金的研究、筛选、诊断、对比或配置候选时使用。
+---
+
+# 财搭子基金 ETF 研究
+
+用这个 skill 处理基金和 ETF 高频问题。公开 skill 只负责查询、筛选、比较和表达，基金评价、归因、持仓去噪和评分逻辑留在 MCP 内部。
+
+## 适用场景
+
+- "帮我看看这只 ETF"
+- "找几个港股科技 ETF"
+- "沪深300 ETF 哪个更适合跟踪"
+- "这只基金最近表现为什么差"
+- "我的自选里 ETF 哪些值得关注"
+
+不要用于基金销售承诺、收益保证、自动调仓或复杂资产配置方案。
+
+## 可用工具
+
+- `get_asset_overview`
+- `investment_search_pro`
+- `screen_stocks`
+- `compare_assets`
+- `get_etf_constituents`
+- `get_index_related_etfs`
+- `get_stock_belongings`
+- `get_caidazi_user_watchlist`
+
+## 流程
+
+单只基金或 ETF：
+
+1. 识别名称或代码。
+2. 调用 `get_asset_overview(symbol=...)`。
+3. 如果用户关心 ETF 持仓结构，调用 `get_etf_constituents(symbol, top_n)`。
+4. 只展示工具返回的规模、跟踪对象、费用、风险、持仓和近期变化。
+
+筛选基金或 ETF：
+
+1. 把用户条件整理成自然语言 query。
+2. 推断市场或品类：A 股 ETF、港股 ETF、美股 ETF、基金。
+3. 调用 `screen_stocks(query, market="ETF", limit)`。
+4. 不要手动构造字段筛选。
+
+对比：
+
+1. 两个或更多基金/ETF 时调用 `compare_assets(symbols, metrics, period)`。
+2. 不要循环调用多个底层工具拼表。
+
+## 澄清策略
+
+最多问一个问题。只有在基金名称高度歧义，或用户只说"推荐几个基金"但没有任何市场、方向或风格时提问。
+
+## 输出结构
+
+1. 一句话结论。
+2. 核心指标或候选表格。
+3. 适合继续研究的原因。
+4. 主要风险和数据时间。
+5. 下一步建议：比较、看持仓、查新闻或加入自选。
+
+## 错误处理
+
+- API Key 无效：引导用户到 财搭子 App -> 大发 agent -> 左上角 skill icon -> Skills 页面重新领取。
+- 工具调用失败：按工具返回的 `message` 说明，不自行推断后台策略。
+- 未找到基金：请用户提供更准确的名称或代码。
+- 空结果：建议放宽费率、规模、主题、市场或时间条件。
+
+## 边界
+
+- 不要承诺收益或保本。
+- 不要暴露基金评分模型、归因规则或候选池逻辑。
+- 不要输出内部字段、表名或 SQL。
+- 不要给明确买卖指令。

package/caidazi-macro-research/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: caidazi-macro-research
+description: 当用户询问宏观数据、政策、利率、通胀、流动性、汇率或大类资产影响时使用。
+---
+
+# 财搭子宏观研究
+
+用这个 skill 处理宏观和大类资产解释。公开 skill 只写查询与摘要结构，宏观框架、数据选择和传导判断由 MCP 返回。
+
+## 适用场景
+
+- "降息对 A 股有什么影响"
+- "最近国内宏观怎么看"
+- "美元走强会影响哪些资产"
+- "通胀数据出来后市场怎么理解"
+- "人民币汇率变化对港股有什么影响"
+
+不要用于单股深度、选股或组合诊断。
+
+## 可用工具
+
+- `get_macro_analysis`
+- `get_market_analysis`
+- `investment_search_pro`
+
+## 流程
+
+1. 判断宏观主题：利率、政策、通胀、汇率、流动性、经济数据或海外市场。
+2. 判断国家/地区：默认中国；用户提到美国、欧洲、日本、全球时对应传入。
+3. 调用 `get_macro_analysis(country)`。
+4. 如果用户问最新政策或刚发布数据，再调用 `investment_search_pro` 补充事实。
+5. 如果用户问市场影响，可用 `get_market_analysis` 衔接大盘状态。
+
+## 澄清策略
+
+最多问一个问题。国家/地区能从上下文判断时不要问。
+
+不要问风险偏好。这个 skill 解释宏观影响，不做交易适配。
+
+## 输出结构
+
+1. 一句话宏观判断。
+2. 当前数据或政策背景。
+3. 对股、债、商品、汇率或行业的传导影响。
+4. 置信度和反向风险。
+5. 接下来观察的数据。
+
+## 错误处理
+
+- API Key 无效：引导用户到 财搭子 App -> 大发 agent -> 左上角 skill icon -> Skills 页面重新领取。
+- 工具调用失败：按工具返回的 `message` 说明，不自行推断后台策略。
+- 数据不足：说明缺口，不要手动编宏观数据。
+- 工具未开放：说明宏观研究暂未对外部 Agent 开放。
+
+## 边界
+
+- 不要编造宏观数据、发布时间或政策原文。
+- 不要暴露宏观评分模型或传导权重。
+- 不要把宏观结论直接转成买卖指令。
+- 不要输出内部数据源路径。

package/caidazi-market-pulse/SKILL.md

@@ -0,0 +1,80 @@
+---
+name: caidazi-market-pulse
+description: 当用户询问市场热点、大盘走势、宏观影响、板块热度、盘前盘中盘后概览时使用。
+---
+
+# 财搭子市场脉搏
+
+用这个 skill 把宽泛的市场问题转成稳定的财搭子 MCP 调用。公开 skill 只负责路由和表达，不在本地复刻市场打分逻辑。
+
+## 适用场景
+
+- "今天市场热点是什么"
+- "A股/港股/美股怎么看"
+- "大盘为什么涨/跌"
+- "最近宏观有什么影响"
+- "哪些板块比较热"
+- "帮我做个盘前/盘中/收盘概览"
+
+不要用于深度单股研究、自然语言选股、完整行业深度或用户私有资产分析。
+
+## 可用工具
+
+- `get_hot_report`
+- `get_real_time_market_summary`
+- `get_market_analysis`
+- `get_macro_analysis`
+- `investment_search_pro`
+- `get_caidazi_portfolio_snapshot`，仅当用户明确询问"我的自选"或"我的持仓"时使用。
+
+## 快速流程
+
+1. 判断市场范围：A 股、港股、美股、ETF 或全球。
+2. 用户问"今天"、"现在"、"盘中"、"实时"时，直接调用 `get_real_time_market_summary`。
+3. 用户问热点、主题或活跃板块时，直接调用 `get_hot_report`。
+4. 用户问大盘方向、估值或市场状态时，直接调用 `get_market_analysis`。
+5. 用户问利率、政策、通胀、流动性或全球宏观时，直接调用 `get_macro_analysis`。
+6. 只有当摘要工具覆盖不足，且用户提到具体事件或最新新闻时，再用 `investment_search_pro` 补充。
+
+## 私有资产上下文
+
+当用户问"我的自选受影响吗"或"对我的持仓怎么看"：
+
+1. 调用 `get_caidazi_portfolio_snapshot(scope="all", mask_sensitive=true)`。
+2. 如果返回 API Key 未绑定账户，提示用户到 财搭子 App -> 大发 agent -> 左上角 skill icon -> Skills 页面领取或绑定 key。
+3. 如果返回了资产，只基于返回资产分析市场影响，不要编造未返回的持仓。
+
+## 澄清策略
+
+最多问一个问题，并且只在市场或时间范围完全无法判断时提问。
+
+好问题：
+
+> 你想看 A 股、港股、美股，还是全部市场？
+
+不要询问风险偏好。这个 skill 是市场研究入口，不是交易决策入口。
+
+## 输出结构
+
+保持简洁：
+
+1. 一句话结论。
+2. 三到五个市场驱动因素。
+3. 热门板块、资金或资产，如果工具返回。
+4. 接下来值得观察的信号。
+5. 数据时间、延迟或覆盖限制，如果有。
+
+只有在比较多个板块或指数时使用表格。优先用自然中文解释，少用公式。
+
+## 错误处理
+
+- `API_KEY_INVALID`：说明 key 无效或过期，引导用户到 财搭子 App -> 大发 agent -> 左上角 skill icon -> Skills 页面重新领取。
+- `TOOL_NOT_AVAILABLE_EXTERNALLY`：说明该能力暂未对外部 Agent 开放。
+- 其他工具错误：按工具返回的 `message` 用中文解释，不自行推断后台策略。
+
+## 边界
+
+- 不要把工具结果包装成投资建议。
+- 不要编造指数点位、宏观数据、板块排名或新闻。
+- 不要透露内部排名、权重、数据拼接或账户查询细节。
+- 不要在回答中暴露 API Key。

package/caidazi-portfolio-review/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: caidazi-portfolio-review
+description: 当用户希望基于财搭子自选、持仓或组合快照做摘要、风险暴露、变动检查或复盘时使用。
+---
+
+# 财搭子组合复盘
+
+用这个 skill 做轻量组合摘要和风险暴露检查。它依赖账户关联 API Key，是主端回流入口；不要把它写成完整组合诊断或自动调仓能力。
+
+## 适用场景
+
+- "帮我复盘一下我的持仓"
+- "我的组合最近风险在哪里"
+- "我的自选和持仓有哪些重合"
+- "看一下我的资产受今天热点影响吗"
+- "给我的组合做个摘要"
+
+不要用于下单、调仓、收益承诺或完整投顾建议。
+
+## 可用工具
+
+- `get_caidazi_portfolio_snapshot`
+- `get_caidazi_positions_summary`
+- `get_caidazi_user_watchlist`
+- `get_real_time_market_summary`
+- `get_hot_report`
+- `investment_search_pro`
+
+## 流程
+
+1. 调用 `get_caidazi_portfolio_snapshot(scope="all", mask_sensitive=true)`。
+2. 如果工具返回未授权，提示用户到 财搭子 App -> 大发 agent -> 左上角 skill icon -> Skills 页面领取或绑定 API Key。
+3. 如果用户问市场影响，再调用 `get_real_time_market_summary` 或 `get_hot_report`。
+4. 如果用户问某个事件影响，再调用 `investment_search_pro` 补充事实。
+5. 只基于返回资产做摘要，不要推断完整券商账户。
+
+## 澄清策略
+
+最多问一个问题。只有在用户要复盘但没有说明看自选、持仓还是全部资产时，可以默认 `all`，不要打断。
+
+## 输出结构
+
+1. 组合快照：资产数量、市场分布、可见范围。
+2. 主要暴露：行业、主题、单一资产集中度，仅展示工具返回内容。
+3. 今日或近期关联事件，如果有。
+4. 待检查事项：需要用户回主端确认的数据。
+5. 下一步建议：研究某个资产、筛选候选或查看市场脉搏。
+
+## 错误处理
+
+- `ASSET_PERMISSION_REQUIRED` 或未绑定账户：引导用户回财搭子领取或绑定 key。
+- API Key 无效：引导用户重新领取。
+- 工具调用失败：按工具返回的 `message` 说明，不自行推断后台策略。
+- 持仓不可用但自选可用：说明边界，继续用自选做轻量复盘。
+
+## 边界
+
+- 不要声称拥有完整券商账户访问权。
+- 不要展示工具未返回的金额、成本、盈亏或仓位。
+- 不要给直接买卖和调仓指令。
+- 不要持续监控或订阅提醒。