@dianzhong/create-harness-app 0.1.0

package/templates/harness/full/.claude/rules/delivery.md

@@ -0,0 +1,66 @@
+# 交付与质量规则
+
+## 需求确认
+
+在以下场景，**必须先输出需求理解摘要并等待用户确认，再开始编码**：
+
+- 创建新功能、新页面或新组件。
+- 涉及 3 个及以上文件的变更。
+- 用户描述存在歧义、缺少验收标准或多种理解可能。
+- 涉及状态设计、路由变更、权限调整、数据库变更。
+- 用户说"优化一下"、"改一下"等模糊指令。
+
+用户明确说"直接做"或"不需要确认"时，可跳过此环节。
+
+### 需求确认输出格式
+
+1. **需求理解**：我理解的你的需求是...
+2. **变更范围**：预计修改 X 个文件，涉及...
+3. **关键决策**：需要确认的问题（如两种方案选哪个）。
+4. **验证计划**：改完后如何验证。
+
+## 探索与创意工作
+
+遇到以下场景时，应先使用 brainstorming skill 理解需求和设计方向：
+
+- 创建新功能、新页面或新组件。
+- 对现有功能进行较大的重构或行为变更。
+- 涉及多个模块或跨组件的状态设计。
+- 用户需求不明确或存在多种可行方案。
+
+## Bug 修复
+
+遇到 bug、测试失败或意外行为时，应先使用 systematic-debugging skill 系统化排查根因：
+
+- 复现问题并定位根因。
+- 确认修复方案不会引入副作用。
+- 验证修复后通过相同检查。
+
+## 声称完成的流程
+
+在声称任务完成前，必须完成以下步骤：
+
+1. 验证所有必需的检查已通过（`pnpm check` 或对应场景的检查）。
+2. 如果某些检查未运行，必须在交付说明中明确记录原因和剩余风险。
+3. 确认变更范围与需求一致，没有引入未要求的副作用。
+4. 按 `docs/delivery-template.md` 输出交接单。
+5. 确认人工复核已完成或已安排。
+
+Code review 必须阻断 P0/P1 问题、门禁失败、安全风险、权限绕过、路由 meta 回归、未类型化状态/API 边界。低风险建议可以通过，但需在 review 备注中说明。
+
+使用 verification-before-completion skill（来自 superpowers 插件）作为检查清单。
+
+## Code Review 反馈处理
+
+收到 review 反馈后，应独立判断每个建议的技术合理性：
+
+- 对每个反馈的技术准确性进行验证。
+- 不盲目接受所有建议，也不无理拒绝。
+- 对不接受的建议，说明技术理由并记录。
+- 处理完所有阻断性问题后，重新请求 review。
+
+使用 receiving-code-review skill（来自 superpowers 插件）作为处理原则。
+
+## 人工反馈循环
+
+用户指出某处可能有问题、补充业务规则或确认风险后，先复述理解，再定位相关代码和规则。明确判断反馈属于 bug、需求补充、业务决策、验证遗漏还是误报；需要修复时再改代码，不修改时说明理由。处理完成后重新运行对应检查，并输出第二版交接单。

package/templates/harness/full/.claude/rules/formatting.md

@@ -0,0 +1,7 @@
+# 格式化与自动修复规则
+
+- Prettier 负责排版统一；ESLint 和 oxlint 负责代码质量与自动修复。
+- 命令清单见 `docs/harness-quick-reference.md`"格式化命令"段，不在此复述。
+- 提交前的 `lint-staged` 只处理已暂存文件；不要把大范围格式整理和业务改动混在同一次提交里。
+- 如无明确需求，不要对无关文件执行全仓格式化。
+- `quality-gate.cjs stop` 允许在 Stop 收尾自动格式化；`lint-staged` 作为 pre-commit safety net 允许自动修复。所有 hook 和 AI 自身不得自动暂存或改写 repo-tracked 文件，详见 `docs/ai-harness.md` 维护规则。

package/templates/harness/full/.claude/rules/git.md

@@ -0,0 +1,8 @@
+# Git 规则（AI 操作约束）
+
+约束 AI agent 的 git 行为；分支命名、Conventional Commits 等团队约定见 `docs/git.md`。
+
+- 保留用户已有的无关改动，未经允许不动其它文件。
+- 未经明确允许，不执行破坏性 Git 命令（`git reset --hard`、force push、删除分支、删除 stash 等）。
+- Stop 收尾的质量门禁只做质量检查和自动格式化，不自动暂存变更。除此之外也不自动暂存，不自动改写 repo-tracked 文件。
+- Pre-commit 只运行 `pnpm lint-staged`；完整质量检查由交付前 `pnpm check` 和 Stop 阶段门禁执行。

