@pm_zhousl/xinyun-ai-init 1.1.6 → 1.3.0

package/init/xinyun-ai-init/templates/project-guide.template.md

@@ -22,6 +22,7 @@
   - 是否存在旧提示词 / 旧规则文件：待填写。
 - 可接管内容：待填写。
 - 不接管内容：待填写。
+- 待确认内容：待填写。
 - 不存在的旧路径：待填写。
 
 ## 旧规则失效判定
@@ -30,6 +31,30 @@
 - 旧 AI 文档、旧 docs、旧提示词、旧规则文件只作为历史线索，不作为执行依据。
 - 如果旧规则路径在当前文件系统中不存在，必须标注为 `当前项目未发现`。
 - 如旧规则与 `xinyun-ai/` 冲突，以 `xinyun-ai/` 为准。
+- 规则优先级：`xinyun-ai/` 当前正式规则 > 当前文件系统事实 > 旧 AI 文档 > 历史会话记忆。
+- 历史会话记忆不得覆盖当前文件系统事实。
+
+## 中文需求解析与任务分型
+
+- 是否触发解析：待填写。
+- 用户原话：待填写。
+- AI 理解：待填写。
+- 任务类型：待填写。
+- 影响对象：待填写。
+- 风险词：待填写。
+- 是否需要追问：待填写。
+
+## 全局影响审视
+
+- 是否触发全局审视：待填写。
+- reviewId：待填写。
+- 触发原因：待填写。
+- 影响层：待填写。
+- 已确认内容：待填写。
+- 推断内容：待填写。
+- 待确认内容：待填写。
+- 风险点：待填写。
+- 后续动作：待填写。
 
 ## 端、模块、技术栈与本地启动方式
 

package/init/xinyun-ai-init/templates/project-index.template.json

