persagy-vant 0.0.31 → 0.0.32

package/README.md

@@ -4,25 +4,24 @@ Persagy 移动端 Vue 3 组件库。产品经理可通过 AI 编程工具复用
 
 ## 产品经理使用方式
 
-只使用这一条流程：在**自己的产品项目**安装组件库，再让 AI 读取包内的 Skill。无需下载或复制本仓库。
+只使用这一条流程：在**自己的产品项目**安装组件库、初始化一次 Codex Skill，然后直接调用 `$use-persagy-vant`。无需下载或复制本仓库。
 
 ### 1. 安装组件库
 
 ```bash
 pnpm add persagy-vant
+pnpm exec persagy-vant init
 ```
 
-### 2. 每次新开 AI 会话先发送统一指令
+初始化会在项目中创建 `.agents/skills/use-persagy-vant/SKILL.md`。它只引用 npm 包内的 Skill 内容，因此不会复制规范或造成版本分叉。
 
-```text
-请先读取并严格执行 node_modules/persagy-vant/skills/use-persagy-vant/SKILL.md。
+### 2. 直接在 Codex 中调用
 
-本项目所有移动端 UI 和业务选择能力必须优先复用 persagy-vant；
-不要自行实现组件库已有的组件、交互或样式。
-实现前先阅读所用组件在 node_modules/persagy-vant/es/<组件名>/README.zh-CN.md 中的 API 和示例。
+```text
+$use-persagy-vant 根据当前 PRD 实现移动端页面
 ```
 
-这套方式兼容 Codex、Cursor、Claude Code、Windsurf、Copilot 等可读取项目文件的 AI 编程工具。
+Skill 会自动读取 npm 包内的复用规则、组件目录、设计交互规范与组件 API 文档。
 
 ### 3. 描述本次任务
 
@@ -35,10 +34,10 @@ pnpm add persagy-vant
 组件库发布新版本后，在产品项目根目录执行：
 
 ```bash
-pnpm up persagy-vant
+pnpm up persagy-vant@latest
 ```
 
-然后在下一次 AI 会话重新发送“统一指令”。组件、组件文档和 Skill 会随 npm 包一起更新。
+组件、组件文档和 Skill 会随 npm 包一起更新；已有的 `.agents` 入口会自动读取新版内容，无需再次初始化。仅当维护者通知入口机制有变时，才执行 `pnpm exec persagy-vant init --force`。
 
 完整的可转发说明见：[产品经理 AI 开发使用说明](./docs/markdown/product-manager-guide.zh-CN.md)。
 
@@ -47,8 +46,8 @@ pnpm up persagy-vant
 ```text
 src/       组件源码、单组件示例、测试与中英文 API 文档
 docs/      组件站点与设计文档
-skills/    随 npm 包分发的 AI Skill
-scripts/   构建辅助脚本
+skills/    随 npm 包分发的 AI Skill 正文与参考资料
+bin/       初始化项目级 Codex Skill 的命令
 ```
 
 ## 开发

package/bin/persagy-vant.mjs

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, relative, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const skillSource = resolve(packageRoot, 'skills/use-persagy-vant/SKILL.md');
+const [command, ...options] = process.argv.slice(2);
+const force = options.includes('--force');
+
+const usage = () => {
+  console.log(`Usage:
+  pnpm exec persagy-vant init [--force]
+
+Creates a project-level Codex Skill entry at:
+  .agents/skills/use-persagy-vant/SKILL.md
+
+After setup, use in Codex:
+  $use-persagy-vant <your task>`);
+};
+
+if (!command || command === '--help' || command === '-h') {
+  usage();
+  process.exit(command ? 0 : 1);
+}
+
+if (command !== 'init') {
+  console.error(`Unknown command: ${command}`);
+  usage();
+  process.exit(1);
+}
+
+if (!existsSync(skillSource)) {
+  console.error('Persagy Vant Skill source is missing. Reinstall persagy-vant and try again.');
+  process.exit(1);
+}
+
+const projectRoot = process.cwd();
+const target = resolve(projectRoot, '.agents/skills/use-persagy-vant/SKILL.md');
+
+if (existsSync(target) && !force) {
+  console.log(`Skill entry already exists: ${relative(projectRoot, target)}`);
+  console.log('Use --force only if you need to recreate the entry.');
+  process.exit(0);
+}
+
+const entry = `---
+name: use-persagy-vant
+description: 使用 Persagy Vant 为 Vue 3 移动端业务页面规划、实现、改造或验收 UI 时使用。适用于需要强制复用 Persagy 基础与业务组件、统一交互和视觉的任务。
+---
+
+读取并严格执行 \`node_modules/persagy-vant/skills/use-persagy-vant/SKILL.md\` 及其 \`references/\` 资料。
+
+当前项目的移动端 UI 与业务组件必须优先复用 \`persagy-vant\`；不得重写组件库已有的组件、交互或样式。
+`;
+
+mkdirSync(dirname(target), { recursive: true });
+writeFileSync(target, entry, 'utf8');
+
+console.log(`Created Codex Skill entry: ${relative(projectRoot, target)}`);
+console.log('Now use in Codex: $use-persagy-vant <your task>');
+console.log('After upgrading persagy-vant, this entry automatically reads the new packaged Skill.');

package/es/index.d.ts

@@ -116,4 +116,4 @@ declare namespace _default {
 }
 export default _default;
 export function install(app: any): void;
-export const version: "0.0.31";
+export const version: "0.0.32";

package/es/index.mjs

@@ -109,7 +109,7 @@ import { Uploader } from "./uploader/index.mjs";
 import { VideoPreview } from "./video-preview/index.mjs";
 import { WorkOrderCard } from "./work-order-card/index.mjs";
 import { WorkOrderFilter } from "./work-order-filter/index.mjs";
-const version = "0.0.31";
+const version = "0.0.32";
 function install(app) {
   const components = [
     ActionBar,

package/lib/index.d.ts

@@ -116,4 +116,4 @@ declare namespace _default {
 }
 export default _default;
 export function install(app: any): void;
-export const version: "0.0.31";
+export const version: "0.0.32";

package/lib/index.js

@@ -246,7 +246,7 @@ __reExport(stdin_exports, require("./uploader"), module.exports);
 __reExport(stdin_exports, require("./video-preview"), module.exports);
 __reExport(stdin_exports, require("./work-order-card"), module.exports);
 __reExport(stdin_exports, require("./work-order-filter"), module.exports);
-const version = "0.0.31";
+const version = "0.0.32";
 function install(app) {
   const components = [
     import_action_bar.ActionBar,

package/lib/vant.cjs.js

@@ -20214,7 +20214,7 @@ const Lazyload = {
     });
   }
 };
-const version = "0.0.31";
+const version = "0.0.32";
 function install(app) {
   const components = [
     ActionBar,

package/lib/vant.es.js

@@ -20212,7 +20212,7 @@ const Lazyload = {
     });
   }
 };
-const version = "0.0.31";
+const version = "0.0.32";
 function install(app) {
   const components = [
     ActionBar,

package/lib/vant.js

@@ -23801,7 +23801,7 @@
       });
     }
   };
-  const version = "0.0.31";
+  const version = "0.0.32";
   function install(app) {
     const components = [
       ActionBar,