package/templates/harness/full/.claude/rules/skills-mcp.md

@@ -0,0 +1,13 @@
+# Skills 同步规则
+
+- 不确定是否已有合适 skill 时，先查 `docs/harness-quick-reference.md`。
+- 项目 skills 放在 `.claude/skills/`。
+- `skills-lock.json` 必须保存每个 skill 的真实 computed hash。
+
+新增或修改 skill 时，必须同步以下 3 个位置：
+
+1. `.claude/skills/{skill}/`
+2. `.agents/skills/{skill}/`（其他 agent 的镜像）
+3. `skills-lock.json`（hash lock）
+
+修改任何 skill 后必须先运行 `pnpm harness:sync`，再运行 `pnpm harness:check`。

package/templates/harness/full/.claude/rules/vue.md

@@ -0,0 +1,227 @@
+# Vue 与 Element Plus 规则
+
+- 使用 Vue 3 Composition API 和 `<script setup lang="ts">`，SFC 顺序统一为 `<script>`、`<template>`、`<style>`。
+- 路由页面作为组合层，不堆积复杂实现；较大 UI 拆到 `src/components/<feature>/`。
+- 可复用的有状态逻辑放到 `src/composables/useXxx.ts`。
+- props、emits、store state、route meta、类 API 数据边界必须显式类型化。
+- 能用 `computed` 派生的状态不要重复存储；watcher 只用于副作用。
+- 路由和菜单由后端 `/auth/menus` 菜单树动态生成；`src/router/routes.ts` 只保留布局和常量路由，`src/router/component-map.ts` 负责组件解析和隐藏路由。
+- Element Plus 使用项目现有自动导入配置；全局主题覆盖放到 `src/styles/element-plus.scss`。
+- 避免宽泛 `any`、重复菜单数据源、隐藏异步错误、未类型化权限字符串。
+
+## 弹窗组件化规范
+
+- 路由页面只保留列表/主视图逻辑，弹窗必须拆分为独立组件。
+- **页面级弹窗放到所属页面目录下的 `components/` 中**，作为该页面的私有组件；跨页面复用的弹窗才放到 `src/components/<feature>/`。
+- **弹窗可见性通过 `v-model` + `defineModel` 传递**：
+  - 父组件：`<Dialog v-model="dialogVisible" v-if="dialogVisible" />`
+  - 子组件：`const visible = defineModel<boolean>({ required: true })`
+  - `v-if` 控制组件挂载/销毁，确保每次打开都走完整的生命周期（`onMounted` → `onUnmounted`）。
+  - `v-model` 负责在弹窗内部与 ElDialog 的显示状态同步。
+- **弹窗 props 最小化**：只接收必要 ID（如 `userId` / `roleId`），不接收完整对象数据。
+- **弹窗内部自加载**：在 `onMounted` 中根据 ID 调用 detail API 获取详情，编辑和查看场景均如此；新增场景 ID 为 undefined，直接初始化空状态。
+- **禁止在弹窗内使用 watcher 监听 ID 变化来重置状态**；状态初始化只在 `onMounted` 中完成，关闭时由 `v-if` 自然销毁重置。
+- **禁止在 ElDialog 上使用 `@open` 做状态重置或数据加载**。父组件通过 `v-if` 控制弹窗时，组件每次打开都会重新挂载，setup 会重新执行，状态天然重置；数据加载应放在 `onMounted` 中。`@open` 仅在父组件使用 `v-show` 时才需要，但本项目统一使用 `v-if`。
+- 弹窗通过 emit `success` 通知父组件操作成功，父组件监听后刷新列表。
+
+## 状态枚举规范（强制）
+
+- 除 boolean（是/否）外，所有表示业务状态的数值常量**必须**使用 TypeScript `enum`，**严禁**直接使用字面量数字做判断或赋值，例如：
+  - ❌ `status === 1`、`reviewType: 2`、`actionCode === 10`、`const APPROVE = 1`
+  - ✅ `status === ReviewResultEnum.APPROVE`、`reviewType: ReviewTypeEnum.PRODUCER`
+- **常量也不够**：即便封装成 `const REVIEW_RESULT_APPROVE = 1` 这样的常量，**也不符合规范**，必须用 `enum`。
+- 枚举定义放在 `src/types/` 或 `src/constants/` 中，使用 PascalCase 命名，如 `ReviewResultEnum`、`ActionCodeEnum`。
+- 枚举上方必须用注释写清所有码值含义，例如 `/** 1-通过 2-驳回 */`，不依赖代码读者去猜。
+- 枚举对应的标签映射使用独立常量对象，如 `REVIEW_RESULT_LABELS`，不在模板中内联三元表达式显示文案。
+- **后端码值待确认时**：用 `⚠️ TODO(联调)` 注释标注，但仍然定义 enum 占位，不能用裸数字拖到联调时再改。
+- **review 必须阻断**：在代码中发现裸数字比较业务状态码（`=== 1`、`=== 2` 等）视为 P1 问题，必须拒绝合并。
+
+## `<script setup>` 内部书写顺序（强制）
+
+`<script setup>` 内部必须严格按以下顺序书写，**不得颠倒**：
+
+```
+1. import 语句
+2. defineProps / defineEmits / defineModel
+3. 常量、枚举引用（不可变的模块级常量）
+4. 按业务模块分组，每个模块内依次为 ref/reactive → computed → 函数
+   - 模块A（如：登录相关）：ref → computed → 函数
+   - 模块B（如：注册相关）：ref → computed → 函数
+   - ...
+5. watch / watchEffect（副作用监听）
+6. onMounted / onUnmounted 等生命周期钩子
+7. 接口请求初始化调用（setup 阶段直接触发，放在最末尾）
+```
+
+**规则细则：**
+
+- **按模块维度组织代码**：相关逻辑集中在一起（如登录相关放一起、注册相关放一起），而不是把所有 ref 拢在一起、所有 computed 拢在一起。每个模块内部保持 ref/reactive → computed → 函数的顺序。
+- **同一模块的响应式数据优先使用 `reactive` 合并到一个对象中**，而不是多个独立的 `ref`。这样同一业务领域的状态天然聚合，语义更清晰，也便于按模块整体传递或重置。
+- **接口请求优先在 setup 阶段直接触发**（即 `<script setup>` 顶层调用），而不是放在 `onMounted` 中。接口请求的初始化调用放在 script 最末尾，这样数据加载在 setup 阶段就开始，比等 `onMounted` 更早发起请求。
+- **禁止裸 `await`**：setup 顶层不允许 `await fetchXxx()`，因为 `<script setup>` 不支持顶层 await（除非配合 `<Suspense>`）。应调用不 await 的函数触发请求，或使用 `.then()` 处理。
+- `onMounted` / `onUnmounted` / `onBeforeUnmount` 等生命周期钩子放在 watch 之后、接口请求初始化之前，用于非 API 请求的初始化逻辑（如事件监听、DOM 操作等）。
+- `watch` / `watchEffect` 放在所有模块分组之后、生命周期钩子之前，不允许散落在 `ref` 或 `computed` 附近。
+
+**正确示例：**
+
+```ts
+// ✅ 正确：按模块分组，同模块数据用 reactive 合并，接口初始化在末尾
+// --- 模块：用户列表 ---
+const listState = reactive({
+  data: [] as UserInfo[],
+  loading: false,
+  total: 0,
+})
+
+async function fetchUserList() {
+  listState.loading = true
+  const res = await getUserListAPI()
+  listState.data = res.data.list
+  listState.total = res.data.total
+  listState.loading = false
+}
+
+// --- 模块：弹窗操作 ---
+const dialogState = reactive({
+  visible: false,
+  currentId: undefined as number | undefined,
+})
+
+function handleEdit(id: number) {
+  dialogState.currentId = id
+  dialogState.visible = true
+}
+
+// --- watch ---
+watch(() => props.id, fetchUserList)
+
+// --- 生命周期（非 API 初始化逻辑） ---
+onMounted(() => {
+  // 仅用于非 API 请求的初始化，如事件监听
+  window.addEventListener('resize', handleResize)
+})
+
+onUnmounted(() => {
+  window.removeEventListener('resize', handleResize)
+})
+
+// --- 接口请求初始化（setup 阶段，最末尾） ---
+fetchUserList()
+```
+
+```ts
+// ❌ 错误：接口请求放在 onMounted 里
+onMounted(() => {
+  fetchUserList() // 应直接在 setup 顶层调用
+})
+
+// ❌ 错误：同模块数据用多个独立 ref
+const userList = ref([]) // 应合并为 reactive 对象
+const loading = ref(false) // 同上
+const total = ref(0) // 同上
+
+// ❌ 错误：不按模块分组
+const userList = ref([])
+const dialogVisible = ref(false) // 弹窗状态和列表状态混在一起
+const loading = ref(false)
+```
+
+- **review 必须阻断**：发现接口请求初始化放在 `onMounted` 中（而非 setup 末尾直接调用）、或代码不按模块分组视为 P1 问题。
+
+## 表单校验规范（强制）
+
+- **优先使用 Element Plus Form 的 `rules` 进行校验**，而不是在提交时手动 `if` 判断或自定义校验函数散落各处。
+- 校验规则通过 `:rules` 绑定到 `el-form`，配合 `prop` 声明，利用 Element Plus 内置的异步校验和错误提示机制。
+- 需要自定义校验逻辑时，使用 `rules` 中的 `validator` 字段，而非绕过 Form 直接弹提示。
+
+**正确示例：**
+
+```ts
+// ✅ 使用 el-form rules 校验
+const rules = {
+  name: [{ required: true, message: '请输入名称', trigger: 'blur' }],
+  phone: [
+    { required: true, message: '请输入手机号', trigger: 'blur' },
+    { pattern: PHONE_REGEX, message: '手机号格式不正确', trigger: 'blur' },
+  ],
+}
+```
+
+```html
+<!-- ✅ 模板中绑定 rules + prop -->
+<el-form :model="form" :rules="rules" ref="formRef">
+  <el-form-item label="名称" prop="name">
+    <el-input v-model="form.name" />
+  </el-form-item>
+</el-form>
+```
+
+```ts
+// ❌ 错误：手动 if 校验，绕过 Form rules
+async function handleSubmit() {
+  if (!form.name) {
+    ElMessage.warning('请输入名称') // 禁止
+    return
+  }
+}
+```
+
+## 手机号校验规范
+
+- 手机号校验统一使用正则 `/^1\d{10}$/`（1 开头的 11 位数字），定义为模块级常量复用。
+- 该正则封装在项目公共位置（如 `src/utils/validators.ts` 或 `src/constants/`），各表单通过 import 引用，不在组件内重复定义。
+
+```ts
+// ✅ 常量定义（公共位置）
+/** 手机号正则：1 开头的 11 位数字 */
+export const PHONE_REGEX = /^1\d{10}$/
+
+// ✅ 在 Form rules 中使用
+import { PHONE_REGEX } from '@/constants/validators'
+
+const rules = {
+  phone: [
+    { required: true, message: '请输入手机号', trigger: 'blur' },
+    { pattern: PHONE_REGEX, message: '手机号格式不正确', trigger: 'blur' },
+  ],
+}
+```
+
+```ts
+// ❌ 错误：在组件内重复定义正则
+const phoneReg = /^1[3-9]\d{9}$/ // 禁止，应复用公共常量
+
+// ❌ 错误：手动 if 判断手机号
+if (!PHONE_REGEX.test(form.phone)) {
+  ElMessage.warning('手机号格式不正确') // 应通过 Form rules 校验
+  return
+}
+```
+
+## 列表页搜索规范
+
+- **列表页的搜索按钮必须重置 `pageNo = 1`**，避免在翻到第 N 页后搜索导致结果为空或数据错位。
+- 重置分页和发起请求统一放在搜索方法中，分页组件的 `current-change` 事件只负责翻页请求，不做搜索重置。
+
+```ts
+// ✅ 搜索按钮：重置页码后再请求
+const queryParams = reactive({ pageNo: 1, pageSize: 10, keyword: '' })
+
+function handleSearch() {
+  queryParams.pageNo = 1 // 必须重置
+  fetchList()
+}
+
+function handlePageChange(page: number) {
+  queryParams.pageNo = page
+  fetchList()
+}
+```
+
+```ts
+// ❌ 错误：搜索时未重置页码
+function handleSearch() {
+  // 缺少 queryParams.pageNo = 1，翻到第 3 页搜索会请求 pageNo=3
+  fetchList()
+}
+```

