메뉴
设计和维护 hai-framework 应用仓库的 CI/CD、GitHub Actions、质量门禁、secret scan 与 workflow 安全；当需求涉及 CI、GitHub Actions、required checks、泄漏扫描或 release workflow 编排时使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
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 模块进行全维度代码审查：架构 → 命名 → 类型 → 注释 → 性能 → 分布式 → 安全 → 日志 → 测试 → 文档。
| name | hai-ci |
| description | 设计和维护 hai-framework 应用仓库的 CI/CD、GitHub Actions、质量门禁、secret scan 与 workflow 安全；当需求涉及 CI、GitHub Actions、required checks、泄漏扫描或 release workflow 编排时使用。 |
| 项目 | 契约 |
|---|---|
| 能力 | 设计和维护 hai-framework 应用仓库的 CI/CD、GitHub Actions、质量门禁、secret scan 与 workflow 安全；当需求涉及 CI、GitHub Actions、required checks、泄漏扫描或 release workflow 编排时使用。 |
| 适用场景 | 当任务与 hai-ci 的能力描述匹配，并且需要遵循本 Skill 的流程和边界时 |
| 输入 | 用户目标、仓库与运行环境上下文、现有配置、授权范围和质量门禁 |
| 输出 | 与目标匹配的配置/代码/文档或审查结论，以及可复现的验证结果 |
| 限制 | 不扩张用户授权，不输出或固化密钥，不跳过失败门禁，不假定外部服务状态 |
面向 AI 助手和团队成员的仓库自动化指南。目标是让每个 PR 都能被机器稳定验证，同时避免把 secrets 暴露给不可信 PR 或第三方 Action。
.github/workflows/**pnpm typecheck、pnpm lint、pnpm test、pnpm build、E2E不负责：PR 人工审查流程（用 hai-pr-review）、测试用例设计（用 hai-app-tests）、代码质量审查（用 hai-app-review）、云资源开通与应用部署 API（用 hai-deploy）。
hai-app-tests，代码规范判断交给 hai-app-review。permissions: contents: read，只有 release、comment、pages 等明确场景才提升权限。pull_request_target + checkout PR 代码 + secrets/写权限。建议顺序：
pnpm install --frozen-lockfile
pnpm typecheck
pnpm lint
pnpm test
pnpm build
测试覆盖范围与 TDD 断言由 hai-app-tests 定义；本技能只决定这些命令如何在 workflow 中稳定执行。
workflow_dispatch / schedule / 独立 job。pnpm --filter <app> test:e2e。pnpm-lock.yaml 中的 npm/published 依赖，确保与真实安装环境一致。framework:use:local / framework:watch，但不要让默认 PR CI 隐式依赖本机路径。permissionspull_request，不用 pull_request_targetconcurrency 取消同分支旧任务.env 内容|| true 掩盖核心质量门禁pull_request_target 中 checkout 不可信 PR 代码后读取 secrets.*修改 CI/CD 时，PR 描述必须包含：
pull_request / push / workflow_dispatch / schedulepermissionshai-build — 项目结构与质量门禁总览hai-app-tests — Vitest / Playwright 测试规范hai-pr-review — PR 审查与 AI Review 策略hai-deploy — 应用部署与云服务开通hai-framework-sync — hai-framework 与应用仓库同步策略