@pm_zhousl/xinyun-ai-init 1.2.0 → 1.4.0

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

@@ -2,7 +2,7 @@
 
 本目录是“欣芸技术开发 Agent 流”的初始化包，负责把完整 AI 执行要求下发到目标项目。
 
-当前规则版本：`1.2.0`。
+当前规则版本：`1.4.0`。
 
 ## Codex 一句话入口
 
@@ -33,8 +33,13 @@ AI 读取本文件后，必须按以下方式执行：
 7. 如果当前项目已有旧 AI 沉淀或历史规则痕迹，先梳理清单并分类接管，能合并的内容归入 `xinyun-ai/`，不能确认的内容标记为 `待确认`，不要直接当作正式事实。
 8. 前端页面改动必须标注改动模式和页面类型，生产页面默认使用克制、真实业务语境的文案。
 9. 复杂改动可使用双会话执行闭环，主会话负责计划和复核，执行会话只按任务单执行。
-10. 首次初始化不执行语言级语法检查、lint、typecheck、测试或构建命令；本机缺少运行时只记录为待确认，不展开长解释。
-11. 完成后用中文输出初始化或升级结果、项目导读、待确认问题和后续短指令。
+10. 需求模糊、涉及改动或出现高风险词时，先做中文需求解析和任务分型；普通咨询不强制输出完整解析结构。
+11. 新功能、大改、重构、跨端、规则或索引调整时，先做全局影响审视；首次极速初始化不强制创建全局审视目录。
+12. 识别 ThinkPHP、uni-app、微信小程序时必须输出证据路径、证据类型、识别状态和覆盖范围，遵守读取预算。
+13. 多仓库 Git 只做只读索引与端口映射，不执行任何 Git 写操作。
+14. 字段新增、删除、重命名、类型 / 含义变化、API 映射或前端展示变化时，先做有边界的字段影响审视。
+15. 首次初始化不执行语言级语法检查、lint、typecheck、测试或构建命令；本机缺少运行时只记录为待确认，不展开长解释。
+16. 完成后用中文输出初始化或升级结果、项目导读、待确认问题和后续短指令。
 
 ## 初始化授权边界
 
@@ -101,6 +106,36 @@ CLI 只负责生成 `xinyun-ai-init/`，不创建 `xinyun-ai/`，也不修改业
 
 信息不足时，最多问 1-3 个关键问题。
 
+需求模糊、涉及改动或出现高风险词时，必须先做中文需求语义规范化。普通咨询不强制输出完整解析结构。
+
+中文需求解析格式：
+
+```md
+## 中文需求解析
+
+- 用户原话：
+- AI 理解：
+- 任务类型：
+- 影响对象：
+- 可能涉及：
+- 不确定点：
+- 风险词：
+- 是否需要追问：
+- 下一步处理方式：
+```
+
+任务类型至少包括：问题排查、新功能开发、UI 调整、API / 接口调整、数据库 / SQL、商业逻辑、Git / 发布、文档沉淀、规则调整、临时咨询。
+
+字段变更类任务还必须细分为：数据库字段新增 / 删除 / 重命名、字段类型或含义变更、API 字段调整、字段展示或渲染调整。
+
+字段相关需求必须输出字段分类和专项路由：字段影响审视 / 普通改动计划 / SQL 提醒 / 业务流程理解。信息不足时最多追问 1-3 个关键问题，不得直接脑补并修改代码。
+
+高歧义表达包括：优化一下、处理一下、不对、怪怪的、照之前、顺便、差不多、参考一下。
+
+高风险词包括：订单、支付、退款、优惠券、会员、权益、金额、积分、分润、提现、结算、权限、删除、批量、发布、回滚。
+
+高歧义需求最多追问 1-3 个关键问题；信息足够时直接进入对应任务流程。高风险词触发更严格的业务理解、问题排查、Git / 发布门禁或 SQL 提醒，不得直接进入代码修改。
+
 UI 类需求至少判断前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及。
 
 UI 类需求还必须判断页面类型：生产页面 / 原型页面 / 营销页面 / 不涉及。
@@ -154,6 +189,15 @@ UI 类需求还必须判断页面类型：生产页面 / 原型页面 / 营销
 
 如旧规则与 `xinyun-ai/` 冲突，以 `xinyun-ai/` 为准。
 
+规则优先级：
+
+1. `xinyun-ai/` 当前正式规则。
+2. 当前文件系统事实。
+3. 旧 AI 文档。
+4. 历史会话记忆。
+
+历史会话记忆不得覆盖当前文件系统事实，也不得补写文件系统中不存在的旧规则路径。
+
 ## 旧沉淀接管
 
 如果项目里已经存在旧 AI 沉淀，如旧 `AGENTS.md`、`docs/`、`CLAUDE.md`、`.cursor/`、旧提示词、旧规则文件或旧工作台记录，AI 应先做接管梳理，再决定是否纳入 `xinyun-ai/`。
@@ -162,6 +206,16 @@ UI 类需求还必须判断页面类型：生产页面 / 原型页面 / 营销
 
 临时聊天、无关内容、明显过期内容和无法确认的内容不进入正式沉淀；不存在的旧路径必须标注为 `当前项目未发现`。
 
