hap-skills-updater

HAP Skills Collection 技能更新和维护技能。当用户提到"更新技能"、"维护技能"、"更新 hap-skills"、"更新 skill"等需求时使用。帮助用户更新和维护 HAP Skills Collection 中的 4 个核心技能。

跳到安装

仓库: diegosouzapw/awesome-omni-skill
最近来源活动: 2026年2月28日 04:16
检测到的 SKILL.md 语言: 中文
星标: 50
分支: 19

安装方式

默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

直接命令不会经过审查 Prompt；运行前请先检查来源。

npx skills add https://github.com/diegosouzapw/awesome-omni-skill --skill hap-skills-updater

命令会保持在同一行。复制前请横向滚动并检查完整内容。

想先保存到本地？可下载 SkillsMP 当前能够提供的文件。

检查来源文件

决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。

文件资源管理器

2 个文件

SKILL.md

来源说明 · 只读预览

返回搜索返回安装

artifact-tracking

Token-efficient tracking for AI orchestration. CLI-first for status updates (~50 tokens), agent fallback for complex ops (~1KB). Use when: updating task status, querying blockers, creating progress files, validating phases.

2026-03-02

ash-ai

AshAi extension guidelines for integrating AI capabilities with Ash Framework. Use when implementing vectorization/embeddings, exposing Ash actions as LLM tools, creating prompt-backed actions, or setting up MCP servers. Covers semantic search, LangChain integration, and structured outputs.

2026-03-02

ask-oracle

This skill should be used when solving hard questions, complex architectural problems, or debugging issues that benefit from GPT-5 Pro or GPT-5.1 thinking models with large file context. Use when standard Claude analysis needs deeper reasoning or extended context windows.

2026-03-02

查看这个仓库的全部 Skills

name	hap-skills-updater
description	HAP Skills Collection 技能更新和维护技能。当用户提到"更新技能"、"维护技能"、"更新 hap-skills"、"更新 skill"等需求时使用。帮助用户更新和维护 HAP Skills Collection 中的 4 个核心技能。
license	MIT

HAP Skills Collection 技能更新和维护

本技能帮助用户更新和维护 HAP Skills Collection 中的 4 个核心技能。

📋 核心技能列表

HAP Skills Collection 包含以下 4 个核心技能（需要从 GitHub 仓库更新）：

hap-v3-api - HAP V3 API 使用技能 ✅
hap-view-plugin - HAP 视图插件开发技能 ✅
hap-frontend-project - HAP 前端项目搭建技能 ⚠️（如果不存在，需要从仓库获取）
hap-mcp-usage - HAP MCP 使用指南 ✅

注意: 某些技能可能尚未在本地创建，更新时会自动从 GitHub 仓库同步。

📁 技能目录结构

.claude/skills/
├── hap-v3-api/
│   └── SKILL.md
├── hap-view-plugin/
│   └── SKILL.md
├── hap-frontend-project/
│   └── SKILL.md
└── hap-mcp-usage/
    └── SKILL.md

🔄 更新流程

步骤 1: 检查当前技能版本

在更新技能之前，先检查当前技能的状态：

# 检查技能文件是否存在
ls -la ~/.claude/skills/hap-v3-api/SKILL.md
ls -la ~/.claude/skills/hap-view-plugin/SKILL.md
ls -la ~/.claude/skills/hap-frontend-project/SKILL.md
ls -la ~/.claude/skills/hap-mcp-usage/SKILL.md

