@h-ai/cli 0.1.0-alpha.54 → 0.1.0-alpha.56

package/templates/skills/bridges/h5/copilot-instructions.md

@@ -2,43 +2,8 @@
 
 > H5 移动端工程指引。详细模块用法按需读取 `.agents/skills/`。
 
-## 行为契约
-
-- 每次响应第一行写：`规模: XS|S|M|L — <一句话意图>`。
-- 任务规模 ≥ M 时，先输出 Q1-Q7 必要性自检与影响分析，再开始修改。
-- 修改前先阅读 `AGENTS.md`、`README.md`、相关页面 / messages / 测试与 `.agents/skills/*/SKILL.md`。
-
-## 技术栈要点
-
-- SvelteKit + Svelte 5 Runes。
-- TailwindCSS / DaisyUI / `@h-ai/ui` 移动组件。
-- Paraglide i18n。
-
-## 技术边界
-
-- 页面组件只负责渲染和交互；复杂业务逻辑放在服务层或模块 API。
-- 移动端文案、导航和错误提示全部走 i18n。
-- `+server.ts` 只能导出 handler 与官方允许的配置项；helper 放到 `src/lib/**`。
-- 优先复用现有移动端导航与组件，不要引入不必要的桌面式交互。
-- 禁止 `any`、`console.log`、硬编码密钥。
-
-## 开发流程
-
-1. 先检索现有移动端页面、导航、messages、API 和测试。
-2. 修改导航、API 或认证流程时，同步 README、i18n 和测试。
-3. 不要把未运行或失败的门禁写成“已通过”。
+共享规则见项目根 [AGENTS.md](../AGENTS.md)；若未自动加载，先读取该文件。模块/流程按需读取项目根 .agents/skills/<name>/SKILL.md 及其相邻参考文件。
 
 ## 质量门禁
 
-```bash
-pnpm typecheck
-pnpm lint
-pnpm build
-pnpm test
-pnpm test:e2e
-```
-
-## 完成条件
-
-- 页面、导航、API、i18n 与测试同步更新。
-- 最终交付说明中列出门禁状态、受影响流程 / 文档与未完成项。
+按 AGENTS.md 和实际 package.json 选择 typecheck、lint、build、test、test:e2e；最终说明已执行结果、未运行原因及同步文档/依赖方。

package/templates/skills/bridges/mobile-app/AGENTS.md

@@ -4,22 +4,7 @@
 
 ## 行为契约
 
-1. 每次响应第一行写：`规模: XS|S|M|L — <一句话意图>`。
-2. 任务规模 ≥ M 时，先回顾现有页面、原生桥接、API 调用、messages、测试与 `.agents/skills/*/SKILL.md`。
-3. 在写第一行新代码前，用 1 行回答 Q1-Q7 必要性自检。
-4. 任务规模 ≥ M 时，说明将影响的页面、状态管理、原生桥接、API、messages、README 和测试。
-
-## 必要性自检（M / L 任务必须输出）
-
-- Q1：已有页面、store、service、Capacitor 封装是否可复用？
-- Q2：能否扩展现有 `src/lib/capacitor.ts`、service 或组件，而不是新建抽象层？
-- Q3：当前真实调用点是哪些页面、原生能力或 API 流程？
-- Q4：能否用更少的 page、store、helper 解决？
-- Q5：是否把原生桥接、token 或 API 细节泄漏给页面层？
-- Q6：是否与现有 Svelte 5 + Vite + Capacitor 目录、脚本和 i18n 一致？
-- Q7：是否比较过更安全的存储、权限和网络调用方案？
-
-## 影响分析（M / L 任务必须输出）
+先读 README、package.json、相关实现/测试和所需 .agents/skills；不要加载整个 skill 树。新增抽象前确认复用路径与真实需求；保留用户改动。跨文件任务简述影响和验证计划，无须固定规模标签或重复问卷。
 
 - 直接影响：哪些页面、store、原生桥接、messages、README、测试和打包脚本会变。
 - 间接影响：哪些 Android/iOS 权限、API 调用方、构建/打包流程和共享组件需要同步。
@@ -52,10 +37,12 @@ pnpm cap:build:android:release
 
 1. 先搜索现有页面、stores、原生桥接、API client、messages 和测试。
 2. 修改原生能力、权限、登录态或 API 流程时，同步 README、i18n 和测试。