+旧 AI 沉淀必须按“先识别、再分类、再接管”的顺序处理。
+
+接管分类：
+
+- 可接管：项目导读、规则入口、需求沉淀、问题记录、框架线索、当前任务线索、可复用经验候选。
+- 不接管：临时聊天、普通闲聊、无关内容、明显过期内容、无法确认来源的结论、敏感信息。
+- 待确认：来源不明、与当前项目文件冲突、无法验证或需要用户判断的内容。
+
+旧沉淀只做规则和模板接管，不创建自动迁移脚本，不自动覆盖现有正式规则。未确认内容不能直接写入正式规则。
+
 ## 欣芸技术开发 Agent 流
 
 这是一套面向 AI 编程工具的本地项目接手、按需理解、受控开发和持续沉淀方法论。
@@ -190,6 +244,75 @@ rules/frameworks/frontend/wechat-miniprogram.md
 
 未识别到对应框架时，不强行套用该框架规则。
 
+框架识别默认预算：
+
+- 每个端口从端口根目录向下最多发现 3 层目录。
+- 每个端口最多读取 20 个关键文件。
+- 正向识别必须列出证据路径和证据类型，如依赖、配置、入口、目录结构、代码特征。
+- 只有单一线索时标注 `推断` 或 `待确认`。
+- 预算内无证据时标注 `未在项目中发现`。
+- 超预算、权限不足或路径不可读时标注 `状态未知`，并写明 `覆盖范围：部分` 和未检查范围。
+- 不把 uni-app 规则套到原生微信小程序，也不把微信小程序规则套到 uni-app。
+
+识别输出建议：
+
+```md
+## 轻量框架识别
+- workstream：
+- 框架候选：
+- 识别状态：已确认 / 推断 / 待确认 / 未在项目中发现 / 状态未知
+- 覆盖范围：完整 / 部分
+- 发现预算：目录深度 3 层、关键文件 20 个
+- 证据：路径、证据类型、命中内容摘要
+- 未检查范围：
+```
+
+## 字段变更影响审视
+
+当需求涉及字段新增、删除、重命名、类型变化、含义变化、API 映射变化或前端展示变化时，AI 必须先做字段影响审视，再进入改动计划。
+
+字段影响审视必须区分数据库字段、API 字段和前端展示字段。
+
+默认审视范围：
+
+- 数据库表结构、migration、Model、Entity、ORM、查询和写入。
+- Service、DAO、参数校验、状态流转、计算、缓存和队列。
+- API 请求、响应、DTO、Serializer 和接口文档。
+- 各端表单、列表、详情、表格、筛选、状态、格式化、图表、导出和打印。
+- Mock、Seed、测试数据、空值、旧值、默认值、历史数据和兼容性。
+
+默认预算：
+
+- 检索根目录为项目根目录和已确认端口 / workstream 根目录。
+- 每个端口最多检查 300 个候选文件、1000 条匹配结果和 50 条证据记录。
+- 排除 `node_modules`、`dist`、`build`、`vendor`、`.git`、`.codegraph`、`storage`、`runtime`、`unpackage`、`coverage`、二进制文件和明确生成目录。
+- CodeGraph 可用时，结构性影响优先使用 CodeGraph；CodeGraph 不可用时，降级为入口文件、配置文件、结构化检索和限定范围文本检索，并标注降级状态。
+- 动态 SQL、动态字段名、序列化、反射和生成代码无法确认时，列为 `待确认` 或 `可能遗漏位置`。
+- 超过预算时停止扩展检索，标注 `审视状态：部分覆盖`、`状态未知` 和 `可能遗漏位置`。
+
+字段影响审视输出契约：
+
+```md
+## 字段影响审视
+- 审视状态：完整覆盖 / 部分覆盖 / 状态未知
+- 字段分类：数据库字段 / API 字段 / 前端展示字段
+- 字段名称与原含义：
+- 调整后含义：
+- 检索根目录：
+- 排除目录与文件：
+- CodeGraph 状态：可用 / 不可用 / 降级
+- 降级原因：
+- 工具预算：
+- 证据列表：路径、位置、匹配内容、判断状态
+- 已覆盖范围：
+- 可能遗漏位置：
+- 旧数据兼容方案：
+- 最终风险：
+- 是否需要用户确认：
+```
+
+只改展示方式时，不得顺手修改数据库和 API。未确认前不得执行 SQL、migration、seed、批量数据修复或接口兼容改动。
+
 ## 执行模式
 
 如果项目没有 `xinyun-ai/`：
@@ -278,6 +401,24 @@ AI 可以读取 Git 状态、总结 diff、建议 commit message 和 tag；未
 
 多端多仓库改动后，应按仓库分别输出交付摘要和建议 commit message，不要混成一个提交建议。
 
