@dianzhong/create-harness-app 0.1.4 → 0.2.0

package/dist/index.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import path7 from "path";
-import fse2 from "fs-extra";
+import path8 from "path";
+import fse4 from "fs-extra";
 import { outro } from "@clack/prompts";
 
 // src/prompts.ts
@@ -15,7 +15,8 @@ function defaultConfig(projectName) {
     vitest: false,
     uiLibrary: "element-plus",
     axios: true,
-    harness: "full"
+    harness: "full",
+    openspec: true
   };
 }
 function check(val) {
@@ -52,7 +53,8 @@ async function collectConfig(initialName) {
       { value: "none", label: "\u4E0D\u96C6\u6210" }
     ]
   }));
-  return { projectName, router, pinia, vitest, uiLibrary, axios, harness };
+  const openspec = check(await confirm({ message: "\u542F\u7528 OpenSpec \u4E1A\u52A1\u89C4\u683C\u7BA1\u7406\uFF1F", initialValue: true }));
+  return { projectName, router, pinia, vitest, uiLibrary, axios, harness, openspec };
 }
 
 // src/spawn-create-vue.ts
@@ -73,7 +75,8 @@ async function spawnCreateVue(config, parentDir) {
 }
 
 // src/overlay.ts
-import path6 from "path";
+import path7 from "path";
+import fse3 from "fs-extra";
 
 // src/utils/fs.ts
 import fse from "fs-extra";
@@ -289,9 +292,11 @@ var HARNESS_FULL_PKG = {
     "husky": "^9.1.7"
   },
   scripts: {
+    "prepare": "husky",
     "harness:sync": "node scripts/verify-skills.mjs --write",
     "harness:check": "node scripts/verify-skills.mjs && node scripts/harness-hooks.test.mjs",
     "harness:test": "node scripts/harness-hooks.test.mjs && node scripts/verify-skills.test.mjs",
+    "check:fix": "pnpm format && pnpm lint",
     "check": "pnpm type-check && pnpm lint && pnpm format:check && pnpm harness:check"
   }
 };
@@ -305,9 +310,48 @@ async function overlayHarness(projectRoot, level) {
   await copyDir(path5.join(TEMPLATES_DIR2, "harness", level), projectRoot);
 }
 
+// src/features/openspec.ts
+import path6 from "path";
+import { fileURLToPath as fileURLToPath3 } from "url";
+import fse2 from "fs-extra";
+import { execa as execa2 } from "execa";
+var TEMPLATES_DIR3 = fileURLToPath3(new URL("../templates", import.meta.url));
+var OPENSPEC_PKG = {
+  devDependencies: {
+    "@fission-ai/openspec": "^1.4.1"
+  },
+  scripts: {
+    "openspec:validate": "openspec validate --all --no-interactive",
+    "openspec:list": "openspec list"
+  }
+};
+async function overlayOpenSpec(projectRoot) {
+  await execa2("npx", ["--yes", "@fission-ai/openspec@latest", "init", "--tools", "claude"], {
+    cwd: projectRoot,
+    stdio: "inherit"
+  });
+  const verifyScript = path6.join(projectRoot, "scripts/verify-skills.mjs");
+  if (await fse2.pathExists(verifyScript)) {
+    await execa2("node", ["scripts/verify-skills.mjs", "--write"], { cwd: projectRoot });
+  }
+  await copyDir(path6.join(TEMPLATES_DIR3, "openspec"), projectRoot);
+}
+
 // src/overlay.ts
