القائمة
管理 hai-framework 与应用仓库之间的依赖、技能模板、Copilot/AGENTS 指令和本地联调同步；当需求涉及 hai-framework 源头修改、skills 同步、framework:use:local、framework:watch、版本漂移或双仓 PR 时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
Use when: using @h-ai/ai, LLM calls, chat completion, tool calling, function calling, MCP server, streaming, memory management, context compression, summarization, token estimation, RAG, knowledge base, AI client, embeddings, reasoning, rerank, file parsing, speech recognition ASR, speech synthesis TTS, audio, A2A agent-to-agent. 使用 @h-ai/ai 进行 LLM 调用、工具定义、MCP 服务器、流式处理、记忆管理、上下文压缩、知识库、推理引擎、Rerank、文件解析、语音识别与合成、A2A 与会话持久化。
Use when: using @h-ai/ai for LLM calls, tools, MCP, streaming, memory/context, RAG, audio, A2A, or the AI client. 当需求涉及 AI 对话、工具、Audio、会话、知识库或 AI 客户端时使用。
Use when: creating or extending apps in hai-framework, adding routes, pages, API endpoints, service workspaces, mobile app, H5 app, admin console. 在 hai-framework 中创建或扩展应用或 API service workspace，包含路由、API 端点、typed contract、服务层与 UI 脚手架代码。
Use when: creating a new module, new package, scaffold, add sub-feature, add provider, create repository, module structure, tsup config, error codes, NotInitializedKit pattern. 在 hai-framework 中创建新模块（package）。
Use when: reviewing app code in hai-framework, auditing app quality, checking app conventions, reviewing routes, reviewing API service workspaces, app security, app i18n review. 对 hai-framework 应用层代码进行审查：路由安全 → 认证授权 → i18n → 组件使用 → API 端点 / service workspace → 服务层 → 性能。
Use when: reviewing code, code review, auditing module quality, checking hai-framework conventions, verifying HaiResult<T> usage, reviewing module structure, PR review, checking naming consistency, verifying NotInitializedKit pattern, auditing performance, security, distributed systems. 对 hai-framework 模块进行全维度代码审查：架构 → 命名 → 类型 → 注释 → 性能 → 分布式 → 安全 → 日志 → 测试 → 文档。
استنادا إلى تصنيف SOC المهني
| name | hai-framework-sync |
| description | 管理 hai-framework 与应用仓库之间的依赖、技能模板、Copilot/AGENTS 指令和本地联调同步；当需求涉及 hai-framework 源头修改、skills 同步、framework:use:local、framework:watch、版本漂移或双仓 PR 时使用。 |
| 项目 | 契约 |
|---|---|
| 能力 | 管理 hai-framework 与应用仓库之间的依赖、技能模板、Copilot/AGENTS 指令和本地联调同步；当需求涉及 hai-framework 源头修改、skills 同步、framework:use:local、framework:watch、版本漂移或双仓 PR 时使用。 |
| 适用场景 | 当任务与 hai-framework-sync 的能力描述匹配，并且需要遵循本 Skill 的流程和边界时 |
| 输入 | 用户目标、仓库与运行环境上下文、现有配置、授权范围和质量门禁 |
| 输出 | 与目标匹配的配置/代码/文档或审查结论，以及可复现的验证结果 |
| 限制 | 不扩张用户授权，不输出或固化密钥，不跳过失败门禁，不假定外部服务状态 |
hai-framework 是能力与 skill 模板源头；应用仓库消费这些能力，并可以有少量项目本地覆盖。同步的目标是减少漂移，而不是把两个仓库混成一个仓库。
.agents/skills/**，且内容应成为所有 hai-framework 应用通用规范packages/cli/templates/skills/**AGENTS.md、CLAUDE.md、opencode.json、Copilot 指令模板framework:use:local / framework:watch 联调本地 hai-frameworkpackages/cli/templates/skills/ 起源。.agents/skills、AGENTS/Copilot 路由同时更新。| 变更类型 | 首选位置 |
|---|---|
| 通用 hai 模块用法 | hai-framework/packages/cli/templates/skills/hai-*/SKILL.md |
| 通用 CI/PR/Issue/AI 协作流程 | hai-framework/packages/cli/templates/skills/ |
| 应用私有业务规则 | 应用仓库 AGENTS.md 或本地 skill |
| Copilot/Claude/OpenCode 入口模板 | hai-framework 模板 + 应用仓库入口文件 |
先在 hai-framework 模板中修改或新增 skill。
把源头 skill 复制到应用仓库 .agents/skills/<skill>/SKILL.md，并同步入口引用：
AGENTS.md.github/copilot-instructions.mdCLAUDE.md（如存在）opencode.json（如结构变化）按变更类型选择验证方式：
hai-ci 定义的质量门禁运行。pnpm framework:status
pnpm framework:use:local <package>
pnpm framework:watch <package>
.agents/skills 对同名 skill 内容一致，除非 PR 明确说明本地覆盖AGENTS.md 的 skill 列表包含新增/重命名 skill/home/.../hai-framework 本地路径.agents/skills，忘记更新 hai-framework 模板中的通用规范hai-ci — CI 对 npm/local framework 模式的验证策略hai-pr-review — 双仓 PR 审查要点hai-build — 应用开发入口