+### 多仓库 Git 只读索引与端口映射
+
+AI 可以建立“项目 → 端口 / workstream → Git 仓库”的只读索引，但全程禁止 Git 写操作。
+
+默认发现预算：
+
+- 从项目根目录向下最多发现 4 层目录。
+- 最多记录 20 个仓库候选和 200 个相关目录 / 文件条目。
+- 覆盖根仓库、嵌套 `.git`、子模块和 worktree。
+- 超过预算、权限不足、路径不可读或状态无法确认时，标注 `状态未知`，不得判断为无 Git。
+- 预算内完成检查且无 Git 证据时，标注 `未在项目中发现`。
+
+仓库索引字段：`repoRoot`、`path`、`workstream`、`kind`、`parentRepo`、`branch`、`remote`、`status`、`evidence`。
+
+`kind` 取值为：`root` / `nested` / `submodule` / `worktree`。
+
+只读 Git 操作范围：读取状态、分支、remote、diff 摘要和配置证据。禁止 `commit`、`tag`、`push`、`pull`、`merge`、`rebase`、`reset`、`checkout`、`switch`、回滚和切分支。
+
 ## 按需补齐
 
 后续识别到新端、模块或能力时，只在 `xinyun-ai/` 内补齐对应目录和说明文件。
@@ -306,6 +447,26 @@ xinyun-ai/global-review/
 
 全局审视不代替改动计划，它是改动计划前的影响检查。
 
+首次极速初始化不强制创建 `xinyun-ai/global-review/`。
+
+触发条件包括：新功能、大范围修改、重构、跨端改动、目录 / 规则 / 索引调整、数据库 / API / UI 联动变更、涉及多会话交接的复杂任务。
+
+全局审视最小字段：
+
+- `reviewId`
+- 触发原因
+- 关联任务
+- 影响层
+- 已确认内容
+- 推断内容
+- 待确认内容
+- 风险点
+- 后续动作
+- 创建时间
+- 更新时间
+
+创建或更新全局审视后，应同步 `xinyun-ai/global-review/index.json` 和 `xinyun-ai/index/project-index.json`。全局审视不会授权 AI 直接修改业务代码。
+
 建议审视层：
 
 - 入口层

package/init/xinyun-ai-init/rules/directory-self-completion.md

@@ -8,4 +8,11 @@
 - 只允许补齐 `xinyun-ai/` 内的文档、索引和记录，不修改业务代码。
 - 新目录创建后必须更新 `manifest.json` 和 `index/project-index.json`。
 - 自完善内容必须标注来源、判断依据和状态：`推断`、`已确认`、`待确认`。
-- 如果自完善会改变正式规则、开发流程或代码修改策略，必须先输出方案并等待用户确认。
+- 如果自完善会改变正式规则、开发流程或代码修改策略，必须先输出方案并等待用户确认。
+- `xinyun-ai/global-review/` 只在新功能、大改、重构、跨端改动、目录 / 规则 / 索引调整、数据库 / API / UI 联动变更或多会话交接复杂任务中按需创建。
+- 首次极速初始化不强制创建 `xinyun-ai/global-review/`。
+- 创建或更新全局审视后，必须同步 `xinyun-ai/global-review/index.json` 和 `xinyun-ai/index/project-index.json`。
+- 全局审视最小字段包括：`reviewId`、触发原因、关联任务、影响层、已确认内容、推断内容、待确认内容、风险点、后续动作、创建时间、更新时间。
+- 识别到端口框架线索时，可按需补齐 `workstreams/<端>/`，记录 ThinkPHP / uni-app / 微信小程序识别证据、证据类型、发现预算、覆盖范围、`未在项目中发现` 或 `状态未知`。
+- 识别到多仓库 Git 结构时，可按需补齐端口 Git 只读索引，记录 `repoRoot`、`path`、`workstream`、`kind`、`parentRepo`、`branch`、`remote`、`status`、`evidence`，不得执行 Git 写操作。
+- 触发字段影响审视时，可按需补齐字段审视记录，记录字段分类、检索根目录、排除项、CodeGraph 状态、证据、可能遗漏位置、兼容方案和确认状态。

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

@@ -27,3 +27,19 @@ frameworks/frontend/<framework>.md
 - 如需进一步确认，放到后续任务按需补齐。
 - 未识别到对应框架时，不强行套用该框架规则。
 - 多端项目应分别说明每个端口的框架、入口、启动线索和请求链路线索。
+- 每个端口从端口根目录向下最多发现 3 层目录，最多读取 20 个关键文件。
+- 正向识别必须列出证据路径和证据类型，证据类型包括依赖、配置、入口、目录结构和代码特征。
+- 预算内无识别证据时标注 `未在项目中发现`。
+- 权限不足、路径不可读或超过预算时标注 `状态未知`，同时写明 `覆盖范围：部分` 和未检查范围。
+- 单一线索只能标注 `推断` 或 `待确认`。
+- 不把 uni-app 规则套到原生微信小程序，也不把微信小程序规则套到 uni-app。
+
+## 输出字段
+
+- workstream
+- 框架候选
+- 识别状态：已确认 / 推断 / 待确认 / 未在项目中发现 / 状态未知
+- 覆盖范围：完整 / 部分
+- 发现预算：目录深度 3 层、关键文件 20 个
+- 证据：路径、证据类型、命中内容摘要
+- 未检查范围