-3. 每次改动后运行质量门禁，不能留下“已知失败”。
+3. 按改动范围验证，修复本次引入的失败；已有问题与未运行项明确报告。
 
 ## 质量门禁
 
+先核对 package.json，按影响范围执行已有脚本；文档检查引用，UI/路由变更再运行 E2E。未运行项说明原因。
+
 ```bash
 pnpm typecheck
 pnpm lint
@@ -74,4 +61,4 @@ pnpm test:e2e
 
 - `hai-build`、`hai-app-review`、`hai-app-tests`
 - `hai-ui`、`hai-api-client`、`hai-capacitor`
-- 其它 `hai-*` 模块按需读取
+- 其它 `hai-*` 模块按需读取

package/templates/skills/bridges/mobile-app/CLAUDE.md

@@ -4,16 +4,8 @@
 
 > Claude Code Capacitor Mobile App 项目指引。共享规范通过 `@AGENTS.md` 复用；具体模块用法按需读取 `.agents/skills/`。
 
-如果当前运行环境未自动展开 `@AGENTS.md`，必须先手动阅读 `AGENTS.md`，再开始修改代码或文档。
+共享规则见项目根 [AGENTS.md](AGENTS.md)；若未自动加载，先读取该文件。模块/流程按需读取项目根 .agents/skills/<name>/SKILL.md 及其相邻参考文件。
 
-## 开始工作前
+## 质量门禁
 
-- 回复第一行保持：`规模: XS|S|M|L — <一句话意图>`。
-- 任务规模 ≥ M 时，先输出 Q1-Q7 必要性自检与影响分析。
-- 修改前先看 `src/`、`src/lib/capacitor.ts`、API client、messages 和测试。
-
-## Mobile/Capacitor 特有提醒
-
-- 本项目是 Svelte 5 + Vite，不是 SvelteKit；不要新建 `+page.svelte`、`hooks.server.ts` 等文件。
-- 设备能力与 token 存储放在原生桥接 / service 层，不要散落进页面模板。
-- 页面文本、错误提示和设置项都要同步 i18n。
+按 AGENTS.md 和实际 package.json 选择 typecheck、lint、build、test、test:e2e；最终说明已执行结果、未运行原因及同步文档/依赖方。

package/templates/skills/bridges/mobile-app/copilot-instructions.md

@@ -2,44 +2,8 @@
 
 > Capacitor Mobile App 工程指引。详细模块用法按需读取 `.agents/skills/`。
 
-## 行为契约
-
-- 每次响应第一行写：`规模: XS|S|M|L — <一句话意图>`。
-- 任务规模 ≥ M 时，先输出 Q1-Q7 必要性自检与影响分析，再开始修改。
-- 修改前先阅读 `AGENTS.md`、`README.md`、相关页面 / 原生桥接 / 测试与 `.agents/skills/*/SKILL.md`。
-
-## 技术栈要点
-
-- Svelte 5 + Vite SPA（无 SvelteKit）。
-- Capacitor Android/iOS 原生壳。
-- `@h-ai/capacitor` 负责原生能力和安全 token 存储。
-- `@h-ai/api-client` 负责 typed API 调用。
-
-## 技术边界
-
-- 不新增 `+page.svelte` / `+layout.svelte` / `hooks.server.ts` 等 SvelteKit 文件。
-- 原生能力封装在 `src/lib/capacitor.ts` 或 service，不写进页面模板。
-- 原生 token 使用安全存储；Web 预览不要落到不安全持久化存储。
-- 页面文本走 i18n。
-- 禁止 `any`、`console.log`、硬编码密钥。
-
-## 开发流程
-
-1. 先检索现有页面、store、原生桥接、API client、messages 和测试。
-2. 修改原生能力、权限、登录态或 API 流程时，同步 README、i18n 和测试。
-3. 不要把未运行或失败的门禁写成“已通过”。
+共享规则见项目根 [AGENTS.md](../AGENTS.md)；若未自动加载，先读取该文件。模块/流程按需读取项目根 .agents/skills/<name>/SKILL.md 及其相邻参考文件。
 
 ## 质量门禁
 
-```bash
-pnpm typecheck
-pnpm lint
-pnpm build
-pnpm test
-pnpm test:e2e
-```
-
-## 完成条件
-
-- 页面、原生桥接、API、i18n 与测试同步更新。
-- 交付说明中列出门禁状态、受影响的设备能力 / 文档与未完成项。
+按 AGENTS.md 和实际 package.json 选择 typecheck、lint、build、test、test:e2e；最终说明已执行结果、未运行原因及同步文档/依赖方。

package/templates/skills/bridges/website/AGENTS.md

@@ -4,22 +4,7 @@
 
 ## 行为契约
 
-1. 每次响应第一行写：`规模: XS|S|M|L — <一句话意图>`。
-2. 任务规模 ≥ M 时，先回顾现有页面、SEO 相关实现、表单/API、测试与 `.agents/skills/*/SKILL.md`。
-3. 在写第一行新代码前，用 1 行回答 Q1-Q7 必要性自检。
-4. 任务规模 ≥ M 时，说明将影响的页面、表单、messages、SEO 元信息、测试和 README。
-
-## 必要性自检（M / L 任务必须输出）
-
-- Q1：已有页面 / layout / 组件 / 表单是否可复用？
-- Q2：能否扩展现有 route、section、组件，而不是新增抽象层？
-- Q3：当前真实调用点是哪些页面、表单或 API？
-- Q4：能否用更少的 section、组件、helper 解决？
-- Q5：是否把后端、存储或中间态细节泄漏给页面层？
-- Q6：是否与现有路由、i18n、SEO 和脚本一致？
-- Q7：是否比较过更安全的表单校验、SEO 和构建方案？
-
-## 影响分析（M / L 任务必须输出）
+先读 README、package.json、相关实现/测试和所需 .agents/skills；不要加载整个 skill 树。新增抽象前确认复用路径与真实需求；保留用户改动。跨文件任务简述影响和验证计划，无须固定规模标签或重复问卷。
 
 - 直接影响：哪些页面、layout、表单/API、messages、README、测试会变。
 - 间接影响：哪些导航入口、SEO 标签、部署脚本和共享组件需要同步。
@@ -41,10 +26,12 @@
 
 1. 先搜索现有页面、layout、组件、messages、表单/API 和测试。
 2. 修改页面时同步 README、i18n、测试和 SEO 相关元信息。
-3. 每次改动后运行质量门禁，不能留下“已知失败”。
+3. 按改动范围验证，修复本次引入的失败；已有问题与未运行项明确报告。
 
 ## 质量门禁
 
+先核对 package.json，按影响范围执行已有脚本；文档检查引用，UI/路由变更再运行 E2E。未运行项说明原因。
+
 ```bash
 pnpm typecheck
 pnpm lint