+var UI_LABEL = {
+  "element-plus": "Element Plus",
+  "ant-design-vue": "Ant Design Vue",
+  "none": "\uFF08\u672A\u96C6\u6210 UI \u5E93\uFF0C\u8BF7\u81EA\u884C\u914D\u7F6E\uFF09"
+};
+async function fillClaudeMdUiPlaceholder(projectRoot, config) {
+  const claudePath = path7.join(projectRoot, "CLAUDE.md");
+  if (!await fse3.pathExists(claudePath)) return;
+  const content = await readText(claudePath);
+  if (!content.includes("[\u5728\u6B64\u586B\u5199 UI \u5E93]")) return;
+  await writeText(claudePath, content.replaceAll("[\u5728\u6B64\u586B\u5199 UI \u5E93]", UI_LABEL[config.uiLibrary]));
+}
 async function overlay(projectRoot, config) {
-  const pkgPath = path6.join(projectRoot, "package.json");
+  const pkgPath = path7.join(projectRoot, "package.json");
   let pkg = await readJson(pkgPath);
   const add = { dependencies: {}, devDependencies: {}, scripts: {} };
   const merge = (src) => {
@@ -329,11 +373,19 @@ async function overlay(projectRoot, config) {
   if (config.harness !== "none") {
     await overlayHarness(projectRoot, config.harness);
     merge(config.harness === "full" ? HARNESS_FULL_PKG : HARNESS_MINIMAL_PKG);
+    await fillClaudeMdUiPlaceholder(projectRoot, config);
     const existingScripts = pkg.scripts ?? {};
     if (existingScripts.format?.includes("--write") && !existingScripts["format:check"]) {
       add.scripts["format:check"] = existingScripts.format.replace("--write", "--check");
     }
   }
+  if (config.openspec) {
+    await overlayOpenSpec(projectRoot);
+    merge(OPENSPEC_PKG);
+    if (add.scripts.check) {
+      add.scripts.check = `${add.scripts.check} && pnpm openspec:validate`;
+    }
+  }
   pkg = mergePackageJson(pkg, add);
   await writeJson(pkgPath, pkg);
 }
@@ -353,6 +405,7 @@ function parseArgs(argv) {
     uiLibrary: argv.find((a) => a.startsWith("--ui="))?.split("=")[1],
     harness: argv.find((a) => a.startsWith("--harness="))?.split("=")[1],
     noAxios: argv.includes("--no-axios"),
+    noOpenspec: argv.includes("--no-openspec"),
     vitest: argv.includes("--vitest")
   };
 }
@@ -362,17 +415,18 @@ async function main() {
     log(`Usage: create-harness-app [project-name] [options]
 
 Options:
-  --yes              Non-interactive: TS + Router + Pinia + ElementPlus + axios + harness:full
+  --yes              Non-interactive: TS + Router + Pinia + ElementPlus + axios + harness:full + OpenSpec
   --ui=<lib>         element-plus | ant-design-vue | none  (default: element-plus)
   --harness=<level>  full | minimal | none                 (default: full)
   --no-axios         Skip axios layer
+  --no-openspec      Skip OpenSpec spec management
   --vitest           Enable Vitest
   -h, --help         Show this help
 
 Examples:
   npm create @dianzhong/harness-app my-app
   npm create @dianzhong/harness-app my-app -- --yes
-  npm create @dianzhong/harness-app my-app -- --ui=ant-design-vue --harness=minimal
+  npm create @dianzhong/harness-app my-app -- --ui=ant-design-vue --harness=minimal --no-openspec
 `);
     process.exit(0);
   }
@@ -384,22 +438,23 @@ Examples:
       uiLibrary: args.uiLibrary ?? base.uiLibrary,
       harness: args.harness ?? base.harness,
       axios: !args.noAxios,
+      openspec: !args.noOpenspec,
       vitest: args.vitest
     };
-    info(`\u975E\u4EA4\u4E92\u6A21\u5F0F: ${config.projectName} | UI=${config.uiLibrary} | harness=${config.harness}`);
+    info(`\u975E\u4EA4\u4E92\u6A21\u5F0F: ${config.projectName} | UI=${config.uiLibrary} | harness=${config.harness} | openspec=${config.openspec}`);
   } else {
     config = await collectConfig(args.projectName);
   }