# 或者如果是从 GitHub 仓库克隆的
cd /path/to/hap-skills-collection
ls -la .claude/skills/*/SKILL.md

步骤 1.5: 检查并安装 HAP API 文档 MCP（新增）

重要: 在安装/更新技能时，必须检查用户是否已安装 应用 API - API 文档 MCP。

检查 MCP 是否已安装

根据用户当前使用的平台检查 MCP 配置文件：

Claude Code:

# 检查是否已配置
claude mcp list | grep "应用 API - API 文档"

Cursor:

# 检查配置文件
cat ~/.cursor/mcp.json | grep "应用 API - API 文档"
# 或项目级
cat .cursor/mcp.json | grep "应用 API - API 文档"

TRAE:

# 检查配置文件
cat ~/.trae/mcp.json | grep "应用 API - API 文档"
# 或项目级
cat .trae/mcp.json | grep "应用 API - API 文档"

Manus:

# 检查配置文件
cat ~/.manus/mcp.json | grep "应用 API - API 文档"

Coze:

# 检查配置文件（注意配置文件名为 mcp_config.json）
cat ~/.coze/mcp_config.json | grep "应用 API - API 文档"

其他平台: 同理检查对应平台的配置文件

如果未安装，自动安装 API 文档 MCP

MCP 配置信息:

{
  "mcpServers": {
    "应用 API - API 文档": {
      "command": "npx",
      "args": ["-y", "apifox-mcp-server@latest", "--site-id=5442569"]
    }
  }
}

自动安装步骤:

识别平台: 确定用户使用的 AI 工具（Claude Code / Cursor / TRAE / Manus / Coze 等）
读取现有配置: 增量更新，保留用户已有的 MCP 配置
添加 API 文档 MCP:
- Claude Code: claude mcp add "应用 API - API 文档" --command npx --args "-y,apifox-mcp-server@latest,--site-id=5442569"
- Cursor/TRAE/Copilot/Antigravity/OpenCode: 编辑 mcp.json 文件添加配置
- Manus: 编辑 ~/.manus/mcp.json 文件添加配置（JSON 格式，同 Cursor）
- Coze: 编辑 ~/.coze/mcp_config.json 文件添加配置（JSON 格式，可能使用不同的配置结构）
- Windsurf/Gemini CLI/Codex: 软链接平台，自动同步 Claude 配置
验证安装: 检查配置文件是否包含 "应用 API - API 文档"
提示重启: 告知用户需要重启工具使配置生效

示例 - Cursor 平台:

# 读取现有配置
EXISTING_CONFIG=$(cat ~/.cursor/mcp.json 2>/dev/null || echo '{"mcpServers":{}}')

# 添加 API 文档 MCP（增量更新）
cat > ~/.cursor/mcp.json <<EOF
{
  "mcpServers": {
    $(echo "$EXISTING_CONFIG" | jq -r '.mcpServers | to_entries | map("\"\(.key)\": \(.value|tojson)") | join(",")'),
    "应用 API - API 文档": {
      "command": "npx",
      "args": ["-y", "apifox-mcp-server@latest", "--site-id=5442569"]
    }
  }
}
EOF

# 验证安装
cat ~/.cursor/mcp.json | grep "应用 API - API 文档"

示例 - Manus 平台:

# 检查并创建 Manus 配置目录
mkdir -p ~/.manus

# 读取现有配置
EXISTING_CONFIG=$(cat ~/.manus/mcp.json 2>/dev/null || echo '{"mcpServers":{}}')

# 添加 API 文档 MCP（增量更新）
cat > ~/.manus/mcp.json <<EOF
{
  "mcpServers": {
    $(echo "$EXISTING_CONFIG" | jq -r '.mcpServers | to_entries | map("\"\(.key)\": \(.value|tojson)") | join(",")'),
    "应用 API - API 文档": {
      "command": "npx",
      "args": ["-y", "apifox-mcp-server@latest", "--site-id=5442569"]
    }
  }
}
EOF

# 验证安装
cat ~/.manus/mcp.json | grep "应用 API - API 文档"

示例 - Coze 平台:

# 检查并创建 Coze 配置目录
mkdir -p ~/.coze

# 读取现有配置
EXISTING_CONFIG=$(cat ~/.coze/mcp_config.json 2>/dev/null || echo '{"mcpServers":{}}')

# 添加 API 文档 MCP（增量更新）
# 注意: Coze 可能使用 mcp_config.json 而不是 mcp.json
cat > ~/.coze/mcp_config.json <<EOF
{
  "mcpServers": {
    $(echo "$EXISTING_CONFIG" | jq -r '.mcpServers | to_entries | map("\"\(.key)\": \(.value|tojson)") | join(",")'),
    "应用 API - API 文档": {
      "command": "npx",
      "args": ["-y", "apifox-mcp-server@latest", "--site-id=5442569"]
    }
  }
}
EOF

# 验证安装
cat ~/.coze/mcp_config.json | grep "应用 API - API 文档"

告知用户（以 Cursor 为例，其他平台类似）:

✅ HAP API 文档 MCP 已安装

📋 配置信息：
- 平台：Cursor / Manus / Coze / [平台名称]
- MCP 名称：应用 API - API 文档
- 配置文件：~/.cursor/mcp.json / ~/.manus/mcp.json / ~/.coze/mcp_config.json
- 已保留其他 MCP 配置

💡 下一步：
- 重启 [工具名称] 使配置生效
- 现在可以使用 MCP 查询 HAP API 文档了

📖 用途说明：
- 让 AI 读懂 HAP 接口文档（只读，不执行操作）
- 查询 API 文档、学习接口结构、生成 API 调用代码

步骤 2: 更新技能文件

方式一：从 GitHub 仓库更新（推荐）

# 1. 克隆或更新仓库
git clone https://github.com/garfield-bb/hap-skills-collection.git
# 或如果已存在
cd hap-skills-collection
git pull origin main

# 2. 确保本地技能目录存在
mkdir -p ~/.claude/skills

# 3. 复制所有技能到本地技能目录（包括缺失的技能）
cp -r .claude/skills/hap-v3-api ~/.claude/skills/ 2>/dev/null || echo "hap-v3-api 已存在或不存在"
cp -r .claude/skills/hap-view-plugin ~/.claude/skills/ 2>/dev/null || echo "hap-view-plugin 已存在或不存在"
cp -r .claude/skills/hap-frontend-project ~/.claude/skills/ 2>/dev/null || echo "hap-frontend-project 已存在或不存在"
cp -r .claude/skills/hap-mcp-usage ~/.claude/skills/ 2>/dev/null || echo "hap-mcp-usage 已存在或不存在"

# 4. 验证更新（检查实际存在的技能）
ls -la ~/.claude/skills/hap-*/SKILL.md 2>/dev/null