@@ -12,7 +12,31 @@
   "handoffs": {
     "activeTask": "none",
     "taskFile": "xinyun-ai/index/session-current.md",
-    "handoffFile": "xinyun-ai/handoffs/current-execution.md"
+    "handoffFile": "xinyun-ai/handoffs/current-execution.md",
+    "contract": "single-project-single-active-task-main-session-plus-execution-session"
+  },
+  "delivery": {
+    "confirmationGate": true,
+    "productionCopyMode": "restrained",
+    "outputStyle": "conclusion-first"
+  },
+  "legacyHandoff": {
+    "sources": [],
+    "adoptable": [],
+    "ignored": [],
+    "pending": [],
+    "notFound": []
+  },
+  "globalReview": {
+    "enabled": true,
+    "directory": "xinyun-ai/global-review/",
+    "indexFile": "xinyun-ai/global-review/index.json",
+    "createOnFastInit": false
+  },
+  "requirementParsing": {
+    "enabled": true,
+    "trigger": "ambiguous_or_change_or_high_risk",
+    "ordinaryConsultationRequiresFullParsing": false
   },
   "lastUpdatedAt": ""
 }

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pm_zhousl/xinyun-ai-init",
-  "version": "1.1.6",
+  "version": "1.3.0",
   "description": "欣芸技术开发 Agent 流初始化包",
   "bin": {
     "xinyun-ai-init": "bin/xinyun-ai-init.js"
@@ -9,6 +9,7 @@
     "bin/",
     "init/",
     "scripts/",
+    "test-scenarios/",
     "README.md"
   ],
   "scripts": {

package/scripts/verify-init-package.js

@@ -71,7 +71,9 @@ function walkFiles(dirPath) {
 
 function verifyPackageFiles() {
   const packageJson = JSON.parse(readText("package.json"));
-  const expectedFiles = ["bin/", "init/", "scripts/", "README.md"];
+  const versionJson = JSON.parse(readText("init/xinyun-ai-init/version.json"));
+  const manifestTemplate = JSON.parse(readText("init/xinyun-ai-init/templates/manifest.template.json"));
+  const expectedFiles = ["bin/", "init/", "scripts/", "test-scenarios/", "README.md"];
 
   for (const expected of expectedFiles) {
     addCheck(
@@ -86,6 +88,22 @@ function verifyPackageFiles() {
     packageJson.scripts && packageJson.scripts["verify:init"] === "node ./scripts/verify-init-package.js",
     "缺少发布前校验命令"
   );
+
+  addCheck(
+    "package.json 版本为 1.3.0",
+    packageJson.version === "1.3.0",
+    `当前版本为 ${packageJson.version}`
+  );
+  addCheck(
+    "version.json 版本为 1.3.0",
+    versionJson.version === "1.3.0",
+    `当前版本为 ${versionJson.version}`
+  );
+  addCheck(
+    "manifest.template.json 版本为 1.3.0",
+    manifestTemplate.xinyunAiVersion === "1.3.0",
+    `当前版本为 ${manifestTemplate.xinyunAiVersion}`
+  );
 }
 
 function verifyCliBoundary() {
@@ -110,12 +128,37 @@ function verifyInitRules() {
     "该授权只覆盖 AI 工作区初始化，不代表授权修改业务代码",
     "标准改动计划",
     "前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及",
+    "页面类型：生产页面 / 原型页面 / 营销页面 / 不涉及",
+    "页面文案预算",
+    "用户确认状态",
+    "发现新增影响范围",
     "当前项目 AI 规则以 `xinyun-ai/` 为准",
     "旧 AI 文档、旧 docs、旧提示词、旧规则文件只作为历史线索，不作为执行依据",
+    "规则优先级",
+    "`xinyun-ai/` 当前正式规则",
+    "当前文件系统事实",
+    "历史会话记忆",
+    "先识别、再分类、再接管",
+    "可接管",
+    "不接管",
+    "待确认",
+    "不创建自动迁移脚本",
+    "中文需求解析",
+    "用户原话",
+    "任务类型至少包括",
+    "高歧义表达",
+    "优化一下",
+    "处理一下",
+    "高风险词",
+    "订单、支付、退款",
+    "最多追问 1-3 个关键问题",
     "ThinkPHP、uni-app、微信小程序",
     "涉及 SQL / 数据库改动时，必须单独输出 SQL 执行提醒",
     "商业逻辑",
     "xinyun-ai/global-review/",
+    "首次极速初始化不强制创建 `xinyun-ai/global-review/`",
+    "reviewId",
+    "xinyun-ai/global-review/index.json",
     "Git 工作区与危险操作门禁",
     "单仓库",
     "多仓库",
@@ -129,6 +172,14 @@ function verifyInitRules() {
     "Vue2 / Vue3",
     "React",
     "第三方库",
+    "生产页面默认采用克制文案",
+    "本页面用于",
+    "智能、高效、便捷、全方位",
+    "真实业务表达",
+    "删除非必要说明后核心操作仍清楚",
+    "明显 AI 话术",
+    "不做无关全量扫描",
+    "少复述规则",
     "双会话执行闭环（MVP）",
     "xinyun-ai/index/session-current.md",
     "xinyun-ai/handoffs/current-execution.md",
@@ -136,27 +187,68 @@ function verifyInitRules() {
     "executionId",
     "待主会话复核",
     "不得自动重试",
+    "是否执行过高风险操作",
+    "交付输出要求",
   ]);
 
   requireIncludes("init/xinyun-ai-init/templates/AGENTS.template.md", [
     "当前项目 AI 规则以 `xinyun-ai/` 为准",
+    "规则优先级",
+    "历史会话记忆不得覆盖当前文件系统事实",
+    "先识别、再分类、再接管",
+    "未确认内容不得直接写入正式规则",
     "任何代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程修改前",
     "只有用户明确回复“确认执行”“可以修改”“按方案改”“同意”等类似内容后",
+    "发现新增影响范围",
     "前端组件调用、框架 API 和交互能力优先使用官方组件",
+    "页面类型必须标注为：生产页面 / 原型页面 / 营销页面 / 不涉及",
+    "生产页面默认采用克制文案",
+    "明显 AI 话术",
     "单仓库 / 多仓库 / 混合仓库 / 无 Git",
     "不得自动执行 `commit`、`tag`、`push`、`pull`、`merge`、`rebase`、`reset`、`checkout` 回滚或切分支",
+    "双会话文件契约",
+    "失败、中断、超时后不得自动重试",
+    "中文需求解析与任务分型",
+    "高歧义表达包括",
+    "高风险词包括",
+    "最多追问 1-3 个关键问题",
+    "全局影响审视",
+    "首次极速初始化不强制创建",
   ]);
 
   requireIncludes("init/xinyun-ai-init/templates/core-rules.template.md", [
     "标准改动计划",
     "前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及",
+    "规则优先级",
+    "历史会话记忆不得覆盖当前文件系统事实",
+    "先识别、再分类、再接管",
+    "不创建自动迁移脚本",
+    "中文需求解析格式",
+    "用户原话",
+    "任务类型至少包括",
+    "高歧义表达包括",
+    "高风险词包括",
+    "最多追问 1-3 个关键问题",
+    "页面类型：生产页面 / 原型页面 / 营销页面 / 不涉及",
+    "页面文案预算",
+    "发现新增影响范围",
     "有 CodeGraph 时，结构性问题优先使用 CodeGraph",
     "发现可复用经验时，先记录为候选经验",
     "前端官方组件与 API 优先",
     "uni.*",
     "Vue2 / Vue3",
     "React 官方组件模式",
+    "生产页面默认采用克制文案",
+    "本页面用于",
+    "智能、高效、便捷、全方位",
+    "真实业务表达",
+    "删除非必要说明后核心操作仍清楚",
+    "不做无关全量扫描",
+    "少复述规则",
     "Git 工作区与危险操作门禁",
+    "首次极速初始化不强制创建 `xinyun-ai/global-review/`",
+    "`reviewId`",
+    "xinyun-ai/global-review/index.json",
     "单仓库 / 多仓库 / 混合仓库 / 无 Git",
     "不得自动执行 `commit`、`tag`、`push`、`pull`、`merge`、`rebase`、`reset`、`checkout` 回滚或切分支",
     "双会话执行闭环（MVP）",
@@ -165,6 +257,108 @@ function verifyInitRules() {
     "taskId",
     "executionId",
     "不得自动重试",
+    "人工启动第二会话",
+    "交付输出",
+  ]);
+
+  requireIncludes("init/xinyun-ai-init/templates/current-task.template.md", [
+    "前端改动模式",
+    "中文需求解析",
+    "用户原话",
+    "任务类型",
+    "风险词",
+    "是否需要追问",
+    "页面类型",
+    "页面文案预算",
+    "用户确认状态",
+    "交付状态",
+    "下一步动作",
+  ]);
+
+  requireIncludes("init/xinyun-ai-init/templates/project-index.template.json", [
+    "single-project-single-active-task-main-session-plus-execution-session",
+    "productionCopyMode",
+    "conclusion-first",
+    "legacyHandoff",
+    "globalReview",
+    "requirementParsing",
+    "createOnFastInit",
+  ]);
+
+  requireIncludes("init/xinyun-ai-init/rules/session-workbench.md", [
+    "状态机至少包含",
+    "失败、中断、超时后不得自动重试",
+    "临时执行任务单建议结构",
+    "执行交接单建议结构",
+    "是否执行过高风险操作",
+    "可接管、不接管、待确认",
+    "中文需求解析结果",
+    "全局影响审视摘要",
+  ]);
+
+  requireIncludes("init/xinyun-ai-init/templates/project-guide.template.md", [
+    "规则优先级",
+    "中文需求解析与任务分型",
+    "全局影响审视",
+    "待确认内容",
+  ]);
+
+  requireIncludes("init/xinyun-ai-init/templates/project-check.template.md", [
+    "规则入口优先级",
+    "中文需求解析触发情况",
+    "全局影响审视触发情况",
+    "待确认内容",
+  ]);
+
+  requireIncludes("init/xinyun-ai-init/rules/init-rules.md", [
+    "当前项目 AI 规则以 `xinyun-ai/` 为准",
+    "当前项目未发现",
+    "可接管、不接管、待确认",
+    "首次极速初始化不强制创建",
+    "最多追问 1-3 个关键问题",
+  ]);
+
+  requireIncludes("init/xinyun-ai-init/rules/upgrade-rules.md", [
+    "规则优先级",
+    "中文需求解析",
+    "xinyun-ai/global-review/",
+    "不自动迁移全部旧 AI 文档",
+  ]);
+
+  requireIncludes("init/xinyun-ai-init/rules/directory-self-completion.md", [
+    "xinyun-ai/global-review/",
+    "首次极速初始化不强制创建",
+    "xinyun-ai/global-review/index.json",
+    "`reviewId`",
+  ]);
+}
+
+function verifyTestScenarios() {
+  requireIncludes("test-scenarios/scenarios.md", [
+    "生产页面文案与去 AI 化测试",
+    "使用者体验与交付结果测试",
+    "AI 检索与回复轻量规则测试",
+    "双会话执行闭环（MVP）测试",
+    "统一入口与旧规则失效判定测试",
+    "小改不强制创建全局审视测试",
+    "中文需求语义规范化测试",
+    "高风险词触发保护测试",
+    "普通咨询不强制完整解析测试",
+    "当前必测场景",
+  ]);
+
+  requireIncludes("test-scenarios/review-template.md", [
+    "生产页面文案与去 AI 化测试",
+    "使用者体验与交付结果测试",
+    "AI 检索与回复轻量规则测试",
+    "统一入口与旧规则失效判定测试",
+    "中文需求语义规范化测试",
+    "高风险词触发保护测试",
+  ]);
+
+  requireIncludes("test-scenarios/README.md", [
+    "pm_zhousl-xinyun-ai-init-1.3.0.tgz",
+    "当前必测场景为 `scenarios.md` 的 1-22",
   ]);
 }
 
@@ -216,6 +410,7 @@ function main() {
   verifyCliBoundary();
   verifyInitRules();
   verifyFrameworkRules();
+  verifyTestScenarios();
   verifyJsonAndMarkdown();
 
   const failed = checks.filter((check) => !check.ok);

package/test-scenarios/README.md

@@ -0,0 +1,85 @@
+# xinyun-ai-init 测试场景
+
+本目录用于让其他 AI 或人工审查员测试 `@pm_zhousl/xinyun-ai-init` 初始化包的真实使用效果。
+
+## 使用方式
+
+### 1. 本地待发布版本测试
+
+用于测试当前工作区尚未发布到 npm 的包体。
+
+1. 准备一个临时测试项目。
+2. 在测试项目根目录执行：
+
+```powershell
+node E:\ai-fabu-xiangmu\AI开发初始化脚本\xinyun-ai-init-npm\bin\xinyun-ai-init.js --force --no-version-check
+```
+
+3. 将以下一句话发给 AI：
+
+```md
+请执行 `node E:\ai-fabu-xiangmu\AI开发初始化脚本\xinyun-ai-init-npm\bin\xinyun-ai-init.js --force --no-version-check`，然后读取 `xinyun-ai-init/README.md`，按其中规则初始化或升级当前项目。
+```
+
+4. 按 `scenarios.md` 中的场景逐条测试。
+5. 将结果填写到 `review-template.md`。
+
+### 2. 打包版本测试
+
+用于确认 `npm pack` 后的 tarball 是否包含完整文件。
+
+```powershell
+cd E:\ai-fabu-xiangmu\AI开发初始化脚本\xinyun-ai-init-npm
+npm run verify:init
+npm pack
+```
+
+随后在临时项目中使用 tarball 测试。注意不要直接执行 `npx <tarball> --force`，该形式可能不会正确调用 bin。推荐：
+
+```powershell
+npx --yes --package E:\ai-fabu-xiangmu\AI开发初始化脚本\xinyun-ai-init-npm\pm_zhousl-xinyun-ai-init-1.3.0.tgz xinyun-ai-init --force --no-version-check
+```
+
+### 3. 线上回归测试
+
+发布后再测试 npm 线上最新版本。
+
+```powershell
+npx --yes @pm_zhousl/xinyun-ai-init@latest --force
+```
+
+将以下一句话发给 AI：
+
+```md
+请执行 `npx --yes @pm_zhousl/xinyun-ai-init@latest --force`，然后读取 `xinyun-ai-init/README.md`，按其中规则初始化或升级当前项目。
+```
+
+## 测试分级
+
+- 必测场景：用于判断当前版本是否可以发布。
+- 观察场景：用于收集后续优化建议，不作为当前版本发布阻断项。
+
+当前必测场景为 `scenarios.md` 的 1-22。
+
+当前观察场景为 `scenarios.md` 的 23。Skill 触发机制仍在后续候选池中，不进入当前可发布范围。
+
+## 自动校验
+
+发布前必须先执行：
+
+```powershell
+cd E:\ai-fabu-xiangmu\AI开发初始化脚本\xinyun-ai-init-npm
+npm run verify:init
+```
+
+自动校验负责检查包体文件、模板关键规则、JSON 可解析、Markdown 代码块闭合和 CLI 边界。人工场景负责验证 AI 在真实项目里的行为。
+
+## 审查原则
+
+- 重点看 AI 行为是否符合规则，不只看文件是否生成。
+- 初始化应轻量，不做全量扫描。
+- 改代码前必须先出方案并等待确认。
+- 旧 AI 沉淀只能先梳理、分类、待确认，不能直接当作项目事实。
+- 普通聊天、无关问题、被否定方向不能沉淀。
+- 观察场景可以记录问题和建议，但不要因为观察场景未完全满足而判定当前版本不可发布。
+- 本地待发布版本、打包版本、线上 `@latest` 要分开测试，避免把线上旧版本误判为本地整改结果。

package/test-scenarios/review-template.md

@@ -0,0 +1,63 @@
+# 测试审查记录模板
+
+## 基本信息
+
+- 测试项目：
+- 测试 AI 工具：
+- 测试时间：
+- xinyun-ai-init 版本：
+- 测试人：
+
+## 总体结论
+
+- 结论：通过 / 部分通过 / 不通过
+- 最大问题：
+- 是否建议发布：
+- 发布阻断项：
+- 观察项建议：
+
+## 场景结果
+
+| 场景 | 结果 | 问题摘要 | 建议 |
+|---|---|---|---|
+| 1. 初始化可用性测试 | 待填写 | 待填写 | 待填写 |
+| 2. 方案可行性测试 | 待填写 | 待填写 | 待填写 |
+| 3. 修改确认门禁测试 | 待填写 | 待填写 | 待填写 |
+| 4. 前端 UI 改动模式测试 | 待填写 | 待填写 | 待填写 |
+| 5. 前端官方组件 / API 优先测试 | 待填写 | 待填写 | 待填写 |
+| 6. 生产页面文案与去 AI 化测试 | 待填写 | 待填写 | 待填写 |
+| 7. 旧 AI 沉淀接管测试 | 待填写 | 待填写 | 待填写 |
+| 8. 统一入口与旧规则失效判定测试 | 待填写 | 待填写 | 待填写 |
+| 9. 多端项目识别测试 | 待填写 | 待填写 | 待填写 |
+| 10. 框架轻量识别测试 | 待填写 | 待填写 | 待填写 |
+| 11. Git 工作区识别与危险操作门禁测试 | 待填写 | 待填写 | 待填写 |
+| 12. SQL / 数据库提醒测试 | 待填写 | 待填写 | 待填写 |
+| 13. 会话上下文理解测试 | 待填写 | 待填写 | 待填写 |
+| 14. 商业逻辑与变现流程理解测试 | 待填写 | 待填写 | 待填写 |
+| 15. 通用项目全局视角目录测试 | 待填写 | 待填写 | 待填写 |
+| 16. 小改不强制创建全局审视测试 | 待填写 | 待填写 | 待填写 |
+| 17. 中文需求语义规范化测试 | 待填写 | 待填写 | 待填写 |
+| 18. 高风险词触发保护测试 | 待填写 | 待填写 | 待填写 |
+| 19. 普通咨询不强制完整解析测试 | 待填写 | 待填写 | 待填写 |
+| 20. 使用者体验与交付结果测试 | 待填写 | 待填写 | 待填写 |
+| 21. AI 检索与回复轻量规则测试 | 待填写 | 待填写 | 待填写 |
+| 22. 双会话执行闭环（MVP）测试 | 待填写 | 待填写 | 待填写 |
+| 23. Skill 触发测试（观察项，不阻断发布） | 待填写 | 待填写 | 待填写 |
+
+## 详细问题
+
+### 问题 1
+
+- 场景：
+- 严重程度：高 / 中 / 低
+- 现象：
+- 期望：
+- 建议：
+
+## 可发布建议
+
+- 必须修复：
+- 可以后续优化：
+- 不建议纳入本版本：
+
+说明：Skill 触发测试是观察项。除非它影响 1-22 的必测场景，否则不作为当前版本不可发布的理由。