@pm_zhousl/xinyun-ai-init 1.1.2 → 1.1.4

package/init/xinyun-ai-init/README.md

@@ -92,10 +92,27 @@ CLI 只负责生成 `xinyun-ai-init/`，不创建 `xinyun-ai/`，也不修改业
 
 UI 类需求至少判断前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及。
 
+如果当前 AI 工具有需求分析、原型、UI 交互、截图风格识别等 Skill，仅在任务明确匹配时调用对应 Skill；不得因为普通开发任务默认启用所有 Skill。
+
 样式微调应优先局部修改，不重写页面结构；新页面或页面重写必须先说明页面结构方案，且不得顺手修改无关页面。
 
 普通聊天、临时咨询、无长期价值排查不沉淀。
 
+## 商业逻辑与变现流程理解
+
+当需求涉及金额、订单、权益、结算、优惠、积分、分润、提现、会员等级、支付状态或退款等商业逻辑时，AI 必须先做触发式业务理解。
+
+触发后先梳理：
+
+- 业务目标
+- 关键角色
+- 资金 / 权益 / 状态流转
+- 数据库、API、UI 和测试数据影响
+- 风险点
+- 验收标准
+
+该规则只在相关需求触发时启用，不默认创建 `xinyun-ai/business/`，也不在首次初始化阶段生成大量商业分析文档。
+
 ## 统一入口与旧规则失效
 
 当前项目 AI 规则以 `xinyun-ai/` 为准，`AGENTS.md` 只作为入口文件，指向 `xinyun-ai/`。
@@ -217,9 +234,36 @@ xinyun-ai/index/project-index.json
 - 问题排查：`xinyun-ai/problems/`
 - 需求：`xinyun-ai/requirements/`
 - 技术经验：`xinyun-ai/rules-candidates/`
+- 全局影响审视：`xinyun-ai/global-review/`
 
 新目录创建后必须更新 `xinyun-ai/manifest.json` 和 `xinyun-ai/index/project-index.json`。
 
+## 通用项目全局视角
+
+新增功能、大改、重构、跨端改动、目录 / 规则 / 索引调整时，AI 必须先做全局影响审视。
+
+小改可以只在改动计划中简写全局影响；新功能、大改、重构、跨端改动、目录 / 规则 / 索引调整，应按需创建或更新：
+
+```md
+xinyun-ai/global-review/
+```
+
+全局审视不代替改动计划，它是改动计划前的影响检查。
+
+建议审视层：
+
+- 入口层
+- 目录层
+- 索引层
+- 任务层
+- 规则层
+- 多端层
+- 数据层
+- API 层
+- UI 层
+- 验证层
+- 交接层
+
 ## 会话工作台
 
 首次初始化不创建会话工作台。复杂任务中可按需创建：

package/init/xinyun-ai-init/templates/core-rules.template.md

@@ -68,10 +68,17 @@
 - 涉及功能、业务流程、API、数据库、页面、组件、交互或样式时，出计划前先做轻量需求理解。
 - 信息不足时，最多问 1-3 个关键问题。
 - UI 类需求至少判断前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及。
+- 如果当前 AI 工具有需求分析、原型、UI 交互、截图风格识别等 Skill，仅在任务明确匹配时调用对应 Skill；不得因为普通开发任务默认启用所有 Skill。
 - 样式微调应优先局部修改，不重写页面结构。
 - 新页面或页面重写必须先说明页面结构方案，且不得顺手修改无关页面。
 - 普通聊天、临时咨询、无长期价值排查不沉淀。
 
+## 商业逻辑与变现流程理解
+
+- 当需求涉及金额、订单、权益、结算、优惠、积分、分润、提现、会员等级、支付状态或退款等商业逻辑时，先做触发式业务理解。
+- 触发后先梳理业务目标、关键角色、资金 / 权益 / 状态流转、数据库 / API / UI / 测试数据影响、风险点和验收标准。
+- 该规则只在相关需求触发时启用，不默认创建 `xinyun-ai/business/`。
+
 ## 检索与回复
 
 - 先读 `AGENTS.md`、`xinyun-ai/manifest.json`、`xinyun-ai/index/project-index.json`、`xinyun-ai/current-task.md`。
@@ -104,6 +111,14 @@
 
 复杂任务可按需创建 `xinyun-ai/index/session-current.md`。该文件只记录本轮临时线索，不是项目事实源。
 
+## 通用项目全局视角
+
+- 新增功能、大改、重构、跨端改动、目录 / 规则 / 索引调整时，先做全局影响审视。
+- 小改可以只在改动计划中简写全局影响。
+- 需要落盘时按需创建或更新 `xinyun-ai/global-review/`。
+- 全局审视不代替改动计划，它是改动计划前的影响检查。
+- 建议审视入口层、目录层、索引层、任务层、规则层、多端层、数据层、API 层、UI 层、验证层和交接层。
+
 ## 自我学习
 
 发现可复用经验时，先记录为候选经验。候选经验必须标注来源、适用范围、可信度、状态和最后验证时间。用户确认后，才能合并进正式规则。