package/templates/skills/bridges/website/CLAUDE.md

@@ -4,16 +4,8 @@
 
 > Claude Code 企业官网项目指引。共享规范通过 `@AGENTS.md` 复用；具体模块用法按需读取 `.agents/skills/`。
 
-如果当前运行环境未自动展开 `@AGENTS.md`，必须先手动阅读 `AGENTS.md`，再开始修改代码或文档。
+共享规则见项目根 [AGENTS.md](AGENTS.md)；若未自动加载，先读取该文件。模块/流程按需读取项目根 .agents/skills/<name>/SKILL.md 及其相邻参考文件。
 
-## 开始工作前
+## 质量门禁
 
-- 回复第一行保持：`规模: XS|S|M|L — <一句话意图>`。
-- 任务规模 ≥ M 时，先输出 Q1-Q7 必要性自检与影响分析。
-- 修改前先看 `src/routes/`、`messages/*`、表单/API 与测试。
-
-## 官网特有提醒
-
-- 页面文案、导航、SEO 元信息与 i18n 需要一起维护。
-- 优先复用现有 `@h-ai/ui` 组件，不要重复造轮子。
-- 不要把 `@h-ai/serv` / `@h-ai/api-client` 当成默认官网主架构。
+按 AGENTS.md 和实际 package.json 选择 typecheck、lint、build、test、test:e2e；最终说明已执行结果、未运行原因及同步文档/依赖方。

package/templates/skills/bridges/website/copilot-instructions.md

@@ -2,43 +2,8 @@
 
 > 企业官网工程指引。详细模块用法按需读取 `.agents/skills/`。
 