方式二：手动更新单个技能

如果只需要更新某个特定技能：

# 更新单个技能
cp /path/to/hap-skills-collection/.claude/skills/hap-v3-api/SKILL.md ~/.claude/skills/hap-v3-api/SKILL.md

# 更新所有 4 个技能
for skill in hap-v3-api hap-view-plugin hap-frontend-project hap-mcp-usage; do
  cp /path/to/hap-skills-collection/.claude/skills/$skill/SKILL.md ~/.claude/skills/$skill/SKILL.md
done

步骤 3: 验证更新

更新后，验证技能是否正确加载：

# 检查文件大小和修改时间
ls -lh ~/.claude/skills/hap-*/SKILL.md

# 检查文件内容（查看前几行）
head -10 ~/.claude/skills/hap-v3-api/SKILL.md

📝 更新检查清单

更新技能时，请检查以下内容：

✅ 通用检查项

技能文件存在且可读
SKILL.md 文件格式正确（包含 frontmatter）
技能名称和描述正确
文件编码为 UTF-8
没有语法错误
HAP API 文档 MCP 已安装（新增）

✅ MCP 配置检查（新增）

检查平台的 MCP 配置文件
确认是否已安装 "应用 API - API 文档"
如果未安装，自动安装 API 文档 MCP
增量更新，保留用户已有的 MCP 配置
提示用户重启工具使配置生效

✅ 内容检查项

🤖 AI 助手更新指南

当用户需要更新技能时，AI 应该：

1. 识别更新需求

用户可能说：

"更新 hap-skills"
"更新技能"
"同步最新的 skill"
"更新 hap-v3-api 技能"