package/templates/harness/full/.claude/settings.json

@@ -0,0 +1,123 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "permissions": {
+    "allow": [
+      "Read",
+      "Glob",
+      "Grep",
+      "Bash(git status*)",
+      "Bash(git diff*)",
+      "Bash(git log*)",
+      "Bash(git show*)",
+      "Bash(pnpm *)",
+      "Bash(node *)"
+    ],
+    "deny": [
+      "Read(.env*)",
+      "Read(**/.env*)",
+      "Read(secrets/**)",
+      "Read(**/secrets/**)",
+      "Read(*.pem)",
+      "Read(**/*.pem)",
+      "Read(*.key)",
+      "Read(**/*.key)",
+      "Read(**/*.p12)",
+      "Read(**/*.pfx)",
+      "Read(**/*.crt)",
+      "Read(**/*.cer)",
+      "Write(.env*)",
+      "Write(**/.env*)",
+      "Write(secrets/**)",
+      "Write(**/secrets/**)",
+      "Write(*.pem)",
+      "Write(**/*.pem)",
+      "Write(*.key)",
+      "Write(**/*.key)",
+      "Write(**/*.p12)",
+      "Write(**/*.pfx)",
+      "Write(**/*.crt)",
+      "Write(**/*.cer)",
+      "Bash(git reset --hard*)",
+      "Bash(git push --force*)",
+      "Bash(git branch -D*)",
+      "Bash(git stash drop*)",
+      "Bash(git stash clear*)",
+      "Bash(git checkout --*)",
+      "Bash(git restore *)",
+      "Bash(git clean -fd*)",
+      "Bash(rm -rf*)",
+      "Bash(dd *)",
+      "Bash(git commit*)"
+    ]
+  },
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash|Read|Write|Edit|MultiEdit|Grep|Agent",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .claude/hooks/guard-tool.cjs",
+            "timeout": 10,
+            "statusMessage": "Harness 安全守护"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .claude/hooks/quality-gate.cjs stop",
+            "timeout": 300,
+            "statusMessage": "运行 harness 质量门禁"
+          }
+        ]
+      },
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "agent",
+            "prompt": "你是强制 AI harness 代码审查子 agent。审查前先运行 `git diff --name-only` 查看本次改动了哪些文件。若任一改动文件匹配 `.claude/**`、`.agents/**`、`.husky/**`、`scripts/verify-skills.mjs`、`scripts/sync-harness-docs.mjs`、`scripts/check-project-structure.mjs`、`scripts/*.test.mjs`、`skills-lock.json`、`package.json`、`CLAUDE.md`、`AGENTS.md`、`GEMINI.md`、`CONTRIBUTING.md`、`docs/ai-harness.md`、`docs/harness-quick-reference.md`、`docs/delivery-template.md`、`docs/review-checklist.md` 或 `docs/verification.md`，就读取 `.claude/agents/harness-reviewer.md` 并严格按其规则审查；否则读取 `.claude/agents/code-reviewer.md` 并严格按其规则审查。不要编辑任何文件。只返回 JSON：{\"ok\":true|false,\"reason\":\"HARNESS_REVIEW_RESULT: PASS|FAIL\\n简短总结。\"}。并提醒用户：Claude 审查不能替代人工最终复核。",
+            "timeout": 300,
+            "statusMessage": "运行强制代码审查"
+          }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .claude/hooks/notify.cjs subagent-stop",
+            "timeout": 20,
+            "statusMessage": "发送审查完成通知"
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .claude/hooks/notify.cjs notification",
+            "timeout": 20,
+            "statusMessage": "发送系统通知"
+          }
+        ]
+      }
+    ]
+  },
+  "enabledPlugins": {
+    "context7@claude-plugins-official": true,
+    "superpowers@claude-plugins-official": true
+  },
+  "disableBypassPermissionsMode": "disable"
+}

