# mySKILLs **Repository Path**: openminds/myskills ## Basic Information - **Project Name**: mySKILLs - **Description**: TRAE IDE 中自建的 Skill 集合。Skill 是模块化的、自包含的 Agent 能力扩展包，通过 SKILL.md 描述触发条件和工作流程。 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 1 - **Created**: 2026-06-17 - **Last Updated**: 2026-10-01 ## Categories & Tags **Categories**: Uncategorized **Tags**: skill, Trae ## README # mySKILLs TRAE IDE 中自建的 Skill 集合。Skill 是模块化、自包含的 Agent 能力扩展包，通过目录下的 `SKILL.md` 描述触发条件与工作流，智能体按场景自动加载。 ## 技能总览 | 技能 | 分类 | 简介 | |------|------|------| | [fastmcp-server](#fastmcp-server) | MCP 开发 | FastMCP v4（Python）MCP Server 生产蓝图，含 v3→v4 迁移指南 | | [mcp-typescript-server](#mcp-typescript-server) | MCP 开发 | MCP TypeScript SDK v2 开发与 v1→v2 迁移指南 | | [dsm5-differential-diagnosis](#dsm5-differential-diagnosis) | 心理健康 | DSM-5 六步鉴别诊断工作流 + CLIPS 决策树专家系统（29 种主诉） | | [act-mbsr-practice-generator](#act-mbsr-practice-generator) | 心理健康 | 生成 ACT（接纳承诺疗法）与 MBSR（正念减压）结构化练习引导 | | [dsh-plugin-ui](#dsh-plugin-ui) | 插件开发 | DSH 双半区（Host/Client）UI 插件构建、槽位注册与排错指南 | | [web-search](#web-search) | 实用工具 | 多引擎网络搜索（百度 / Bing / DuckDuckGo），无需 API 密钥 | | [weather](#weather) | 实用工具 | 天气查询（wttr.in / Open-Meteo），无需 API 密钥 | --- ## MCP 开发 ### fastmcp-server **FastMCP v4 生产蓝图** — 用 Python 的 FastMCP（4.0.x，基于 MCP Python SDK v2）构建、审查、部署 MCP Server 的速查手册。 #### 覆盖内容 - 四大原语（Tool / Resource / Prompt / Completion）的设计规则与选型决策 - Context 注入、结构化日志、进度上报；跨请求会话状态（`UserSession` / `SessionId`） - 现代协议（2026-07-28）下的 guard pattern 多轮引出（替代已移除的 `ctx.elicit()`） - Lifespan 共享资源、后台任务（`TasksExtension`）、中间件、Server 组合（mount/proxy） - 传输层（stdio / Streamable HTTP）、多副本部署、缓存提示、Docker 规范 - 安全基线与 SEP-990 企业身份（RFC 7523 `jwt-bearer`） - **FastMCP 3 → 4 迁移专题**：API 移除清单、导入路径变更、httpx2 迁移、9 条快速诊断清单 #### 触发场景 创建、审查或部署任何 Python MCP Server；将 FastMCP 3.x 项目升级到 4.x。 #### 依赖 ```bash pip install "fastmcp>=4" # 后台任务另需：pip install "fastmcp[tasks]>=4" ``` --- ### mcp-typescript-server **MCP TypeScript SDK v2 开发与迁移指南** — 覆盖 v2 分包（`@modelcontextprotocol/server`、`/client`、`/core`）下的应用开发，以及从 v1 单包 `@modelcontextprotocol/sdk` 的迁移。 #### 覆盖内容 - v2 不可违背的事实基线（Node 20+、Zod v4、Standard Schema、协议时代 opt-in） - Server/Client 完整开发流程：传输选型（Node vs Web 标准）、`registerTool`、`ctx` 处理器上下文、错误体系（`SdkError` / `ProtocolError` / `SdkHttpError`） - v1→v2 标准迁移流程：codemod（`npx @modelcontextprotocol/codemod`）、人工清理清单、运行时静默失效模式识别、分阶段共存迁移 - 离线参考文档：项目分析、v2 用法速查、迁移验收清单（见技能 `references/`） #### 触发场景 使用 `@modelcontextprotocol/*` 包编写 MCP 应用；升级 `@modelcontextprotocol/sdk` v1 代码。 --- ## 心理健康 ### dsm5-differential-diagnosis **DSM-5 鉴别诊断工作流技能** — 基于 DSM-5 六步鉴别诊断流程系统性排除可能病因，辅助精神障碍鉴别诊断。集成 CLIPS 决策树专家系统（基于《DSM-5 鉴别诊断手册》开发），支持 29 种主诉症状的交互式鉴别诊断。 #### 六步工作流 ``` 排除诈病/做作性障碍 → 排除物质病因 → 排除躯体疾病 → 确定原发性障碍（CLIPS 专家系统）→ 区分适应障碍 → 确立与正常边界 ``` #### 触发场景 用户请求对精神症状进行鉴别诊断、排查精神障碍、评估症状间诊断可能性时自动触发。 #### 目录结构 ``` skills/dsm5-differential-diagnosis/ ├── SKILL.md # 技能定义 + 六步工作流 ├── scripts/ │ ├── call_expert_system.py # CLIPS 调用主入口 │ └── dsm5_expert_system.clp # 29 种主诉的决策树规则 └── references/ ├── workflow.md # 六步鉴别诊断详细指南 ├── symptom-tables.md # 主诉-诊断映射表 └── clips-integration.md # CLIPS 集成接口规范 ``` #### 依赖 - Python 3.8+ - `clipspy >= 1.0.0` — CLIPS 专家系统 Python 绑定 ```bash pip install clipspy ``` #### 快速测试 ```bash # 列出所有主诉症状编号 python skills/dsm5-differential-diagnosis/scripts/call_expert_system.py --list # 交互模式（逐题回答 yes/no） python skills/dsm5-differential-diagnosis/scripts/call_expert_system.py --complaint 5 # 预览问题（智能体预分析用） python skills/dsm5-differential-diagnosis/scripts/call_expert_system.py --preview 5 --json # 自动化模式（预填答案 + JSON 输出） python skills/dsm5-differential-diagnosis/scripts/call_expert_system.py --complaint 5 --answers answers.json --json-out ``` --- ### act-mbsr-practice-generator **ACT 与 MBSR 练习生成器** — 引导智能体生成接纳承诺疗法（ACT）和正念减压（MBSR）的结构化练习内容，供用户日常自行练习。 #### 覆盖内容 - **ACT 六大核心过程**：接纳、认知解离、活在当下、观察自我、价值、承诺行动；含常用练习库与输出模板 - **MBSR 八大核心练习**：身体扫描、正念静坐、正念瑜伽、行走冥想、正念饮食、爱的冥想、三分钟呼吸空间、葡萄干练习；含九堂课作业分布参考 - 统一输出规范：时长、目标、分步引导、姿势/要点提示，第二人称温和语气 - 安全边界：练习不替代专业治疗，遇自伤/自杀意图或严重症状时提示转介 #### 触发场景 用户请求 ACT / MBSR / 正念 / 行为疗法练习，或需要缓解焦虑、压力、情绪困扰的练习引导。 --- ## 插件开发 ### dsh-plugin-ui **DSH 双半区 UI 插件开发指南** — 面向 DeepSeek Harness（DSH）Host（Node.js）+ Client（浏览器）双半区插件，覆盖构建配置、槽位系统、依赖边界与排错清单。 #### 覆盖内容 - 双半区架构与 `package.json` / `cordis.patch.yml` 契约（三 ID 一致性原则） - tsdown 双配置模板：Host 面 ESM（Node）、Client 面 CJS 工厂（浏览器，`__ModuleLoader__` banner/footer） - Client 槽位注册（`shell.overlay`、`conversation.view`、`sidebar.tabs`） - Host/Client 共享代码的依赖边界（禁止向 Client 引入 `node:*`）与检查命令 - Host 工具注册三件套、peerDependencies 规范、`ctx.effect()` 资源清理 - 8 个高频陷阱（ESM/CJS 格式、Node 内置模块泄漏、chunk 丢失、inject 缺失等）与构建后验证清单 #### 触发场景 开发或调试带 UI 的 DSH 插件，遇到插件加载失败、bundle 格式、槽位不渲染等问题。 --- ## 实用工具 ### web-search **多引擎网络搜索技能** — 通过浏览器自动化与网页抓取获取实时信息，无需任何 API 密钥。 - 支持百度（baidusearch / Playwright）、DuckDuckGo、Bing，失败时自动降级切换 - 三种操作：`search`（普通搜索）、`deep_search`（搜索 + 正文提取）、`crawl`（单页抓取） - 返回结构化结果（标题 / URL / 摘要），支持异步调用 - 依赖：Python 3、`uv`、`requests`、`baidusearch`、`crawl4ai`、`playwright`（首次运行自动下载 Chromium，约 100MB） #### 触发场景 需要联网检索实时信息、深度调研某个主题、抓取指定网页内容。 --- ### weather **天气查询技能** — 两个免费服务，均无需 API 密钥。 - **wttr.in（主力）**：单行速查、紧凑格式（温度/湿度/风力）、三日预报、PNG 图片，支持城市名与机场代码 - **Open-Meteo（备用）**：JSON 接口，适合程序化调用，按经纬度查询当前天气 ```bash curl -s "wttr.in/Beijing?format=3" # 速查 curl -s "wttr.in/Beijing?T" # 完整预报 curl -s "wttr.in/Beijing?format=%l:+%c+%t+%h+%w" # 紧凑格式 ``` #### 触发场景 查询当前天气或预报；依赖仅需系统自带的 `curl`。 --- ## 安装技能 将技能目录放置在工作区 `skills/` 目录下，TRAE 会自动扫描并注册： ``` /skills//SKILL.md ``` 当前工作区 `e:\myWorkspace\myskills` 中技能已就位于 `skills/` 目录，可直接使用。 ## 打包分发 使用内置的 skill-creator 打包工具，可将技能目录打包为 ZIP 格式的 `.skill` 文件直接分享或导入其他 TRAE 工作区： ```bash # 打包到当前目录 python .trae/skills/skill-creator/scripts/package_skill.py skills/ # 打包到指定输出目录 python .trae/skills/skill-creator/scripts/package_skill.py skills/ ./dist ``` 仓库根目录的 `dsm5-differential-diagnosis.skill` 即为打包产物示例。 ## 许可证 [MIT](LICENSE) © 2026 OpenMINDS