2. 执行更新操作

如果用户有本地仓库：

# 检查仓库位置
cd /path/to/hap-skills-collection

# 拉取最新更新
git pull origin main

# 复制技能文件
cp -r .claude/skills/* ~/.claude/skills/

# 验证更新
ls -la ~/.claude/skills/hap-*/SKILL.md

# ⚠️ 重要：检查并安装 HAP API 文档 MCP
# （见步骤 1.5）

如果用户没有本地仓库：

# 克隆仓库
git clone https://github.com/garfield-bb/hap-skills-collection.git /tmp/hap-skills-collection

# 确保本地技能目录存在
mkdir -p ~/.claude/skills

# 复制 4 个核心技能文件（只复制存在的）
for skill in hap-v3-api hap-view-plugin hap-frontend-project hap-mcp-usage; do
  if [ -d "/tmp/hap-skills-collection/.claude/skills/$skill" ]; then
    cp -r /tmp/hap-skills-collection/.claude/skills/$skill ~/.claude/skills/
    echo "✅ 已更新 $skill"
  else
    echo "⚠️  $skill 在仓库中不存在，跳过"
  fi
done

# 验证更新（只显示实际存在的技能）
ls -la ~/.claude/skills/hap-*/SKILL.md 2>/dev/null

# ⚠️ 重要：检查并安装 HAP API 文档 MCP
# （见步骤 1.5）

⚠️ 关键提醒:

更新技能后，必须检查 HAP API 文档 MCP 是否已安装
如果未安装，自动帮用户安装（见步骤 1.5）
安装后提示用户重启工具使配置生效

3. 验证更新结果

更新后，AI 应该：

✅ 检查所有 4 个技能文件是否存在
✅ 验证文件大小是否合理（不应该为 0）
✅ 检查文件修改时间是否为最新
✅ 读取文件前几行验证格式正确
✅ 检查 HAP API 文档 MCP 是否已安装（新增）
✅ 如果未安装，自动安装 API 文档 MCP

4. 告知用户

更新完成后，AI 应该告知用户：

✅ 已更新的技能列表（4 个核心技能）
✅ 更新来源（GitHub 仓库）
✅ 技能文件位置（~/.claude/skills/）
✅ HAP API 文档 MCP 安装状态（已安装 / 已跳过 / 刚安装）
⚠️ 可能需要重启 AI 工具才能生效

完整的用户反馈示例:

✅ HAP Skills 更新完成！

📋 已更新技能：
1. ✅ hap-v3-api - HAP V3 API 使用技能
2. ✅ hap-view-plugin - HAP 视图插件开发技能
3. ✅ hap-frontend-project - HAP 前端项目搭建技能
4. ✅ hap-mcp-usage - HAP MCP 使用指南

📦 MCP 配置：
✅ 应用 API - API 文档 MCP 已安装
   - 平台：Cursor
   - 配置文件：~/.cursor/mcp.json
   - 用途：让 AI 读懂 HAP 接口文档

💡 下一步：
- 重启 Cursor 使所有配置生效
- 现在可以使用最新的 HAP 技能了

📚 技能位置：
~/.claude/skills/
├── hap-v3-api/
├── hap-view-plugin/
├── hap-frontend-project/
└── hap-mcp-usage/

🔍 技能文件格式规范

每个技能文件（SKILL.md）应该遵循以下格式：

---
name: skill-name
description: 技能描述，说明何时使用此技能
license: MIT
---

# 技能标题

技能正文内容...

Frontmatter 字段说明

name: 技能名称，必须与目录名一致
description: 技能描述，说明使用场景和触发关键词
license: 许可证（通常为 MIT）

📊 技能更新记录

记录每次更新的内容：

2026-01-14

✅ 初始版本，包含 4 个核心技能
✅ 建立更新流程和检查清单

🛠️ 故障排查

问题 1: 技能文件不存在

症状: ls: ~/.claude/skills/hap-xxx/SKILL.md: No such file or directory

