项目总结Skills 与 HAP Skills Collection1. 项目概述本项目是一个技能集合Skills系统包含两部分核心内容基础 Skills 框架由 Anthropic 开发的 Claude 技能系统提供技能的标准规范和示例HAP Skills Collection专为明道云 HAP 平台开发的 AI 技能包集合让 AI 编程工具能够自动理解并使用明道云的 API、开发规范和最佳实践2. 业务模型2.1 核心业务场景AI 工具技能增强为 AI 编程工具如 Claude Code、TRAE、Cursor 等提供专业技能提升其在特定领域的能力使 AI 工具能够理解并使用特定平台的 API 和开发规范明道云 HAP 平台开发简化 HAP 平台的开发流程降低学习成本提供标准化的开发流程和最佳实践支持从数据查询到视图插件开发的全流程跨平台技能部署实现技能在多个 AI 工具平台的统一部署和管理提供一次安装到处运行的便捷方案2.2 目标用户明道云 HAP 平台开发者需要快速开发 HAP 应用、视图插件和前端项目的开发人员AI 工具用户希望在 AI 工具中获得专业领域支持的用户企业开发团队需要标准化开发流程和最佳实践的团队3. 需求清单3.1 功能需求技能管理创建和管理标准化的技能目录结构支持技能的安装、更新和卸载提供技能的元数据和描述信息HAP 平台集成支持 HAP V3 API 的完整使用流程提供视图插件开发的完整流程支持前端项目搭建和 MCP 配置管理跨平台支持支持多种 AI 工具平台Claude Code、TRAE、Cursor 等提供统一的安装和部署方案支持软链接和自动同步机制开发流程支持提供标准化的开发流程和最佳实践支持从项目初始化到发布上线的全流程提供代码生成和配置自动化3.2 非功能需求易用性零学习成本AI 自动理解 API一键安装和配置清晰的文档和使用示例可维护性模块化的技能结构统一的更新机制详细的版本控制和更新日志扩展性支持新技能的添加和现有技能的扩展适应明道云平台的更新和变化支持新 AI 工具平台的集成兼容性兼容多种 AI 工具平台遵循各平台的技能规范支持不同操作系统Windows、macOS、Linux4. 系统设计4.1 架构设计┌─────────────────────────────────────────────────────────┐ │ 应用层 │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │Claude │ │TRAE │ │Cursor │ │其他 AI │ │ │ │Code │ │ │ │ │ │工具 │ │ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ ├─────────────────────────────────────────────────────────┤ │ 技能层 │ │ ┌───────────────────────────────────────────────────┐ │ │ │ Skills 目录 │ │ │ │ ┌────────────┐ ┌────────────┐ ┌────────────┐ │ │ │ │ │HAP V3 API │ │视图插件 │ │前端项目 │ │ │ │ │ │技能 │ │开发技能 │ │搭建技能 │ │ │ │ │ └────────────┘ └────────────┘ └────────────┘ │ │ │ │ ┌────────────┐ ┌────────────┐ │ │ │ │ │MCP 使用 │ │其他技能 │ │ │ │ │ │指南 │ │ │ │ │ │ │ └────────────┘ └────────────┘ │ │ │ └───────────────────────────────────────────────────┘ │ ├─────────────────────────────────────────────────────────┤ │ 平台层 │ │ ┌───────────────────────────────────────────────────┐ │ │ │ 明道云 HAP 平台 │ │ │ │ ┌────────────┐ ┌────────────┐ ┌────────────┐ │ │ │ │ │V3 API │ │视图插件 │ │MCP Server │ │ │ │ │ │ │ │系统 │ │ │ │ │ │ │ └────────────┘ └────────────┘ └────────────┘ │ │ │ └───────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────┘4.2 目录结构基础 Skills 框架结构skills-main/ ├── .claude-plugin/ # Claude 插件配置 ├── skills/ # 技能目录 │ ├── algorithmic-art/ # 算法艺术技能 │ ├── brand-guidelines/ # 品牌指南技能 │ ├── canvas-design/ # 画布设计技能 │ ├── doc-coauthoring/ # 文档协作技能 │ ├── docx/ # DOCX 文档技能 │ ├── frontend-design/ # 前端设计技能 │ ├── internal-comms/ # 内部通信技能 │ ├── mcp-builder/ # MCP 构建器技能 │ ├── pdf/ # PDF 文档技能 │ ├── pptx/ # PPTX 文档技能 │ ├── skill-creator/ # 技能创建器 │ ├── slack-gif-creator/ # Slack GIF 创建技能 │ ├── theme-factory/ # 主题工厂技能 │ ├── web-artifacts-builder/# Web 构件构建技能 │ ├── webapp-testing/ # Web 应用测试技能 │ └── xlsx/ # XLSX 文档技能 ├── spec/ # 技能规范 ├── template/ # 技能模板 ├── README.md # 项目说明 └── THIRD_PARTY_NOTICES.md # 第三方声明HAP Skills Collection 结构hap-skills-collection/ ├── README.md # 项目主文档 ├── README.en.md # 英文文档 ├── LICENSE # MIT 许可证 ├── install.sh # macOS/Linux 安装脚本 ├── install.ps1 # Windows 安装脚本 ├── uninstall.sh # 卸载脚本 ├── docs/ # 文档目录 │ ├── QUICK_START.md # 快速启动指南 │ └── INSTALLATION.md # 详细安装指南 ├── .claude/skills/ # 技能目录 │ ├── hap-v3-api/ # HAP V3 API 使用技能 │ ├── hap-view-plugin/ # 视图插件开发技能 │ ├── hap-frontend-project/ # 前端项目搭建技能 │ ├── hap-mcp-usage/ # MCP 使用指南 │ └── hap-skills-updater/ # Skills 更新工具 └── mcp-mingdao-proxy/ # MCP 代理工具4.3 核心组件技能文件SKILL.mdYAML 前置元数据名称、描述等Markdown 格式的技能说明和指令示例和最佳实践指南安装脚本install.shmacOS/Linux 一键安装脚本install.ps1Windows PowerShell 安装脚本支持全局/项目级安装支持自动软链接创建文档系统快速启动指南详细安装指南平台兼容性说明常见问题解答5. 功能清单5.1 基础 Skills 框架功能功能描述所在位置技能管理创建、安装和管理技能skills/文档处理支持 DOCX、PDF、PPTX、XLSX 文档操作skills/docx/, skills/pdf/, skills/pptx/, skills/xlsx/设计工具算法艺术、画布设计、主题工厂skills/algorithmic-art/, skills/canvas-design/, skills/theme-factory/开发工具前端设计、Web 应用测试、MCP 构建器skills/frontend-design/, skills/webapp-testing/, skills/mcp-builder/通信工具内部通信、文档协作skills/internal-comms/, skills/doc-coauthoring/5.2 HAP Skills Collection 功能功能描述所在位置HAP V3 API 使用完整的 API 调用工作流、Filter 筛选器、关联字段查询.claude/skills/hap-v3-api/视图插件开发7 步开发流程、4 种模板、双 API 集成.claude/skills/hap-view-plugin/前端项目搭建HAP 作为后端数据库、前端技术栈集成、鉴权方案.claude/skills/hap-frontend-project/MCP 使用指南MCP 服务器配置、自动化配置、密钥管理.claude/skills/hap-mcp-usage/跨平台支持支持 9 种 AI 工具平台、一键安装、自动同步install.sh, install.ps16. 代码规模6.1 基础 Skills 框架技能数量15 个专业技能文件数量数百个文件包括技能定义、脚本和资源代码行数估计数万行包含各种语言Python、JavaScript、Markdown 等主要文件类型SKILL.md技能定义文件脚本文件.py、.js、.sh工具脚本资源文件.ttf、.xsd字体和架构定义6.2 HAP Skills Collection技能数量4 个核心技能 1 个内部更新工具文件数量约 50 文件代码行数估计数千行主要为 Markdown 文档和安装脚本主要文件类型SKILL.md技能定义文件安装脚本install.sh、install.ps1、uninstall.sh文档文件README.md、QUICK_START.md、INSTALLATION.md7. 技术栈7.1 基础技术标记语言Markdown技能定义和文档脚本语言Bash、PowerShell安装和管理脚本编程语言Python、JavaScript工具脚本配置格式YAML技能元数据7.2 依赖项AI 工具平台Claude Code、TRAE、Cursor、GitHub Copilot、Google Antigravity、OpenCode、Windsurf、Gemini CLI、OpenAI Codex开发工具mdye-cli视图插件开发API明道云 HAP V3 API、MCP Server API8. 关键特性零学习成本AI 自动理解明道云 API无需手动查文档最佳实践内置基于实战经验的开发规范和技巧完整工作流从项目初始化到发布上线的全流程支持持续更新跟随明道云平台更新保持最新9 平台支持支持所有主流 AI 编程工具一键安装一次安装到处运行在 Claude 目录安装一次其他平台自动同步9. 应用场景数据查询和操作使用 HAP V3 API 技能查询和操作明道云数据自定义视图开发使用视图插件开发技能创建数据看板和自定义视图独立网站搭建使用前端项目搭建技能以 HAP 作为后端数据库MCP 配置管理使用 MCP 使用指南配置和管理 MCP Server10. 维护和升级建议10.1 维护策略定期更新跟随明道云 HAP 平台的更新及时更新技能内容版本控制使用 Git 进行版本管理记录更新日志测试验证在更新技能后在各平台进行测试验证文档维护保持文档的准确性和完整性10.2 升级建议技能扩展根据实际需求扩展现有技能或添加新技能平台支持持续支持新的 AI 工具平台性能优化优化技能的执行效率和响应速度安全性确保技能中的 API 调用和数据处理符合安全最佳实践10.3 常见问题和解决方案安装失败检查权限和网络连接尝试手动安装技能不生效重启 AI 工具确保技能目录正确API 调用失败检查鉴权信息和网络连接平台兼容性问题参考平台兼容性说明使用推荐的安装方式11. 总结Skills 与 HAP Skills Collection 项目为 AI 工具提供了强大的技能扩展能力特别是为明道云 HAP 平台的开发提供了标准化的流程和最佳实践。通过这些技能开发者可以快速上手明道云 HAP 平台开发减少重复工作提高开发效率遵循最佳实践保证代码质量在多种 AI 工具平台上获得一致的开发体验项目设计合理结构清晰易于维护和扩展为明道云 HAP 平台的生态系统做出了重要贡献。12. 附录12.1 相关链接明道云官网https://www.mingdao.comHAP API 文档https://apifox.mingdao.comClaude 技能文档https://support.claude.com/en/articles/12512198-creating-custom-skillsHAP Skills Collection GitHubhttps://github.com/garfield-bb/hap-skills-collection12.2 版本历史v2.0.0 (2026-01-18)重大更新新增支持 5 个平台提供通用安装脚本v1.0.0 (2026-01-14)初始发布包含 4 个核心技能支持 4 个平台12.3 许可证基础 Skills 框架部分开源Apache 2.0部分源可用HAP Skills CollectionMIT 许可证