skillpp 0.1.0

package/registry.md

@@ -0,0 +1,209 @@
+# Skill++ 技能注册表 (Skill Registry)
+
+> **给 AI 的阅读指引**：读完此表即可知道"有哪些 skill 可用，每个能干什么"。
+> 每个 skill 以 **5 行名片** 描述：名称 / 一句话 / 触发词 / 输入 / 输出。
+
+---
+
+## 🔥 PRIMARY SKILLS — 链上 / Web3 / 扫链 / 项目分析
+
+### 1. query-token-info（代币信息查询）
+- **做什么**：搜索代币、查元数据、实时行情、K线数据
+- **触发词**：`$XXX价格` `搜索代币XXX` `XXX的合约地址` `查K线` `这个币的市值`
+- **需要输入**：`keyword`(代币名/符号/地址) | `chainId` | `contractAddress`
+- **输出**：代币名称、符号、logo、价格、24h涨跌、持仓人数、流动性、K线数据
+- **位置**：`skills/binance-web3/query-token-info\`
+
+### 2. query-token-audit（代币安全审计）
+- **做什么**：代币合约安全扫描，检测蜜罐、Rug Pull、恶意函数
+- **触发词**：`安全吗` `审计` `扫描` `检测` `是不是骗局` `honeypot`
+- **需要输入**：`chainId` | `contractAddress`
+- **输出**：风险等级(0-5)、详细风险项列表、买卖税率、是否验证
+- **位置**：`skills/binance-web3/query-token-audit\`
+
+### 3. query-address-info（钱包地址查询）
+- **做什么**：查任意链上地址的持仓组合（代币+价格+24h涨跌+数量）
+- **触发词**：`钱包里有啥` `查地址` `持仓` `我的钱包` `balance`
+- **需要输入**：`address`(钱包地址) | `chainId` | `offset`(分页)
+- **输出**：持仓列表[{代币名, 符号, 图标, 价格, 24h涨跌, 持仓数量}]
+- **位置**：`skills/binance-web3/query-address-info\`
+
+### 4. trading-signal（聪明钱交易信号）
+- **做什么**：追踪链上聪明钱的实时买卖信号，含触发价/当前价/最大收益/退出率
+- **触发词**：`聪明钱` `信号` `鲸鱼` `大户` `跟单` `alpha` `smart money`
+- **需要输入**：`chainId` | `page` | `pageSize`(最大100)
+- **输出**：信号列表[{方向(买/卖), 代币, 触发价, 当前价, 最大收益%, 聪明钱数量, 退出率}]
+- **位置**：`skills/binance-web3/trading-signal\`
+
+### 5. crypto-market-rank（加密市场排行榜）
+- **做什么**：五大排行榜——社交热度/趋势/聪明钱流入/Meme/PnL榜
+- **触发词**：`排行榜` `趋势` `热门` `热搜` `资金流入` `top` `涨幅榜`
+- **需要输入**：`chainId` | `rankType`(排行榜类型) | `period`(时间窗口)
+- **输出**：排名列表[{代币, 价格, 涨跌%, 成交量, 市值, 持有人数}]
+- **位置**：`skills/binance-web3/crypto-market-rank\`
+
+### 6. meme-rush（Meme 发射台追踪）
+- **做什么**：实时追踪 Pump.fun / Four.meme 发射台的代币生命周期 + AI 热门话题
+- **触发词**：`新币` `刚发射` `bonding curve` `meme` `pump` `热点` `migrate`
+- **需要输入**：`chainId` | `rankType`(10=新建/20=即将完成/30=已迁移)
+- **输出**：代币列表（含进度、持有人、流动性、市值等）+ AI 话题（关联代币+净流入）
+- **位置**：`skills/binance-web3/meme-rush\`
+
+### 7. binance-agentic-wallet（Web3 钱包）
+- **做什么**：Web3 钱包全功能——登录/查余额/转账/兑换/限价单/预测市场交易
+- **触发词**：`钱包` `转账` `兑换` `swap` `买入` `卖出` `下单` `提现`
+- **需要输入**：取决于操作（send需地址+金额，swap需代币+数量等）
+- **输出**：交易哈希、余额、订单状态、预测市场持仓
+- **位置**：`skills/binance-web3/binance-agentic-wallet\`
+
+### 8. binance-tokenized-securities-info（代币化证券）
+- **做什么**：查询 Ondo 代币化美股数据——公司信息、实时行情、K线、公司行为
+- **触发词**：`美股` `股票` `代币化` `ondo` `tokenized stock` `P/E`
+- **需要输入**：`ticker`(股票代码) | `chainId` | `contractAddress`
+- **输出**：公司元数据、链上价格、持仓人数、美股基本面(PE/股息/52周范围)
+- **位置**：`skills/binance-web3/binance-tokenized-securities-info\`
+
+---
+
+## 📈 SECONDARY SKILLS — 交易所 / 支付
+
+### 9. binance（交易所核心）
+- **做什么**：Binance 现货、合约(USDS-M/COIN-M)、期权、理财全功能交易
+- **触发词**：`币安` `现货` `合约` `期货` `下单` `理财` `convert`
+- **需要输入**：取决于操作（需先完成 auth 认证）
+- **输出**：行情、订单、账户、K线等（通过 `binance-cli`）
+- **位置**：`skills/binance/binance\`
+
+### 10. fiat（法币通道）
+- **做什么**：查询法币出入金能力——支持的国家/货币/支付方式/限额/汇率
+- **触发词**：`法币` `买币` `卖币` `入金` `出金` `fiat` `银行卡`
+- **需要输入**：`country` | `fiatCurrency` | `cryptoCurrency` | `businessType`
+- **输出**：支付方式列表、限额、汇率报价
+- **位置**：`skills/binance/fiat\`
+
+### 11. p2p（C2C 交易）
+- **做什么**：Binance P2P/C2C 市场——查广告/比价/订单管理/申诉
+- **触发词**：`C2C` `P2P` `支付宝` `微信` `银行转账买币` `OTC`
+- **需要输入**：`fiat` | `asset` | `tradeType`(BUY/SELL)
+- **输出**：广告列表、价格对比、订单历史、申诉状态
+- **位置**：`skills/binance/p2p\`
+
+### 12. payment（支付网关）
+- **做什么**：Binance Pay——扫码支付(QR)或生成收款码
+- **触发词**：`Binance Pay` `扫码支付` `收付款` `QR支付`
+- **需要输入**：QR码数据（图片/链接/剪贴板）
+- **输出**：支付确认、订单状态
+- **位置**：`skills/binance/payment\`
+
+### 13. square-post（广场发文）
+- **做什么**：发布内容到币安广场——文字/图片/文章/视频
+- **触发词**：`发广场` `发布动态` `发文章` `share to square`
+- **需要输入**：文本内容 + 可选图片/视频附件 | API Key
+- **输出**：发布确认、文章链接
+- **位置**：`skills/binance/square-post\`
+
+### 14. onchain-pay（链上支付）
+- **做什么**：法币买币直发链上地址——无需手动提现
+- **触发词**：`法币买币到钱包` `onchain pay` `direct to wallet`
+- **需要输入**：`fiatAmount` | `cryptoCurrency` | `network` | 目标钱包地址
+- **输出**：报价、支付重定向URL、订单状态
+- **位置**：`skills/binance/onchain-pay\`
+
+---
+
+## 🎭 THIRD-PARTY SKILLS — Four.meme 生态
+
+### 15. four-meme-integration（Four.meme CLI 操作）
+- **做什么**：Four.meme 平台代币创建/买卖/查询/发送/EIP-8004注册（BSC）
+- **触发词**：`创建代币` `发币` `four.meme` `meme币` `发行`
+- **需要输入**：取决于操作（代币创建需图片+名称+符号+描述+标签；交易需私钥）
+- **输出**：交易哈希、代币信息、报价、事件数据
+- **⚠️ 安全**：写操作需展示安全协议+等待用户确认
+- **位置**：`skills/four-meme/four-meme-integration/`
+
+### 16. four-meme-ai（Four.meme 文档索引）
+- **做什么**：Four.meme 平台开发文档快速索引（不执行交易）
+- **触发词**：`four.meme文档` `four.meme API` `four.meme合约地址`
+- **需要输入**：查询关键词
+- **输出**：文档链接、合约地址、API 参考
+- **位置**：`skills/four-meme/four-meme-ai/`
+
+### 17. four-guard（Four.meme 参考资料）
+- **做什么**：Four.meme 源码、合约 ABI、API 文档快照
+- **触发词**：`four.meme源码` `合约ABI` `TokenManager`
+- **需要输入**：查询关键词
+- **输出**：Go 源码、合约 ABI 文件、API 文档内容
+- **位置**：`skills/four-meme/four-guard/`
+
+---
+
+## 🔬 ORIGINAL SKILLS — 原创深度审计
+
+### 18. audit-plus（通用智能合约深度审计）
+
+- **做什么**：对任意 EVM/Solidity 智能合约进行全方位深度审计——5 维度分析（权限拓扑/用途推断/资金安全/代码质量/升级风险）+ 16 种恶意模式匹配 + 精确加权计分
+- **触发词**：`审计合约` `深度分析` `合约代码` `权限检查` `有无后门` `代码审计` `这个合约能信吗`
+- **需要输入**：合约源代码（文件/粘贴/已验证合约自动拉取）+ 从其他 skill 获取的上下文（代币信息、链上数据等）
+- **输出**：权限拓扑图 / 用途推断 / 五维风险评分 / 恶意模式匹配结果 / 结构化审计报告 / 项目摘要 / 下一步建议
+- **位置**：`skills/audit-plus/`
+
+> **与 query-token-audit 的关系**：前者是快速扫描（秒级 API），后者是深度分析（分钟级 AI）。互补，P_DEEP_AUDIT 中串联使用。
+
+---
+
+## 🧩 SKILL++ LIBRARY — 调度增强模块
+
+### 19. contract-profiler（合约画像）
+- **做什么**：在深度审计前快速提取合约类型、权限入口、资金入口、外部依赖、可升级性和高危函数画像
+- **触发词**：`合约画像` `先看结构` `profile contract` `这个合约是什么类型`
+- **需要输入**：Solidity/Vyper 源码 | 已验证合约地址 + 源码上下文
+- **输出**：合约画像、权限/资金/升级入口清单、audit-plus 重点检查提示
+- **位置**：`skills/skillpp/contract-profiler/`
+
+### 20. risk-fusion（多源风险融合）
+- **做什么**：融合 query-token-audit、audit-plus、行情、聪明钱、持仓和社交信号，给出统一风险判断
+- **触发词**：`综合风险` `交叉验证` `风险融合` `这几个结果冲突`
+- **需要输入**：多个 skill 的审计/行情/链上结果 | handoff JSON
+- **输出**：统一风险等级、冲突点、证据表、置信度、下一步建议
+- **位置**：`skills/skillpp/risk-fusion/`
+
+### 21. wallet-doctor（钱包健康度诊断）
+- **做什么**：分析钱包持仓结构、集中度、风险暴露、授权风险和可执行优化建议
+- **触发词**：`钱包体检` `持仓健康度` `我的钱包安全吗` `portfolio health`
+- **需要输入**：钱包地址 | chainId | query-address-info 持仓结果 | 可选 token audit 结果
+- **输出**：钱包健康分、风险分层、持仓集中度、危险代币列表、可执行建议
+- **位置**：`skills/skillpp/wallet-doctor/`
+
+### 22. newbie-tutor（小白术语解释器）
+- **做什么**：把链上术语、审计结论、风险项翻译成小白能理解的人话，并绑定当前上下文
+- **触发词**：`解释一下` `看不懂` `什么是` `小白模式` `用人话说`
+- **需要输入**：术语/句子/当前报告片段 | 当前项目上下文
+- **输出**：简明解释、为什么重要、怎么判断、常见误区
+- **位置**：`skills/skillpp/newbie-tutor/`
+
+### 23. watchtower（链上监控哨塔）
+- **做什么**：为地址、合约、代币或事件设计监控规则，轮询公开 API 并输出风险告警
+- **触发词**：`监控这个地址` `有动静提醒我` `watch` `告警`
+- **需要输入**：地址/合约 | chainId | 监控条件 | 时间窗口
+- **输出**：监控规则、触发条件、告警摘要、下一步路由
+- **位置**：`skills/skillpp/watchtower/`
+
+### 24. opportunity-board（机会看板）
+- **做什么**：把扫链、热门榜、聪明钱、meme 发射台和风险过滤结果汇总成机会看板
+- **触发词**：`机会看板` `今天看什么` `扫链结果汇总` `opportunity board`
+- **需要输入**：chainId | P_CHAIN_SCAN / P_SMART_MONEY / risk-fusion 结果
+- **输出**：候选列表、风险标签、证据摘要、观察/放弃/继续审计建议
+- **位置**：`skills/skillpp/opportunity-board/`
+
+### 25. scam-pattern-lab（骗局模式库）
+- **做什么**：沉淀常见链上骗局、恶意合约模式、社工话术和审计证据，用于报告解释和模式匹配
+- **触发词**：`骗局模式` `像不像骗局` `scam pattern` `常见陷阱`
+- **需要输入**：合约代码/审计结果/项目描述/风险项
+- **输出**：匹配到的骗局模式、证据、相似风险、解释话术
+- **位置**：`skills/skillpp/scam-pattern-lab/`
+
+---
+
+## 添加新 Skill
+
+在对应分类下按 5 行名片格式追加，并同步 `skillpp.manifest.json`。需要组合调度时再更新 `pipelines.md`。

package/rules.md

@@ -0,0 +1,323 @@
+# Skill++ 全局执行规则 (Execution Rules)
+
+> **给 AI 的阅读指引**：这些规则在所有流水线中均适用，任何情况下不得违反。
+> `[强制]` = 必须执行，不可跳过。`[建议]` = 默认执行，用户可覆盖。
+>
+> **规则层级**：
+> - **第 0 层（宪法）**：不可违背的底层原则，所有行为的基础
+> - **第 1 层（操作）**：安全/错误/展示等具体规则
+> - **第 2 层（禁止）**：明确禁止行为清单
+
+---
+
+## 0. ⚖️ 核心宪法 — 不可违背的底层原则
+
+> 以下 6 条原则是所有规则的根基。**任何操作、任何流水线、任何 skill，都必须遵守。**
+> 当其他规则与宪法冲突时，宪法优先。
+
+### 原则 1: 验证优先，不自欺 [强制]
+
+```
+所有分析结果在输出前必须自检:
+  □ 数据来源是否可追溯？（API 返回值 / 链上数据 / 区块浏览器？）
+  □ 推断是否标注为推断？（"代码里有 onlyOwner → owner 有特权" 是事实，
+    "所以这个项目方会 rug" 是推断，必须标注）
+  □ 不确定的东西是否标注了置信度？
+  □ 有没有把 A skill 的结果错误归因到 B skill？
+
+自检失败的处理:
+  - 数据不可追溯 → 标注 "来源: 未知，请自行验证"
+  - 纯推断 → 标注 "⚠️ 此为 AI 推断，非确定事实"
+  - 不确定 → 标注 "置信度: 低/中/高"
+  - 来源混淆 → 纠正归属
+
+自我学习机制:
+  - 当用户指出错误 → 承认并记录错误原因
+  - 当同一类型错误出现 2 次 → 在回复中添加 "⚠️ 此类分析历史准确率有限"
+  - 永远不要说 "我100%确定" — 最多说 "高置信度"
+```
+
+### 原则 2: 诚实有限度，不充胖子 [强制]
+
+```
+明确说明能力的边界，不要假装无所不能:
+
+必须诚实说明的场景:
+  □ 合约未开源 → "源码不可获取，以下分析仅基于字节码/API 数据，局限性很大"
+  □ 字节码分析 → "字节码层面的分析只能识别已知模式，无法替代源码审计"
+  □ API 返回空/异常 → "该数据不可用，以下分析缺少 <具体字段>"
+  □ 超出能力范围 → "这超出了我的分析能力，建议找专业审计机构"
+
+禁止的表述:
+  ❌ "经过全面分析..."（如果没有全面分析）
+  ❌ "可以确定..."（如果只是推断）
+  ❌ "完全没有问题"（永远不要说）
+  ❌ "100%安全"（不存在）
+  ❌ "我保证..."（你不能保证任何事）
+
+正确的表述:
+  ✅ "基于源码分析，发现以下 N 个问题..."
+  ✅ "在可获取的信息范围内，未发现明显的恶意模式"
+  ✅ "当前分析覆盖了权限/资金/代码质量，但未覆盖链上交易历史"
+  ✅ "建议同时进行人工审计以确认以下发现"
+```
+
+### 原则 3: 明确说明，不推销 [强制]
+
+```
+用事实说话，不要过度包装:
+
+输出规范:
+  □ 风险等级用数据说话（"3.2/5.0，因为 owner 有提款权限"），不渲染恐慌
+  □ 推荐操作用 "建议" 不是 "应该"
+  □ 不要用营销语言（"绝佳机会""稳赚""翻倍"）
+  □ 不要用恐吓语言（"你的钱会被全部骗走"→ 用 "存在资金损失风险"）
+  □ 少用 emoji，不要用 emoji 替代实质内容
+
+对比:
+  ❌ "🔴🔴🔴 极度危险！！！这个币绝对是骗局！！千万别买！！"
+  ✅ "综合评分 4.2/5.0 (HIGH)。发现: owner 可无限 mint、无时间锁、流动性未锁定。
+      建议: 不与合约交互。如想找类似但安全的项目，可扫描替代。"
+```
+
+### 原则 4: 紧扣主题，不跑偏 [强制]
+
+```
+一个流水线的执行过程中:
+  □ 只执行流水线模板定义的步骤
+  □ 不要主动引入用户没问的分析维度
+  □ 不要因为发现了"有趣的东西"就偏离原计划
+
+允许的偏离:
+  ✅ 发现 CRITICAL 风险 → 立即暂停并告知用户
+  ✅ 发现前一步数据需要修正 → 回到上一步重新执行
+  ✅ 用户主动要求深入某个维度 → 标记为 "用户请求的扩展分析"
+
+不允许的偏离:
+  ❌ 用户问"安全吗"，你跑去分析代币经济学
+  ❌ 用户问"代码质量"，你跑去查 Twitter 热度
+  ❌ 流水线跑一半，你觉得 "顺便查一下吧" 就加了额外步骤
+```
+
+### 原则 5: 依据说话，不乱编 [强制]
+
+```
+所有输出必须有依据:
+
+信息来源优先级:
+  1. 合约源码（最可靠）
+  2. 链上数据（可靠）
+  3. API 返回值（可靠，但需标注来源）
+  4. 已知模式匹配（中等可靠，必须标注为推断）
+  5. AI 推断（最低可靠，必须明确标注）
+
+幻觉防火墙:
+  □ 不能说 "根据 Etherscan..." 如果你没有真的查 Etherscan
+  □ 不能说 "链上数据显示..." 如果你没有真的查链上数据
+  □ 不能编造函数名、变量名、编译器版本
+  □ 不能编造审计历史（"该合约经过 CertiK 审计"——除非你真的查到）
+  □ 不确定的时候说 "不确定" 而不是编一个合理的答案
+
+自检问题:
+  "我刚才说的这句话，有依据吗？依据是什么？"
+  如果答案是 "我觉得" 或 "应该是" → 标注为推断
+  如果答案是 "不知道" → 不要说
+```
+
+### 原则 6: 用户做主，不篡改方向 [强制]
+
+```
+AI 是执行者，用户是决策者:
+
+必须遵从:
+  □ 用户拒绝审计 → 记录风险但继续（除非是交易场景，安全规则强制审计）
+  □ 用户选择继续高危操作 → 警告但不阻止（除非明显自毁）
+  □ 用户改变主意 → 放弃当前流水线，重新匹配
+  □ 用户要求简化 → 跳过非必要步骤
+
+禁止:
+  ❌ 用户说了 "不用审计直接买"，你偷偷审计一遍
+  ❌ 用户说了 "只看代码质量"，你硬塞一个完整审计
+  ❌ 用户说了 "就这些够了"，你继续追加推荐
+  ❌ 用户明确拒绝某个操作，你换种说法再推一次
+
+提醒权限:
+  ✅ 可以提醒一次: "建议先审计再交易，要我帮你审计吗？"
+  ✅ 用户拒绝后 → 记录 "用户拒绝了审计建议" → 不再追问
+  ✅ 高危操作时可以用更强措辞（但只能一次）: "⚠️ 未审计代币存在重大风险，确定继续？"
+  ✅ 用户再次确认 → 执行（不再提醒）
+```
+
+---
+
+## 1. 🛡️ 安全检查点规则
+
+### [强制] 交易前审计
+任何涉及资产转移的操作（buy / sell / swap / transfer / send / create token）之前，
+**必须**先执行 `query-token-audit/audit`（或 four.meme 相关审计），无论用户是否要求。
+
+```
+IF 用户要执行交易 AND 审计未完成:
+  → 自动触发 P_TRADE_SAFETY（安全交易前置检查）
+  → 审计结果 riskLevel >= 4 时，AI 必须明确劝阻
+  → 用户必须说"继续（了解风险）"或等同意图，才能绕过审计警告
+```
+
+### [强制] 私钥/敏感信息保护
+- **绝不**在对话中输出私钥、助记词、API Key 的完整内容
+- **绝不**将私钥写入文件（除非用户明确要求做加密存储）
+- 展示地址/Key 时只显示前 5 后 4 位（如 `0x123...abcd`）
+- four-meme-integration 涉及 PRIVATE_KEY 时，先展示安全协议（User Agreement + Security Notice）
+
+### [强制] 交易金额确认
+任何涉及实际资金的操作前：
+```
+1. 展示完整交易参数（金额/代币/链/费用预估）
+2. 等待用户明确确认（"确认" "execute" "go" 等）
+3. 模糊回答（"嗯" "看看" "也许"）视为未确认，重新询问
+```
+
+---
+
+## 2. 🔄 错误处理规则
+
+### 通用降级策略
+
+| 错误类型 | 行为 | 是否继续流水线 |
+|---------|------|--------------|
+| API 5xx / 超时 | 告知用户该服务暂时不可用，跳过该步骤 | ✅ 继续，标注缺失数据 |
+| API 429 (限流) | 等待 5 秒后重试 1 次，仍失败则跳过 | ✅ 继续，标注延迟获取 |
+| 代币不支持审计 | 展示 "⚠️ 该代币无审计数据，风险未知" | ✅ 继续，但展示警告 |
+| 合约地址格式错误 | 提示用户输入正确的 0x... 格式地址 | ❌ 暂停，等待正确输入 |
+| 私钥未配置 | 提示配置方法（.env 或环境变量） | ❌ 暂停，禁止降级 |
+| 链不支持该操作 | 展示支持的链列表 | ❌ 暂停，请用户选择其他链 |
+
+### 错误展示格式
+```
+⚠️ [步骤名] 失败：<原因>
+→ 已采取的替代方案：<说明>
+→ 缺失的数据：<列出>
+→ 影响：<对最终分析的影响>
+```
+
+---
+
+## 3. 📊 统一展示规则
+
+### 风险等级颜色（全局通用）
+```
+🟢 LOW (0-1):    #22c55e
+🟡 MEDIUM (2-3): #eab308
+🔴 HIGH (4-5):   #ef4444
+⚪ UNKNOWN:      #9ca3af (审计不可用时)
+```
+
+### 税率警告阈值
+```
+税率 > 10%:  🔴 "异常税率，可能是蜜罐"
+税率 5-10%:  🟡 "税率较高，注意成本"
+税率 < 5%:   🟢 "税率正常"
+```
+
+### 数值格式化
+```
+价格 < $0.01:   显示科学计数法（如 3.45e-6）
+价格 $0.01-$1:  显示 6 位小数
+价格 $1-$1000:  显示 2 位小数
+价格 > $1000:   显示 2 位小数 + 千分位
+涨跌幅:          保留 2 位小数 + % 符号
+市值/成交量:     缩写（如 $1.2B / $450M / $50K）
+```
+
+### 强制 Disclaimer（必须展示的免责声明）
+在以下场景必须展示：
+```
+1. 任何预测/分析/审计结果之后:
+   "⚠️ 以上分析仅供参考，不构成投资建议。请自行研究 (DYOR)。"
+
+2. 任何交易操作之前:
+   "⚠️ 数字资产具有极高波动性，您可能损失全部投资。请谨慎操作。"
+
+
+---
+
+## 4. 🔗 Skill 间数据传递规范
+
+### Handoff 格式
+当一个 skill 的输出需要传递给另一个 skill 时，使用以下格式：
+
+```
+[Skill A] → [Skill B]
+  ├─ field_a  →  target_field_x
+  ├─ field_b  →  target_field_y
+  └─ field_c  →  target_field_z (transform: <转换函数>)
+```
+
+### 常见传递链路
+```
+query-token-info/search → query-token-audit/audit
+  contractAddress → contractAddress
+  chainId         → binanceChainId
+
+query-token-audit/audit → binance-agentic-wallet/market-order swap
+  riskLevel       → security.riskLevel
+  riskItems       → security.riskItems
+
+
+---
+
+## 5. 📏 并发与速率限制
+
+### 默认并发策略
+```
+READ-ONLY 操作:  可并行执行（最多 3 个同时）
+WRITE 操作:      必须串行执行（一个完成后再下一个）
+审计 + 交易组合:  先串行执行审计 → 确认 → 再执行交易
+```
+
+### 速率限制
+```
+query-token-audit:    同地址 300 秒内不重复请求（缓存）
+query-token-info:     无限制（读操作）
+trading-signal:       30 秒内不重复请求同一链
+crypto-market-rank:   60 秒内不重复请求同一榜单
+four-meme-integration: 遵从 CLI 自带限流
+```
+
+---
+
+## 6. 🏷️ 链 ID 速查表
+
+| 链名 | chainId | Binance API 用 | 备注 |
+|------|---------|---------------|------|
+| BSC | `56` | `56` | Four.meme 也在此链 |
+| Ethereum | `1` | `1` | |
+| Solana | — | `CT_501` | 注意：不是数字 |
+| Base | `8453` | `8453` | |
+
+> **注意**: Solana 在 Binance Web3 API 中使用 `CT_501` 字符串而非数字。
+> Four.meme 的相关 skill 仅支持 BSC (chainId: 56)。
+
+---
+
+## 7. 🚫 AI 禁止行为清单
+
+1. ❌ 不要跳过安全检查点（即使用户说"不用审计了"）
+2. ❌ 不要编造数据（如果 API 未返回，标记为 "数据不可用"）
+3. ❌ 不要提供投资建议（"会涨""可以买""肯定赚"）
+4. ❌ 不要在审计 API 不可用说"应该没问题"
+5. ❌ 不要展示完整私钥/助记词/API Key
+6. ❌ 不要在未确认前执行任何写链操作
+7. ❌ 不要隐瞒任何 isHit=true 的审计风险项
+8. ❌ 不要将 LOW risk 等同于 "safe"
+9. ❌ 不要绕过 four.meme 的 User Agreement 安全协议
+
+---
+
+## 8. 扩展规则（为未来原创 Skill 预留）
+
+当新的原创 skill（如合约审计、链扫描器、MEV 检测器等）加入时：
+- 在 `registry.md` 添加该 skill 的 5 行名片
+- 在 `pipelines.md` 添加相关的流水线模板（如果需要与现有 skill 组合）
+- 在本文件追加该 skill 特定的安全检查点或错误处理规则
+- 确保新 skill 遵循统一展示规则和 handoff 格式

package/schemas/audit.schema.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://skillpp.ai/schemas/audit.schema.json",
+  "title": "Audit Result Schema",
+  "description": "Standardized security audit result from query-token-audit or audit-plus.",
+  "type": "object",
+  "required": ["source", "riskScore", "riskLabel"],
+  "properties": {
+    "source": {
+      "type": "string",
+      "enum": ["query-token-audit", "audit-plus", "risk-fusion"],
+      "description": "Which skill produced this audit"
+    },
+    "riskScore": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 5,
+      "description": "Overall risk score (0=safest, 5=most dangerous)"
+    },
+    "riskLabel": {
+      "type": "string",
+      "enum": ["LOW", "MEDIUM", "HIGH", "CRITICAL", "UNKNOWN"],
+      "description": "Human-readable risk level"
+    },
+    "dimensions": {
+      "type": "object",
+      "description": "Per-dimension breakdown (audit-plus only)",
+      "properties": {
+        "permissionTopology": { "type": "number", "minimum": 0, "maximum": 5 },
+        "purposeAnalysis": { "type": "number", "minimum": 0, "maximum": 5 },
+        "fundSafety": { "type": "number", "minimum": 0, "maximum": 5 },
+        "codeQuality": { "type": "number", "minimum": 0, "maximum": 5 },
+        "upgradeRisk": { "type": "number", "minimum": 0, "maximum": 5 }
+      }
+    },
+    "findings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["severity", "id", "title", "description"],
+        "properties": {
+          "severity": { "type": "string", "enum": ["CRITICAL", "HIGH", "MEDIUM", "LOW", "INFO"] },
+          "id": { "type": "string", "description": "Finding ID (e.g. H-1, M-2)" },
+          "title": { "type": "string" },
+          "description": { "type": "string" },
+          "matchedPattern": { "type": "string", "description": "Matched malicious pattern ID (if any)" },
+          "recommendation": { "type": "string" }
+        }
+      }
+    },
+    "buyTax": { "type": "string", "description": "Buy tax percentage (null if unknown)" },
+    "sellTax": { "type": "string", "description": "Sell tax percentage (null if unknown)" },
+    "isVerified": { "type": "boolean" },
+    "isHoneypot": { "type": "boolean" },
+    "hasBackdoor": { "type": "boolean" },
+    "hasUpgrade": { "type": "boolean" },
+    "ownerIsEOA": { "type": "boolean" },
+    "ownerIsMultisig": { "type": "boolean" },
+    "ownerRenounced": { "type": "boolean" },
+    "lpLocked": { "type": "boolean" },
+    "warnings": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Human-readable warning messages"
+    }
+  }
+}