package/init/xinyun-ai-init/rules/frameworks/backend/php/thinkphp.md

@@ -27,3 +27,8 @@
 - 首次初始化不为确认 ThinkPHP 做全量 grep。
 - 不把 ThinkPHP 规则套到其他 PHP 框架。
 - 不默认生成大量 ThinkPHP 说明文件。
+- 每个端口从端口根目录向下最多发现 3 层目录，最多读取 20 个关键文件。
+- 正向识别必须输出证据路径和证据类型：依赖、入口、目录结构、配置或代码特征。
+- 预算内无 ThinkPHP 证据时标注 `未在项目中发现`。
+- 超预算、权限不足或路径不可读时标注 `状态未知` 和 `覆盖范围：部分`，并列出未检查范围。
+- 单一线索不能直接确认 ThinkPHP，只能标注 `推断` 或 `待确认`。

package/init/xinyun-ai-init/rules/frameworks/frontend/uni-app.md

@@ -29,3 +29,8 @@
 - 只发现单一线索时，标注为 `推断` 或 `待确认`，不得直接当作已确认 uni-app 项目。
 - 首次初始化不为确认 uni-app 做全量 grep。
 - 不把 uni-app 规则套到原生微信小程序。
+- 每个端口从端口根目录向下最多发现 3 层目录，最多读取 20 个关键文件。
+- 正向识别必须输出证据路径和证据类型：依赖、配置、入口、目录结构或代码特征。
+- 预算内无 uni-app 证据时标注 `未在项目中发现`。
+- 超预算、权限不足或路径不可读时标注 `状态未知` 和 `覆盖范围：部分`，并列出未检查范围。
+- 不把原生微信小程序规则反向套到 uni-app。

package/init/xinyun-ai-init/rules/frameworks/frontend/wechat-miniprogram.md

@@ -29,3 +29,8 @@
 - 只发现单一线索时，标注为 `推断` 或 `待确认`，不得直接当作已确认微信小程序项目。
 - 首次初始化不为确认微信小程序做全量 grep。
 - 不把微信小程序规则套到 uni-app。
+- 每个端口从端口根目录向下最多发现 3 层目录，最多读取 20 个关键文件。
+- 正向识别必须输出证据路径和证据类型：配置、入口、页面结构、目录结构或代码特征。
+- 预算内无微信小程序证据时标注 `未在项目中发现`。
+- 超预算、权限不足或路径不可读时标注 `状态未知` 和 `覆盖范围：部分`，并列出未检查范围。
+- 不把 uni-app 规则反向套到原生微信小程序。

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

@@ -9,3 +9,12 @@
 - 用户发送一句话入口后，视为已授权创建或补齐最小 `xinyun-ai/` 与极简 `AGENTS.md`。
 - 初始化授权不包含业务代码、配置、数据库、API、UI 或业务流程修改。
 - 如果项目里已有旧 AI 沉淀，首次应先做清单化梳理，再决定哪些内容接管到 `xinyun-ai/`。
+- 当前项目 AI 规则以 `xinyun-ai/` 为准，旧 AI 文档只作为历史线索。
+- 旧规则路径不存在时必须标注为 `当前项目未发现`，不得引用历史会话中的旧内容。
+- 旧沉淀按可接管、不接管、待确认分类；未确认内容不得写入正式规则。
+- 首次极速初始化不强制创建 `xinyun-ai/global-review/`。
+- 需求模糊、涉及改动或出现高风险词时，先做中文需求解析；普通咨询不强制输出完整解析结构。
+- 中文需求解析最多追问 1-3 个关键问题。
+- ThinkPHP、uni-app、微信小程序轻量识别每个端口最多发现 3 层目录、读取 20 个关键文件，必须记录证据路径、证据类型、识别状态和覆盖范围。
+- 多仓库 Git 只读索引最多发现 4 层目录、20 个仓库候选和 200 个目录 / 文件条目，只读取状态与证据，不执行 Git 写操作。
+- 字段新增、删除、重命名、类型 / 含义变化、API 映射或前端展示变化时，先做字段影响审视；未确认前不得执行 SQL、migration、seed、批量数据修复或接口兼容改动。

package/init/xinyun-ai-init/rules/session-workbench.md

@@ -14,6 +14,9 @@ xinyun-ai/index/session-current.md
 - 不记录非项目内容、闲聊、敏感值。
 - 不记录完整搜索流水账，只记录关键文件、关键发现、待确认点、候选沉淀。
 - 如果发现旧 AI 沉淀，只记录来源路径、分类结果和是否可接管，不直接把旧内容写成事实。
+- 旧 AI 沉淀分类必须区分可接管、不接管、待确认；不存在路径标注 `当前项目未发现`。
+- 需求模糊、涉及改动或出现高风险词时，`session-current.md` 可记录中文需求解析结果，但普通咨询不强制输出完整解析结构。
+- 新功能、大改、重构、跨端、规则或索引调整时，`session-current.md` 可记录全局影响审视摘要；需要落盘时再按需创建 `xinyun-ai/global-review/`。
 - 会话结束前必须筛选：长期有价值的沉淀到正式目录；仅本轮有价值的写入 `sessions/`；无价值、误判、非项目内容不沉淀。
 - 筛选完成后更新 `index/project-index.json`。
 