package/init/xinyun-ai-init/templates/current-task.template.md

@@ -8,6 +8,8 @@
 - 待确认问题：
 - 改动计划摘要：
 - SQL 执行提醒：
+- 商业逻辑 / 变现流程提醒：
+- 全局影响审视：
 - 验证结果：
 - 旧沉淀接管：
 - 本轮沉淀位置：

package/init/xinyun-ai-init/templates/manifest.template.json

@@ -1,7 +1,7 @@
 {
   "projectName": "",
-  "xinyunAiVersion": "1.1.2",
-  "scriptVersion": "2026.07.14",
+  "xinyunAiVersion": "1.1.4",
+  "scriptVersion": "2026.07.15",
   "schemaVersion": "1",
   "initializationMode": "fast",
   "expansionMode": "triggered",

package/init/xinyun-ai-init/version.json

@@ -1,8 +1,8 @@
 {
   "packageName": "xinyun-ai-init",
   "displayName": "欣芸技术开发 Agent 流初始化包",
-  "version": "1.1.2",
-  "scriptVersion": "2026.07.14",
+  "version": "1.1.4",
+  "scriptVersion": "2026.07.15",
   "schemaVersion": "1",
   "defaultMode": "fast-init",
   "targetWorkspace": "xinyun-ai",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pm_zhousl/xinyun-ai-init",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "欣芸技术开发 Agent 流初始化包",
   "bin": {
     "xinyun-ai-init": "bin/xinyun-ai-init.js"
@@ -12,6 +12,7 @@
     "README.md"
   ],
   "scripts": {
+    "verify:init": "node ./scripts/verify-init-package.js",
     "publish:token": "powershell -ExecutionPolicy Bypass -File ./scripts/publish-with-token.ps1",
     "publish:token:dry": "powershell -ExecutionPolicy Bypass -File ./scripts/publish-with-token.ps1 -DryRun"
   },

package/scripts/verify-init-package.js

@@ -0,0 +1,203 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+
+const root = path.resolve(__dirname, "..");
+const initRoot = path.join(root, "init", "xinyun-ai-init");
+
+const checks = [];
+
+function rel(filePath) {
+  return path.relative(root, filePath).replace(/\\/g, "/");
+}
+
+function readText(relativePath) {
+  const filePath = path.join(root, relativePath);
+  return fs.readFileSync(filePath, "utf8");
+}
+
+function addCheck(name, ok, detail) {
+  checks.push({ name, ok, detail });
+}
+
+function requireFile(relativePath) {
+  const filePath = path.join(root, relativePath);
+  addCheck(`文件存在：${relativePath}`, fs.existsSync(filePath), "缺少必需文件");
+}
+
+function requireIncludes(relativePath, snippets) {
+  const content = readText(relativePath);
+  for (const snippet of snippets) {
+    addCheck(
+      `${relativePath} 包含：${snippet}`,
+      content.includes(snippet),
+      `未找到关键文本：${snippet}`
+    );
+  }
+}
+
+function requireJson(relativePath) {
+  try {
+    JSON.parse(readText(relativePath));
+    addCheck(`JSON 可解析：${relativePath}`, true);
+  } catch (error) {
+    addCheck(`JSON 可解析：${relativePath}`, false, error.message);
+  }
+}
+
+function requireMarkdownBalanced(relativePath) {
+  const content = readText(relativePath);
+  const fenceCount = (content.match(/```/g) || []).length;
+  addCheck(
+    `Markdown 代码块闭合：${relativePath}`,
+    fenceCount % 2 === 0,
+    `代码块围栏数量为 ${fenceCount}`
+  );
+}
+
+function walkFiles(dirPath) {
+  const result = [];
+  for (const entry of fs.readdirSync(dirPath, { withFileTypes: true })) {
+    const entryPath = path.join(dirPath, entry.name);
+    if (entry.isDirectory()) {
+      result.push(...walkFiles(entryPath));
+    } else {
+      result.push(entryPath);
+    }
+  }
+  return result;
+}
+
+function verifyPackageFiles() {
+  const packageJson = JSON.parse(readText("package.json"));
+  const expectedFiles = ["bin/", "init/", "scripts/", "README.md"];
+
+  for (const expected of expectedFiles) {
+    addCheck(
+      `package.json files 包含：${expected}`,
+      Array.isArray(packageJson.files) && packageJson.files.includes(expected),
+      "发布文件白名单缺少该路径"
+    );
+  }
+
+  addCheck(
+    "package.json scripts 包含 verify:init",
+    packageJson.scripts && packageJson.scripts["verify:init"] === "node ./scripts/verify-init-package.js",
+    "缺少发布前校验命令"
+  );
+}
+
+function verifyCliBoundary() {
+  const cli = readText("bin/xinyun-ai-init.js");
+
+  requireIncludes("bin/xinyun-ai-init.js", [
+    "This CLI only creates xinyun-ai-init/",
+    "It does not create xinyun-ai/ or modify business code",
+    "printNextStep",
+  ]);
+
+  addCheck(
+    "CLI 目标目录仅为 xinyun-ai-init",
+    cli.includes('const target = path.join(cwd, "xinyun-ai-init");'),
+    "CLI 不应直接创建 xinyun-ai/"
+  );
+}
+
+function verifyInitRules() {
+  requireIncludes("init/xinyun-ai-init/README.md", [
+    "用户发送一句话入口后，AI 可以按本 README 和 `templates/` 创建或补齐首次最小落盘清单。",
+    "该授权只覆盖 AI 工作区初始化，不代表授权修改业务代码",
+    "标准改动计划",
+    "前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及",
+    "当前项目 AI 规则以 `xinyun-ai/` 为准",
+    "旧 AI 文档、旧 docs、旧提示词、旧规则文件只作为历史线索，不作为执行依据",
+    "ThinkPHP、uni-app、微信小程序",
+    "涉及 SQL / 数据库改动时，必须单独输出 SQL 执行提醒",
+    "商业逻辑",
+    "xinyun-ai/global-review/",
+  ]);
+
+  requireIncludes("init/xinyun-ai-init/templates/AGENTS.template.md", [
+    "当前项目 AI 规则以 `xinyun-ai/` 为准",
+    "任何代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程修改前",
+    "只有用户明确回复“确认执行”“可以修改”“按方案改”“同意”等类似内容后",
+  ]);
+
+  requireIncludes("init/xinyun-ai-init/templates/core-rules.template.md", [
+    "标准改动计划",
+    "前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及",
+    "有 CodeGraph 时，结构性问题优先使用 CodeGraph",
+    "发现可复用经验时，先记录为候选经验",
+  ]);
+}
+
+function verifyFrameworkRules() {
+  const required = [
+    "init/xinyun-ai-init/rules/frameworks/README.md",
+    "init/xinyun-ai-init/rules/frameworks/backend/php/thinkphp.md",
+    "init/xinyun-ai-init/rules/frameworks/frontend/uni-app.md",
+    "init/xinyun-ai-init/rules/frameworks/frontend/wechat-miniprogram.md",
+  ];
+
+  for (const file of required) {
+    requireFile(file);
+  }
+
+  requireIncludes("init/xinyun-ai-init/rules/frameworks/backend/php/thinkphp.md", [
+    "topthink/framework",
+    "think\\facade",
+  ]);
+  requireIncludes("init/xinyun-ai-init/rules/frameworks/frontend/uni-app.md", [
+    "pages.json",
+    "vite-plugin-uni",
+  ]);
+  requireIncludes("init/xinyun-ai-init/rules/frameworks/frontend/wechat-miniprogram.md", [
+    "project.config.json",
+    ".wxml",
+  ]);
+}
+
+function verifyJsonAndMarkdown() {
+  const jsonFiles = walkFiles(initRoot).filter((filePath) => filePath.endsWith(".json"));
+  const mdFiles = walkFiles(initRoot).filter((filePath) => filePath.endsWith(".md"));
+
+  for (const filePath of jsonFiles) {
+    requireJson(rel(filePath));
+  }
+
+  for (const filePath of mdFiles) {
+    requireMarkdownBalanced(rel(filePath));
+  }
+}
+
+function main() {
+  requireFile("bin/xinyun-ai-init.js");
+  requireFile("init/xinyun-ai-init/README.md");
+  requireFile("init/xinyun-ai-init/version.json");
+
+  verifyPackageFiles();
+  verifyCliBoundary();
+  verifyInitRules();
+  verifyFrameworkRules();
+  verifyJsonAndMarkdown();
+
+  const failed = checks.filter((check) => !check.ok);
+
+  for (const check of checks) {
+    const prefix = check.ok ? "[PASS]" : "[FAIL]";
+    console.log(`${prefix} ${check.name}`);
+    if (!check.ok && check.detail) {
+      console.log(`       ${check.detail}`);
+    }
+  }
+
+  console.log("");
+  console.log(`[xinyun-ai-init verify] ${checks.length - failed.length}/${checks.length} checks passed.`);
+
+  if (failed.length > 0) {
+    process.exit(1);
+  }
+}
+
+main();