解决方案:

# 创建技能目录
mkdir -p ~/.claude/skills/hap-v3-api
mkdir -p ~/.claude/skills/hap-view-plugin
mkdir -p ~/.claude/skills/hap-frontend-project
mkdir -p ~/.claude/skills/hap-mcp-usage

# 从仓库复制文件
cp /path/to/hap-skills-collection/.claude/skills/*/SKILL.md ~/.claude/skills/*/

问题 2: 技能文件格式错误

症状: AI 无法识别技能

解决方案:

检查 frontmatter 格式是否正确
确保文件编码为 UTF-8
检查是否有语法错误

问题 3: 更新后技能未生效

症状: 更新文件后，AI 仍使用旧版本

解决方案:

重启 AI 工具（Claude Code CLI、Cursor 等）
清除缓存（如果工具支持）
验证文件修改时间是否为最新

📚 相关资源

GitHub 仓库: https://github.com/garfield-bb/hap-skills-collection
技能文档: 每个技能的 SKILL.md 文件
更新日志: GitHub 仓库的 commit 历史

💡 最佳实践

定期更新: 建议每周或每月更新一次技能
版本控制: 使用 git 管理技能文件，便于回滚
备份: 更新前备份现有技能文件
验证: 更新后验证技能是否正常工作
文档同步: 更新技能时同步更新 README.md

🎯 使用场景

当用户提到以下内容时，使用此技能：

"更新 hap-skills"
"同步最新的技能"
"更新 skill"
"维护技能"
"检查技能版本"
"更新 hap-v3-api"
"更新视图插件技能"

注意: 此技能仅用于更新和维护 HAP Skills Collection 中的 4 个核心技能。如果需要添加新技能或修改技能内容，请参考各技能的 SKILL.md 文件。

hap-skills-updater

来源信息

安装方式

检查来源文件

同仓库更多 Skills

HAP Skills Collection 技能更新和维护

📋 核心技能列表

📁 技能目录结构

🔄 更新流程

步骤 1: 检查当前技能版本

步骤 1.5: 检查并安装 HAP API 文档 MCP（新增）

检查 MCP 是否已安装

如果未安装，自动安装 API 文档 MCP

步骤 2: 更新技能文件

方式一：从 GitHub 仓库更新（推荐）

方式二：手动更新单个技能

步骤 3: 验证更新

📝 更新检查清单

✅ 通用检查项

✅ MCP 配置检查（新增）

✅ 内容检查项

🤖 AI 助手更新指南

1. 识别更新需求

2. 执行更新操作

3. 验证更新结果

4. 告知用户

🔍 技能文件格式规范

Frontmatter 字段说明

📊 技能更新记录

2026-01-14

🛠️ 故障排查

问题 1: 技能文件不存在

问题 2: 技能文件格式错误

问题 3: 更新后技能未生效

📚 相关资源

💡 最佳实践

🎯 使用场景

同仓库更多 Skills

HAP Skills Collection 技能更新和维护

📋 核心技能列表

📁 技能目录结构

🔄 更新流程

步骤 1: 检查当前技能版本

步骤 1.5: 检查并安装 HAP API 文档 MCP（新增）

检查 MCP 是否已安装

如果未安装，自动安装 API 文档 MCP

步骤 2: 更新技能文件

方式一：从 GitHub 仓库更新（推荐）

方式二：手动更新单个技能

步骤 3: 验证更新

📝 更新检查清单

✅ 通用检查项

✅ MCP 配置检查（新增）

✅ 内容检查项

🤖 AI 助手更新指南

1. 识别更新需求

2. 执行更新操作

3. 验证更新结果

4. 告知用户

🔍 技能文件格式规范

Frontmatter 字段说明

📊 技能更新记录

2026-01-14

🛠️ 故障排查

问题 1: 技能文件不存在

问题 2: 技能文件格式错误

问题 3: 更新后技能未生效

📚 相关资源

💡 最佳实践

🎯 使用场景