@@ -21,6 +24,10 @@ xinyun-ai/index/session-current.md
 
 双会话交接单至少记录：执行前 Git 或文件状态、实际修改文件、diff 摘要、测试结果、未完成事项、新风险和是否存在超范围修改。
 
+字段变更任务单还必须记录字段分类、专项路由、字段影响审视状态、检索根目录、排除项、CodeGraph 状态、证据预算、允许修改文件、禁止修改范围、SQL / migration / seed 禁止项和用户确认状态。
+
+多仓库 Git 任务单还必须记录只读仓库索引：`repoRoot`、`path`、`workstream`、`kind`、`parentRepo`、`branch`、`remote`、`status`、`evidence`，以及是否存在 `状态未知` 或 `未在项目中发现`。
+
 状态机至少包含：待确认、待执行、执行中、暂停待复核、待主会话复核、已完成、失败、中断、超时、阻塞、取消、需重新确认。
 
 失败、中断、超时后不得自动重试。重试必须由主会话重新确认并增加 `attempt`，不能覆盖历史交接结果。
@@ -49,6 +56,20 @@ xinyun-ai/index/session-current.md
 
 ## 数据库 / API / UI / 配置影响
 
+## 字段影响审视
+
+- 字段分类：
+- 专项路由：
+- 审视状态：
+- 检索根目录：
+- 排除目录与文件：
+- CodeGraph 状态：
+- 工具预算：
+- 证据列表：
+- 可能遗漏位置：
+- 旧数据兼容方案：
+- 是否需要用户确认：
+
 ## 验证命令
 
 ## 验收标准
@@ -87,4 +108,12 @@ xinyun-ai/index/session-current.md
 ## 是否执行过高风险操作
 
 ## 是否发现新影响范围