-  const targetDir = path7.resolve(process.cwd(), config.projectName);
-  if (await fse2.pathExists(targetDir)) {
-    const entries = await fse2.readdir(targetDir);
+  const targetDir = path8.resolve(process.cwd(), config.projectName);
+  if (await fse4.pathExists(targetDir)) {
+    const entries = await fse4.readdir(targetDir);
     if (entries.length > 0) {
       error(`\u76EE\u5F55 "${config.projectName}" \u5DF2\u5B58\u5728\u4E14\u4E0D\u4E3A\u7A7A`);
       process.exit(1);
     }
   }
   info("\u4F7F\u7528 create-vue \u751F\u6210\u57FA\u7840\u9AA8\u67B6...");
-  await spawnCreateVue(config, path7.dirname(targetDir));
+  await spawnCreateVue(config, path8.dirname(targetDir));
   info("\u53E0\u52A0 features...");
   await overlay(targetDir, config);
   success("\u9879\u76EE\u521D\u59CB\u5316\u5B8C\u6210\uFF01");
@@ -409,6 +464,7 @@ Examples:
   log("  pnpm install");
   if (config.harness === "full") log("  pnpm harness:sync   # \u91CD\u7B97 skills \u6307\u7EB9");
   log("  pnpm dev\n");
+  if (config.openspec) log('  OpenSpec \u5DF2\u5C31\u7EEA\uFF1A\u5728 Claude Code \u91CC\u7528 /opsx:propose "\u4F60\u7684\u9700\u6C42" \u5F00\u59CB\u7B2C\u4E00\u4E2A\u53D8\u66F4\n');
 }
 main().catch((err) => {
   error(String(err.message ?? err));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dianzhong/create-harness-app",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "点众前端项目初始化器：封装 create-vue，叠加 UI 库、axios 层与 AI Harness 治理体系",
   "type": "module",
   "bin": {

package/templates/harness/full/.claude/agents/harness-reviewer.md

@@ -20,7 +20,6 @@ tools: Read, Glob, Grep, Bash
 - `docs/review-checklist.md`
 - `docs/verification.md`
 - `skills-lock.json`
-- `scripts/check-project-structure.mjs`
 - `scripts/*.test.mjs`
 - `package.json` scripts 和 `.husky/*`
 
@@ -32,7 +31,6 @@ tools: Read, Glob, Grep, Bash
 - 完成通知必须兼容 macOS 和 Windows，并在失败时安全降级。
 - skills 必须同步 lock hash（`skills-lock.json` 中每个 skill 的 `computedHash` 必须与当前文件内容一致）。
 - harness 脚本的测试必须接入 `pnpm harness:check`，不能只放测试文件。
-- 结构检查必须只约束通用工程护栏，不得固化当前占位业务流程或 mock 数据。
 - harness 配置以源文件为准，不维护额外 generated config inventory。
 - 敏感文件和危险命令必须被拒绝。
 - 人工审核交付要求必须在入口文档、速查表、review checklist、delivery template 和 reviewer 规则中保持一致。

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

@@ -81,7 +81,7 @@
         "hooks": [
           {
             "type": "agent",
-            "prompt": "你是强制 AI harness 代码审查子 agent。审查前先运行 `git diff --name-only` 查看本次改动了哪些文件。若任一改动文件匹配 `.claude/**`、`.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`、`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 审查不能替代人工最终复核。",
+            "prompt": "你是强制 AI harness 代码审查子 agent。审查前先运行 `git diff --name-only` 查看本次改动了哪些文件。若任一改动文件匹配 `.claude/**`、`.husky/**`、`scripts/verify-skills.mjs`、`scripts/*.test.mjs`、`skills-lock.json`、`package.json`、`CLAUDE.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": "运行强制代码审查"
           }

package/templates/harness/full/docs/ai-harness.md

@@ -20,12 +20,9 @@
 - `.claude/rules/*.md`：可按任务加载的细分规则。
 - `.claude/skills/`：Claude Code 项目 skills 源。
 - `scripts/verify-skills.mjs`：校验 skills 文档和 lock 是否同步。
-- `scripts/sync-harness-docs.mjs`：校验 harness 文档入口是否完整、是否仍引用废弃清单。
-- `scripts/check-project-structure.mjs`：校验通用前端结构护栏，不固化当前占位业务。
 - `scripts/*.test.mjs`：校验 harness 脚本自身行为，防止门禁脚本静默漂移。
 - `docs/harness-quick-reference.md`：给团队和 AI agent 使用的速查表。
 - `docs/delivery-template.md`：AI 交付说明模板，要求每次交付暴露改动、影响范围、验证、人工复核项、人工决策和剩余风险。
-- `openspec/`：业务规格事实源；`specs/` 保存当前有效规格，`changes/` 保存 PRD 或口头需求变更。
 
 ## 事实来源
 
@@ -36,14 +33,13 @@
 - Review agent 定义以 `.claude/agents/*.md` 为准；`.claude/settings.json` 中的 Stop agent 内联 prompt 是当前强制 review 入口。
 - Rules 以 `.claude/rules/*.md` 为准。
 - Skills 以 `.claude/skills/` 为源，`skills-lock.json` 保存校验 hash。
-- 业务规格以 OpenSpec 的 `openspec/specs/` 为准；待确认或待实现的业务变更以 `openspec/changes/<change-id>/` 为准。
 - 人工审核交付格式以 `docs/delivery-template.md` 为准。
 
 ## 执行流程
 
 1. 主 agent 探索代码和规则。
 2. 主 agent 实现变更。
-3. `Stop` hook 先运行 `pnpm format` 自动修复格式，再运行 `pnpm type-check`、`pnpm lint`、`pnpm harness:check`。注意：Stop hook 有意省略 `openspec:check`（该检查较慢，且仅在业务规格变更时有意义）；完整检查请手动运行 `pnpm check`。
+3. `Stop` hook 先运行 `pnpm format` 自动修复格式，再运行 `pnpm type-check`、`pnpm lint`、`pnpm harness:check`。完整检查请手动运行 `pnpm check`。
 4. `Stop` agent hook 启动 review subagent。
 5. review subagent 返回 `HARNESS_REVIEW_RESULT: PASS` 或 `HARNESS_REVIEW_RESULT: FAIL`。
 6. 通过后发送系统通知；失败时阻止停止并要求主 agent 修复。
@@ -56,9 +52,8 @@
 - `pnpm lint`：oxlint + ESLint。
 - `pnpm format:check`：校验 Prettier 格式一致性。
 - `pnpm check:fix`：显式执行格式化与 lint 自动修复。
-- `pnpm harness:structure`：通用前端结构护栏检查，覆盖 route meta 基础约束、动态菜单组件解析、明显第二套菜单/权限源和高风险 Element Plus 深层覆盖提示。
-- `pnpm harness:test`：运行 harness 脚本测试，覆盖结构检查、skill 校验和 hooks 基础行为。
-- `pnpm harness:check`：skills、docs、lock、入口文档、项目结构护栏和 harness 脚本测试。
+- `pnpm harness:test`：运行 harness 脚本测试，覆盖 skill 校验和 hooks 基础行为。
+- `pnpm harness:check`：skills、lock 校验和 hooks 脚本测试。
 - `pnpm build`：生产构建校验，适用于构建配置、路由、样式或依赖变更。
 
 ## 维护规则
@@ -69,7 +64,5 @@
 - 修改 harness 配置后，先运行 `pnpm harness:sync` 再运行 `pnpm harness:check`。
 - 修改人工审核流程或交付要求时，同步 `docs/review-checklist.md` 和 `docs/delivery-template.md`。
 - 当前业务代码是占位实现，不允许把项目看板、审核流、mock 数据或临时页面形态沉淀为 harness 规则或工程规范。
-- 业务规格（页面布局、字段口径、状态机、角色权限矩阵、接口契约等）统一放在 OpenSpec。当前有效规格沉淀到 `openspec/specs/`；PRD 链接、钉钉文档更新或口头需求变更先建 `openspec/changes/<change-id>/`，明确来源、影响页面、接口影响、验收标准和待确认问题。
-- OpenSpec 不自动进入 Claude Code 默认上下文，由 AI 按任务需要主动 view。harness 文档（本文件、`docs/harness-quick-reference.md`、`.claude/rules/*`、`CLAUDE.md`）只引用 OpenSpec 入口，不复制业务内容。
 - 反复使用的业务规则（全局权限矩阵、跨页面状态机）应做成 `.claude/skills/<name>/`，由 AI 按需加载。
 - `quality-gate.cjs stop` 是唯一允许自动格式化的 hook，用于 Stop 收尾；其他 hooks 不得自动格式化、暂存或改写 repo-tracked 文件。`lint-staged` 作为 pre-commit safety net 是另一处显式例外。

package/templates/harness/full/docs/delivery-template.md

@@ -63,4 +63,4 @@ AI 已验证：
 - ...
 ```
 
-如果人工确认某条复杂业务规则是长期规则，后续应沉淀到 OpenSpec 规格、类型、测试或代码约束中，而不是只留在聊天记录里。
+如果人工确认某条复杂业务规则是长期规则，后续应沉淀到规格文档、类型、测试或代码约束中，而不是只留在聊天记录里。

package/templates/harness/full/docs/harness-quick-reference.md

@@ -7,9 +7,6 @@
 | 场景                                      | 优先使用                  | 说明                                                           |
 | ----------------------------------------- | ------------------------- | -------------------------------------------------------------- |
 | Vue、Vite、Pinia、Vue Router、`.vue` 组件 | `vue-best-practices`      | 先确认 Composition API、组件边界、响应式数据和类型规则。       |
-| Element Plus 表单、表格、弹窗、主题覆盖   | `element-plus-vue3`       | 先查组件用法、props/events、主题和按需导入规则。               |
-| 页面视觉优化、组件美化、前端交互体验      | `frontend-design`         | 用于提高 UI 质量，但必须服从项目样式规则和 Element Plus 约束。 |
-| 路由、权限、菜单来源、布局、全局样式      | `project-structure-guard` | 避免破坏后端菜单树动态路由模型和前端结构护栏。                 |
 | 不确定是否已有合适 skill                  | `find-skills`             | 先查可用 skill，再决定是否安装或创建项目内 skill。             |
 
 Harness 配置、hooks、review agents、skills 同步和治理文档变更没有专用 skill；先读 `docs/ai-harness.md` 和 `.claude/agents/harness-reviewer.md`。
@@ -29,7 +26,7 @@ Harness 配置、hooks、review agents、skills 同步和治理文档变更没
 | Hook               | 作用                                                                                                                |
 | ------------------ | ------------------------------------------------------------------------------------------------------------------- |
 | `guard-tool.cjs`   | 阻断危险命令和敏感文件访问。                                                                                        |
-| `quality-gate.cjs` | Stop 时先自动格式化，再运行 type-check / lint / harness:check（有意省略 openspec:check，完整检查用 `pnpm check`）。 |
+| `quality-gate.cjs` | Stop 时先自动格式化，再运行 type-check / lint / harness:check；完整检查用 `pnpm check`。 |
 | `notify.cjs`       | 处理 macOS/Windows 完成通知和失败通知。                                                                             |
 
 详细行为见 `docs/ai-harness.md`。
@@ -50,25 +47,15 @@ pnpm check:fix     # 格式化 + lint 修复
 pnpm format        # 全量格式化
 pnpm format:check  # 只检查
 pnpm check:fix     # 格式化 + lint 修复
-pnpm check         # 完整质量门禁（type-check + lint + format:check + openspec:check + harness:check）
+pnpm check         # 完整质量门禁（type-check + lint + format:check + harness:check）
 pnpm build         # 生产构建校验
-pnpm openspec:check  # 校验 OpenSpec specs/changes
-pnpm openspec:list   # 列出 OpenSpec 变更
-pnpm openspec:specs  # 列出 OpenSpec 当前规格
 pnpm harness:sync  # 同步 skill lock
 pnpm harness:check # harness 脚本验证
-pnpm harness:structure  # 项目结构护栏检查
 pnpm harness:test  # harness 脚本测试
 ```
 
 详细格式化规则见 `.claude/rules/formatting.md`。
 
-## OpenSpec 业务规格
-
-产品 PRD、钉钉文档链接和口头需求都是原始输入；可执行的业务规格事实源是 OpenSpec。当前有效规格放在 `openspec/specs/`，每次 PRD 更新或口头变更先建 `openspec/changes/<change-id>/`，再进入代码实现。
-
-OpenSpec 只管理业务规格和需求变更；Harness 继续管理 AI 执行规则、hooks、skills、review 和质量门禁。不要把页面业务规则复制进 harness 文档，也不要用 OpenSpec 替代 `pnpm check`、review 或人工复核。
-
 ## 本地浏览器验证
 
 涉及新页面、UI 调整、路由权限、表单、弹窗、上传、布局或全局样式时，按 `docs/verification.md` 做本地浏览器验证。纯文档、纯脚本、无运行时 UI 影响的 harness 变更可以不做浏览器验证，但交付说明中要说明原因。

package/templates/harness/full/docs/review-checklist.md

@@ -39,7 +39,7 @@ Claude Code 完成任务后，提交前必须由人做最终复核。AI 的职
 5. 重新验证：运行对应检查，必要时重新做浏览器验证。
 6. 二次交接：输出第二版交接单，说明修了什么、哪些决策已确认、还剩什么风险。
 
-如果人工确认某条复杂业务规则是长期规则，应要求 AI 后续沉淀到 OpenSpec 规格、类型、测试或代码约束中，而不是只留在聊天记录里。
+如果人工确认某条复杂业务规则是长期规则，应要求 AI 后续沉淀到规格文档、类型、测试或代码约束中，而不是只留在聊天记录里。
 
 ## 验证记录
 

package/templates/harness/full/docs/verification.md

@@ -0,0 +1,35 @@
+# 本地浏览器验证
+
+涉及可见行为的改动，提交前必须在本地浏览器实际跑一遍，不能只靠类型检查和 lint。本文件定义何时验证、验证什么、以及如何在交付说明里记录。
+
+## 何时必须做浏览器验证
+
+出现以下任一情况时必须验证：
+
+- 新增或修改页面、路由。
+- 路由权限、菜单可见性、登录态相关改动。
+- 表单（校验、提交、重置）、弹窗（打开/关闭/数据加载）、上传。
+- 列表（分页、搜索、筛选）、表格交互。
+- 全局样式、布局、主题覆盖。
+
+纯文档、纯脚本、无运行时 UI 影响的 harness 变更可以不做浏览器验证，但要在交付说明中说明原因。
+
+## 验证什么
+
+- **功能正确**：操作路径走通，数据正确加载和提交，错误提示符合预期。
+- **路由与权限**：目标页面可达，无权限时正确拦截，刷新后状态保持。
+- **表单校验**：必填、格式（如手机号）、边界值都触发预期校验。
+- **弹窗生命周期**：打开重新挂载、关闭销毁、成功后通知父组件刷新。
+- **控制台**：无报错、无未捕获 Promise reject、无关键 warning。
+
+## 如何记录
+
+在交付说明（见 `docs/delivery-template.md`）的「AI 已验证 / 需要人工复核」中写清：
+
+- 验证方式（手动点击 / 截图 / 录屏）。
+- 使用的账号或角色、页面路径、数据条件。
+- 实际看到的结果。
+
+如果某些场景未验证（环境受限、缺测试数据、依赖后端联调等），必须在「剩余风险」中明确列出未验证项，不能默认通过。
+
+> 强制 review 通过不代表 UI 已验证。可见行为的最终确认由人工浏览器复核完成。

package/templates/harness/full/scripts/verify-skills.mjs

@@ -21,18 +21,10 @@ const lockPath = path.join(root, 'skills-lock.json')
 const writeMode = process.argv.includes('--write')
 
 const defaultSources = {
-  'element-plus-vue3': {
-    source: 'partme-ai/full-stack-skills',
-    sourceType: 'github',
-  },
   'find-skills': {
     source: 'anthropics/skills',
     sourceType: 'github',
   },
-  'frontend-design': {
-    source: 'anthropics/claude-code',
-    sourceType: 'github',
-  },
   'vue-best-practices': {
     source: 'moeru-ai/airi',
     sourceType: 'github',

package/templates/openspec/docs/openspec.md

@@ -0,0 +1,34 @@
+# OpenSpec 业务规格
+
+本项目用 [OpenSpec](https://github.com/Fission-AI/OpenSpec) 管理业务规格：产品 PRD、钉钉文档、口头需求都是原始输入，可执行的事实源是 `openspec/`。
+
+## 目录
+
+- `openspec/specs/`：当前已生效的业务规格（事实源）。
+- `openspec/changes/`：进行中的变更提案；每个变更一个目录（proposal、tasks、受影响的 specs）。
+- `openspec/changes/archive/`：已完成并归档的变更。
+
+## 工作流（通过 Claude Code 斜杠命令驱动）
+
+1. `/opsx:propose "需求描述"` — 基于需求生成变更提案（proposal + 受影响 specs + tasks）。
+2. `/opsx:apply` — 按提案的 tasks 实现代码。
+3. `/opsx:archive` — 变更完成后，把它合并进 `openspec/specs/` 并归档。
+
+辅助命令：`/opsx:explore`（探索现有规格）、`/opsx:sync`（同步 specs）。
+
+## 命令行
+
+```sh
+pnpm openspec:list       # 列出当前变更
+pnpm openspec:validate   # 校验所有 specs 和 changes（pnpm check 也会跑）
+```
+
+## 与 Harness 的分工
+
+- OpenSpec 只管**业务规格和需求变更**（页面布局、字段口径、状态机、角色权限矩阵、接口契约）。
+- Harness 继续管 **AI 执行规则、hooks、skills、review 和质量门禁**。
+- 不要把业务规则复制进 harness 文档；也不要用 OpenSpec 替代 `pnpm check`、code review 或人工复核。
+
+## 何时用
+
+新增页面/接口、改业务流程、调整权限模型前，先在 OpenSpec 建变更，明确来源、影响范围、验收标准和待确认问题，再进入代码实现。纯样式微调、bug 修复等无规格影响的改动可不走 OpenSpec。