-## 行为契约
-
-- 每次响应第一行写：`规模: XS|S|M|L — <一句话意图>`。
-- 任务规模 ≥ M 时，先输出 Q1-Q7 必要性自检与影响分析，再开始修改。
-- 修改前先阅读 `AGENTS.md`、`README.md`、相关页面 / messages / 测试与 `.agents/skills/*/SKILL.md`。
-
-## 技术栈要点
-
-- SvelteKit 页面与路由。
-- TailwindCSS / DaisyUI / `@h-ai/ui`。
-- Paraglide i18n，messages 位于 `messages/zh-CN.json` 与 `messages/en-US.json`。
-
-## 技术边界
-
-- 所有页面文案走 i18n。
-- 表单/API 输入使用 Zod 校验。
-- `+server.ts` 只能导出 handler 与官方允许的配置项；helper 放到 `src/lib/**`。
-- 页面内容、SEO 元信息和测试要一起维护。
-- 禁止 `any`、`console.log`、硬编码密钥。
-
-## 开发流程
-
-1. 先检索现有页面、组件、messages、表单/API 和测试。
-2. 修改页面或 SEO 相关实现时，同步 README、i18n、测试和元信息。
-3. 不要把未运行或失败的门禁写成“已通过”。
+共享规则见项目根 [AGENTS.md](../AGENTS.md)；若未自动加载，先读取该文件。模块/流程按需读取项目根 .agents/skills/<name>/SKILL.md 及其相邻参考文件。
 
 ## 质量门禁
 
-```bash
-pnpm typecheck
-pnpm lint
-pnpm build
-pnpm test
-pnpm test:e2e
-```
-
-## 完成条件
-
-- 页面、表单、SEO、i18n 与测试同步更新。
-- 最终交付说明中列出门禁状态、受影响页面 / 文档与未完成项。
+按 AGENTS.md 和实际 package.json 选择 typecheck、lint、build、test、test:e2e；最终说明已执行结果、未运行原因及同步文档/依赖方。

package/templates/skills/copilot-instructions.md

@@ -2,42 +2,8 @@
 
 > 本文件作为 Copilot 项目级指引；当缺少 appType 专属桥接时，使用本文件作为 generic fallback。详细用法按需读取 `.agents/skills/`。
 
-## 行为契约
-
-- 每次响应第一行写：`规模: XS|S|M|L — <一句话意图>`。
-- 任务规模 ≥ M 时，先输出 Q1-Q7 必要性自检与影响分析，再开始修改。
-- 修改前先阅读 `README.md`、相关测试、`AGENTS.md` 与对应 `.agents/skills/*/SKILL.md`。
-- 不要把未运行或失败的门禁写成“已通过”。
-
-## 通用约定
-
-- 使用 hai-framework 的模块生命周期：`init(config) -> use -> close()`。
-- 公共 API 返回 `HaiResult<T>` 或 `Promise<HaiResult<T>>`，业务错误不要直接 `throw`。
-- 禁止 `any`、`console.log`、硬编码密钥。
-- 用户可见文本必须走 i18n，并同步中英文消息文件。
-- 代码注释中文，日志消息英文。
-- 若项目使用 SvelteKit，`+server.ts` 只能导出 handler 与官方允许的配置项。
-
-## 开发流程
-
-1. 先用全局检索确认现有实现、引用点、测试和文档。
-2. 优先复用现有目录和模块，不新增无真实调用点的抽象。
-3. 修改公共类型、API、模板或共享逻辑后，同步 README、测试和所有依赖方。
+共享规则见项目根 [AGENTS.md](../AGENTS.md)；若未自动加载，先读取该文件。模块/流程按需读取项目根 .agents/skills/<name>/SKILL.md 及其相邻参考文件。
 
 ## 质量门禁
 
-按影响范围执行：
-
-```bash
-pnpm typecheck
-pnpm lint
-pnpm build
-pnpm test
-pnpm test:e2e
-```
-
-## 完成条件
-
-- 门禁失败必须先修复；未执行项要写明原因。
-- README、i18n、测试、代码注释与实现保持一致。
-- 最终交付说明中列出门禁状态、已同步文档与依赖方。
+按 AGENTS.md 和实际 package.json 选择 typecheck、lint、build、test、test:e2e；最终说明已执行结果、未运行原因及同步文档/依赖方。