package/templates/harness/full/.claude/skills/find-skills/SKILL.md

@@ -0,0 +1,143 @@
+---
+name: find-skills
+description: Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
+---
+
+# Find Skills
+
+This skill helps you discover and install skills from the open agent skills ecosystem.
+
+## When to Use This Skill
+
+Use this skill when the user:
+
+- Asks "how do I do X" where X might be a common task with an existing skill
+- Says "find a skill for X" or "is there a skill for X"
+- Asks "can you do X" where X is a specialized capability
+- Expresses interest in extending agent capabilities
+- Wants to search for tools, templates, or workflows
+- Mentions they wish they had help with a specific domain (design, testing, deployment, etc.)
+
+## What is the Skills CLI?
+
+The Skills CLI (`npx skills`) is the package manager for the open agent skills ecosystem. Skills are modular packages that extend agent capabilities with specialized knowledge, workflows, and tools.
+
+**Key commands:**
+
+- `npx skills find [query]` - Search for skills interactively or by keyword
+- `npx skills add <package>` - Install a skill from GitHub or other sources
+- `npx skills check` - Check for skill updates
+- `npx skills update` - Update all installed skills
+
+**Browse skills at:** https://skills.sh/
+
+## How to Help Users Find Skills
+
+### Step 1: Understand What They Need
+
+When a user asks for help with something, identify:
+
+1. The domain (e.g., React, testing, design, deployment)
+2. The specific task (e.g., writing tests, creating animations, reviewing PRs)
+3. Whether this is a common enough task that a skill likely exists
+
+### Step 2: Check the Leaderboard First
+
+Before running a CLI search, check the [skills.sh leaderboard](https://skills.sh/) to see if a well-known skill already exists for the domain. The leaderboard ranks skills by total installs, surfacing the most popular and battle-tested options.
+
+For example, top skills for web development include:
+
+- `vercel-labs/agent-skills` — React, Next.js, web design (100K+ installs each)
+- `anthropics/skills` — Frontend design, document processing (100K+ installs)
+
+### Step 3: Search for Skills
+
+If the leaderboard doesn't cover the user's need, run the find command:
+
+```bash
+npx skills find [query]
+```
+
+For example:
+
+- User asks "how do I make my React app faster?" → `npx skills find react performance`
+- User asks "can you help me with PR reviews?" → `npx skills find pr review`
+- User asks "I need to create a changelog" → `npx skills find changelog`
+
+### Step 4: Verify Quality Before Recommending
+
+**Do not recommend a skill based solely on search results.** Always verify:
+
+1. **Install count** — Prefer skills with 1K+ installs. Be cautious with anything under 100.
+2. **Source reputation** — Official sources (`vercel-labs`, `anthropics`, `microsoft`) are more trustworthy than unknown authors.
+3. **GitHub stars** — Check the source repository. A skill from a repo with <100 stars should be treated with skepticism.
+
+### Step 5: Present Options to the User
+
+When you find relevant skills, present them to the user with:
+
+1. The skill name and what it does
+2. The install count and source
+3. The install command they can run
+4. A link to learn more at skills.sh
+
+Example response:
+
+```
+I found a skill that might help! The "react-best-practices" skill provides
+React and Next.js performance optimization guidelines from Vercel Engineering.
+(185K installs)
+
+To install it:
+npx skills add vercel-labs/agent-skills@react-best-practices
+
+Learn more: https://skills.sh/vercel-labs/agent-skills/react-best-practices
+```
+
+### Step 6: Offer to Install
+
+If the user wants to proceed, you can install the skill for them:
+
+```bash
+npx skills add <owner/repo@skill> -g -y
+```
+
+The `-g` flag installs globally (user-level) and `-y` skips confirmation prompts.
+
+## Common Skill Categories
+
+When searching, consider these common categories:
+
+| Category        | Example Queries                          |
+| --------------- | ---------------------------------------- |
+| Web Development | react, nextjs, typescript, css, tailwind |
+| Testing         | testing, jest, playwright, e2e           |
+| DevOps          | deploy, docker, kubernetes, ci-cd        |
+| Documentation   | docs, readme, changelog, api-docs        |
+| Code Quality    | review, lint, refactor, best-practices   |
+| Design          | ui, ux, design-system, accessibility     |
+| Productivity    | workflow, automation, git                |
+
+## Tips for Effective Searches
+
+1. **Use specific keywords**: "react testing" is better than just "testing"
+2. **Try alternative terms**: If "deploy" doesn't work, try "deployment" or "ci-cd"
+3. **Check popular sources**: Many skills come from `vercel-labs/agent-skills` or `ComposioHQ/awesome-claude-skills`
+
+## When No Skills Are Found
+
+If no relevant skills exist:
+
+1. Acknowledge that no existing skill was found
+2. Offer to help with the task directly using your general capabilities
+3. Suggest the user could create their own skill with `npx skills init`
+
+Example:
+
+```
+I searched for skills related to "xyz" but didn't find any matches.
+I can still help you with this task directly! Would you like me to proceed?
+
+If this is something you do often, you could create your own skill:
+npx skills init my-xyz-skill
+```

package/templates/harness/full/.claude/skills/vue-best-practices/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 hyf0, SerKo <https://github.com/serkodev>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.