+
+## 字段影响审视交接
+
+- 审视状态：
+- 实际证据数量：
+- 可能遗漏位置：
+- 兼容方案变化：
+- 是否触发重新确认：
 ```

package/init/xinyun-ai-init/rules/upgrade-rules.md

@@ -20,7 +20,16 @@
 - `AGENTS.md` 是否明确 `xinyun-ai/` 为当前项目 AI 规则入口。
 - 旧 AI 规则路径不存在时，是否标注为 `当前项目未发现`，并停止引用旧会话内容。
 - 旧 AI 沉淀是否需要接管、分类和整合进 `xinyun-ai/`。
+- 旧沉淀是否按可接管、不接管、待确认分类，未确认内容是否没有进入正式规则。
+- 规则优先级是否为 `xinyun-ai/` 当前正式规则 > 当前文件系统事实 > 旧 AI 文档 > 历史会话记忆。
+- 是否需要补充中文需求解析和任务分型规则。
+- 是否需要补充 `xinyun-ai/global-review/` 按需创建规则。
 - 是否需要补充轻量框架适配识别规则。
+- 是否需要补充框架识别证据路径、证据类型、发现预算、`状态未知` 和 `未在项目中发现` 语义。
+- 是否需要补充多仓库 Git 只读索引字段：`repoRoot`、`path`、`workstream`、`kind`、`parentRepo`、`branch`、`remote`、`status`、`evidence`。
+- 是否需要补充字段影响审视、字段任务分型和字段专项路由规则。
 - 当前 `xinyun-ai/manifest.json` 的版本是否低于初始化包版本。
 
 涉及正式规则、目录结构、索引结构或旧规则合并时，必须先确认。
+
+升级不自动迁移全部旧 AI 文档，不会自动覆盖现有正式规则，也不会因为补充全局审视规则而在首次极速初始化阶段强制创建全局审视目录。

package/init/xinyun-ai-init/templates/AGENTS.template.md

@@ -6,6 +6,8 @@
 
 如果旧规则路径在当前文件系统中不存在，必须标注为 `当前项目未发现`，不得引用历史会话中的旧内容。如旧规则与 `xinyun-ai/` 冲突，以 `xinyun-ai/` 为准。
 
+规则优先级：`xinyun-ai/` 当前正式规则 > 当前文件系统事实 > 旧 AI 文档 > 历史会话记忆。历史会话记忆不得覆盖当前文件系统事实，也不得补写文件系统中不存在的旧规则路径。
+
 ## 旧沉淀接管
 
 如果项目中已经存在旧 AI 沉淀，如旧 `AGENTS.md`、`docs/`、`CLAUDE.md`、`.cursor/`、旧提示词、旧规则文件或旧工作台记录，AI 应先梳理这些内容，再把有长期价值的部分整合进 `xinyun-ai/`。
@@ -14,6 +16,8 @@
 
 临时聊天、无关内容、明显过期内容和无法确认的内容不进入正式沉淀；不存在的旧路径必须标注为 `当前项目未发现`。
 
+旧 AI 沉淀必须先识别、再分类、再接管。分类为：可接管、不接管、待确认。未确认内容不得直接写入正式规则；本包只做规则和模板接管，不创建自动迁移脚本，不自动覆盖现有正式规则。
+
 ## 改动计划与执行确认
 
 任何代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程修改前，AI 必须先输出改动计划，并等待用户明确确认。
@@ -32,6 +36,36 @@
 
 执行过程中发现新增影响范围、计划外文件、计划外数据库 / API / UI / 配置影响、计划外高风险操作或验收标准变化时，必须暂停并重新确认。
 
+## 中文需求解析与任务分型
+
+需求模糊、涉及改动或出现高风险词时，先做中文需求语义规范化；普通咨询不强制输出完整解析结构。
+
+解析格式：
+
+```md
+## 中文需求解析
+
+- 用户原话：
+- AI 理解：
+- 任务类型：
+- 影响对象：
+- 可能涉及：
+- 不确定点：
+- 风险词：
+- 是否需要追问：
+- 下一步处理方式：
+```
+
+任务类型至少包括：问题排查、新功能开发、UI 调整、API / 接口调整、数据库 / SQL、商业逻辑、Git / 发布、文档沉淀、规则调整、临时咨询。
+
+字段变更类任务必须细分为：数据库字段新增 / 删除 / 重命名、字段类型或含义变更、API 字段调整、字段展示或渲染调整，并路由到字段影响审视 / 普通改动计划 / SQL 提醒 / 业务流程理解。
+
+高歧义表达包括：优化一下、处理一下、不对、怪怪的、照之前、顺便、差不多、参考一下。
+
+高风险词包括：订单、支付、退款、优惠券、会员、权益、金额、积分、分润、提现、结算、权限、删除、批量、发布、回滚。
+
+高歧义需求最多追问 1-3 个关键问题；高风险词触发更严格的业务理解、问题排查、Git / 发布门禁或 SQL 提醒，不得直接进入代码修改。
+
 ## 前端与 Git 安全边界
 
 前端组件调用、框架 API 和交互能力优先使用官方组件、官方 API、官方推荐写法或项目已有封装。微信小程序、uni-app、Vue2、Vue3、React 等框架中，能用官方能力解决的，不优先引入第三方组件或自造工具。
@@ -50,6 +84,12 @@
 
 未获用户明确确认前，AI 不得自动执行 `commit`、`tag`、`push`、`pull`、`merge`、`rebase`、`reset`、`checkout` 回滚或切分支。
 
+多仓库 Git 只读索引最多向下发现 4 层目录、记录 20 个仓库候选和 200 个目录 / 文件条目；仓库索引必须包含 `repoRoot`、`path`、`workstream`、`kind`、`parentRepo`、`branch`、`remote`、`status`、`evidence`。预算内无证据标注 `未在项目中发现`；超预算、权限不足、路径不可读或状态无法确认标注 `状态未知`。
+
+ThinkPHP、uni-app、微信小程序轻量识别每个端口最多发现 3 层目录、读取 20 个关键文件。正向识别必须输出证据路径和证据类型；预算内无证据标注 `未在项目中发现`；超预算、权限不足或路径不可读标注 `状态未知` 和 `覆盖范围：部分`；不得混用 uni-app 与原生微信小程序规则。
+
+字段新增、删除、重命名、类型变化、含义变化、API 映射变化或前端展示变化时，必须先做字段影响审视，区分数据库字段 / API 字段 / 前端展示字段，说明检索根目录、排除项、CodeGraph 状态、证据列表、覆盖范围、可能遗漏、旧数据兼容方案、风险和确认状态。每个端口最多检查 300 个候选文件、1000 条匹配结果和 50 条证据记录；未确认前不得执行 SQL、migration、seed、批量数据修复或接口兼容改动。
+
 复杂改动可使用双会话执行闭环。主会话负责理解中文需求、识别任务类型和影响范围、生成改动计划、等待用户确认、生成执行任务单、复核执行结果并输出最终交付结论。执行会话负责读取任务单、只在确认范围内执行、进行必要验证、输出执行交接单、不创建第三个会话、不自行扩大范围。
 
 双会话文件契约：`xinyun-ai/current-task.md` 由主会话维护；`xinyun-ai/index/session-current.md` 是主会话创建的临时执行任务单，执行会话只读；`xinyun-ai/handoffs/current-execution.md` 是执行会话写入的执行交接单，主会话只读复核。
@@ -58,6 +98,16 @@
 
 交付输出先给状态结论：已完成 / 部分完成 / 阻塞 / 需重新确认；说明实际创建、更新、未创建或未修改内容、验证结果、风险、未完成事项和下一步动作。少复述规则，不输出明显 AI 话术。
 
+## 全局影响审视
+
+新功能、大改、重构、跨端改动、目录 / 规则 / 索引调整、数据库 / API / UI 联动变更、涉及多会话交接的复杂任务，必须先做全局影响审视。
+
+小改可以只在改动计划中简写全局影响；首次极速初始化不强制创建 `xinyun-ai/global-review/`。
+
+全局审视最小字段包括：`reviewId`、触发原因、关联任务、影响层、已确认内容、推断内容、待确认内容、风险点、后续动作、创建时间、更新时间。
+
+需要落盘时按需创建或更新 `xinyun-ai/global-review/`、`xinyun-ai/global-review/index.json`，并同步 `xinyun-ai/index/project-index.json`。全局审视不代替改动计划，也不会授权 AI 直接修改业务代码。
+
 AI 接手本项目时，请先读取：
 
 - `xinyun-ai/README.md`

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

@@ -7,6 +7,8 @@
 - 旧 AI 文档、旧 docs、旧提示词、旧规则文件只作为历史线索，不作为执行依据。
 - 如果旧规则路径在当前文件系统中不存在，必须标注为 `当前项目未发现`，不得引用历史会话中的旧内容。
 - 如旧规则与 `xinyun-ai/` 冲突，以 `xinyun-ai/` 为准。
+- 规则优先级：`xinyun-ai/` 当前正式规则 > 当前文件系统事实 > 旧 AI 文档 > 历史会话记忆。
+- 历史会话记忆不得覆盖当前文件系统事实，也不得补写文件系统中不存在的旧规则路径。
 
 ## 旧沉淀接管
 
@@ -15,6 +17,12 @@
 - 临时聊天、无关内容、明显过期内容和无法确认的内容不进入正式沉淀。
 - 不存在的旧路径必须标注为 `当前项目未发现`。
 - 旧沉淀接管完成后，仍以 `xinyun-ai/` 为唯一正式入口。
+- 旧 AI 沉淀必须按“先识别、再分类、再接管”的顺序处理。
+- 接管分类为：可接管、不接管、待确认。
+- 可接管内容：项目导读、规则入口、需求沉淀、问题记录、框架线索、当前任务线索、可复用经验候选。
+- 不接管内容：临时聊天、普通闲聊、无关内容、明显过期内容、无法确认来源的结论、敏感信息。
+- 待确认内容：来源不明、与当前项目文件冲突、无法验证或需要用户判断的内容。
+- 未确认内容不得直接写入正式规则；本包只做规则和模板接管，不创建自动迁移脚本，不自动覆盖现有正式规则。
 
 ## 初始化授权边界
 
@@ -73,6 +81,33 @@
 
 - 涉及功能、业务流程、API、数据库、页面、组件、交互或样式时，出计划前先做轻量需求理解。
 - 信息不足时，最多问 1-3 个关键问题。
+- 需求模糊、涉及改动或出现高风险词时，先做中文需求语义规范化；普通咨询不强制输出完整解析结构。
+- 中文需求解析格式必须保留用户原话，并包含 AI 理解、任务类型、影响对象、可能涉及、不确定点、风险词、是否需要追问和下一步处理方式。
+- 任务类型至少包括：问题排查、新功能开发、UI 调整、API / 接口调整、数据库 / SQL、商业逻辑、Git / 发布、文档沉淀、规则调整、临时咨询。
+- 字段变更类任务必须细分为：数据库字段新增 / 删除 / 重命名、字段类型或含义变更、API 字段调整、字段展示或渲染调整。
+- 字段相关需求必须输出字段分类和专项路由：字段影响审视 / 普通改动计划 / SQL 提醒 / 业务流程理解。
+- 字段影响审视触发后必须说明影响对象、检索范围、证据、待确认位置和下一步处理方式；信息不足时最多追问 1-3 个关键问题。
+- 高歧义表达包括：优化一下、处理一下、不对、怪怪的、照之前、顺便、差不多、参考一下。
+- 高风险词包括：订单、支付、退款、优惠券、会员、权益、金额、积分、分润、提现、结算、权限、删除、批量、发布、回滚。
+- 高歧义需求最多追问 1-3 个关键问题；信息足够时直接进入对应任务流程。
+- 高风险词触发更严格的业务理解、问题排查、Git / 发布门禁或 SQL 提醒，不得直接进入代码修改。
+
+中文需求解析格式：
+
+```md
+## 中文需求解析
+
+- 用户原话：
+- AI 理解：
+- 任务类型：
+- 影响对象：
+- 可能涉及：
+- 不确定点：
+- 风险词：
+- 是否需要追问：
+- 下一步处理方式：
+```
+
 - UI 类需求至少判断前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及。
 - UI 类需求还必须判断页面类型：生产页面 / 原型页面 / 营销页面 / 不涉及。
 - 如果当前 AI 工具有需求分析、原型、UI 交互、截图风格识别等 Skill，仅在任务明确匹配时调用对应 Skill；不得因为普通开发任务默认启用所有 Skill。
@@ -120,6 +155,10 @@
 - AI 可以读取 Git 状态、总结 diff、建议 commit message 和 tag。
 - 未获用户明确确认前，不得自动执行 `commit`、`tag`、`push`、`pull`、`merge`、`rebase`、`reset`、`checkout` 回滚或切分支。
 - 多端多仓库改动后，应按仓库分别输出交付摘要和建议 commit message。
+- 多仓库 Git 只读索引最多向下发现 4 层目录、记录 20 个仓库候选和 200 个目录 / 文件条目。
+- Git 仓库索引必须覆盖根仓库、嵌套 `.git`、子模块和 worktree，并记录 `repoRoot`、`path`、`workstream`、`kind`、`parentRepo`、`branch`、`remote`、`status`、`evidence`。
+- Git 只读索引全程禁止 `commit`、`tag`、`push`、`pull`、`merge`、`rebase`、`reset`、`checkout`、`switch`、回滚和切分支。
+- 预算内无 Git 证据时标注 `未在项目中发现`；超预算、权限不足、路径不可读或状态无法确认时标注 `状态未知`，不得判断为无 Git。
 
 ## 框架适配
 
@@ -131,6 +170,58 @@
 - 不为确认框架做全量 grep 或追完整调用链。
 - 如需进一步确认，放到后续任务按需补齐。
 - 未识别到对应框架时，不强行套用该框架规则。
+- 每个端口从端口根目录向下最多发现 3 层目录，最多读取 20 个关键文件。
+- 正向识别必须输出证据路径和证据类型，如依赖、配置、入口、目录结构、代码特征。
+- 预算内无识别证据时标注 `未在项目中发现`；超预算、权限不足或路径不可读时标注 `状态未知` 和 `覆盖范围：部分`。
+- 不把 uni-app 规则套到原生微信小程序，也不把微信小程序规则套到 uni-app。
+
+框架识别输出建议：
+
+```md
+## 轻量框架识别
+- workstream：
+- 框架候选：
+- 识别状态：已确认 / 推断 / 待确认 / 未在项目中发现 / 状态未知
+- 覆盖范围：完整 / 部分
+- 发现预算：目录深度 3 层、关键文件 20 个
+- 证据：路径、证据类型、命中内容摘要
+- 未检查范围：
+```
+
+## 字段变更影响审视
+
+- 字段新增、删除、重命名、类型变化、含义变化、API 映射变化或前端展示变化，必须先做字段影响审视。
+- 字段影响审视必须区分数据库字段、API 字段和前端展示字段。
+- 检查范围包括数据库表结构、migration、Model、Entity、ORM、查询写入、Service、DAO、参数校验、状态流转、计算、缓存、队列、API 请求 / 响应 / DTO / Serializer / 文档、各端表单 / 列表 / 详情 / 表格 / 筛选 / 状态 / 格式化 / 图表 / 导出 / 打印、Mock / Seed / 测试数据 / 空值 / 旧值 / 默认值 / 历史数据 / 兼容性。
+- 检索根目录为项目根目录和已确认端口 / workstream 根目录。
+- 每个端口最多检查 300 个候选文件、1000 条匹配结果和 50 条证据记录。
+- 排除 `node_modules`、`dist`、`build`、`vendor`、`.git`、`.codegraph`、`storage`、`runtime`、`unpackage`、`coverage`、二进制文件和明确生成目录。
+- CodeGraph 可用时，结构性影响优先使用 CodeGraph；CodeGraph 不可用时，降级为入口文件、配置文件、结构化检索和限定范围文本检索，并标注降级状态。
+- 动态 SQL、动态字段名、序列化、反射和生成代码无法确认时，列为 `待确认` 或 `可能遗漏位置`。
+- 超过预算时停止扩展检索，标注 `审视状态：部分覆盖`、`状态未知` 和 `可能遗漏位置`。
+- 只改展示方式时，不得顺手修改数据库和 API。
+- 未确认前不得执行 SQL、migration、seed、批量数据修复或接口兼容改动。
+
+字段影响审视输出契约：
+
+```md
+## 字段影响审视
+- 审视状态：完整覆盖 / 部分覆盖 / 状态未知
+- 字段分类：数据库字段 / API 字段 / 前端展示字段
+- 字段名称与原含义：
+- 调整后含义：
+- 检索根目录：
+- 排除目录与文件：
+- CodeGraph 状态：可用 / 不可用 / 降级
+- 降级原因：
+- 工具预算：
+- 证据列表：路径、位置、匹配内容、判断状态
+- 已覆盖范围：
+- 可能遗漏位置：
+- 旧数据兼容方案：
+- 最终风险：
+- 是否需要用户确认：
+```
 
 ## 理解深度状态
 
@@ -151,6 +242,11 @@
 - 需要落盘时按需创建或更新 `xinyun-ai/global-review/`。
 - 全局审视不代替改动计划，它是改动计划前的影响检查。
 - 建议审视入口层、目录层、索引层、任务层、规则层、多端层、数据层、API 层、UI 层、验证层和交接层。
+- 首次极速初始化不强制创建 `xinyun-ai/global-review/`。
+- 触发条件包括：新功能、大范围修改、重构、跨端改动、目录 / 规则 / 索引调整、数据库 / API / UI 联动变更、涉及多会话交接的复杂任务。
+- 全局审视最小字段包括：`reviewId`、触发原因、关联任务、影响层、已确认内容、推断内容、待确认内容、风险点、后续动作、创建时间、更新时间。
+- 创建或更新全局审视后，应同步 `xinyun-ai/global-review/index.json` 和 `xinyun-ai/index/project-index.json`。
+- 全局审视不会授权 AI 直接修改业务代码。
 
 ## 双会话执行闭环（MVP）