@pm_zhousl/xinyun-ai-init 1.3.0 → 1.5.0

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

@@ -26,8 +26,10 @@
 
 ## 初始化授权边界
 
-- 用户发送 `xinyun-ai-init` 一句话入口后，视为已授权 AI 创建或补齐最小 `xinyun-ai/` 与极简 `AGENTS.md`。
+- 用户发送 `xinyun-ai-init` 一句话入口后，视为已授权 AI 创建或补齐最小 `xinyun-ai/`、`xinyun-ai/team/` 与极简 `AGENTS.md`。
 - 该授权不包含业务代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程修改。
+- `xinyun-ai/team/**` 属于 AI 工作区控制文件，只创建本地逻辑角色、待绑定成员槽位、职责确认记录和角色理解记录，不自动创建外部账号、外部 AI 会话或无限会话。
+- 未绑定真实人员或会话时，`personId`、`sessionId`、`memberId`、`confirmedBy` 使用 `null`，不得虚构。
 
 ## 改动计划与执行确认
 
@@ -84,6 +86,9 @@
 - 需求模糊、涉及改动或出现高风险词时，先做中文需求语义规范化；普通咨询不强制输出完整解析结构。
 - 中文需求解析格式必须保留用户原话，并包含 AI 理解、任务类型、影响对象、可能涉及、不确定点、风险词、是否需要追问和下一步处理方式。
 - 任务类型至少包括：问题排查、新功能开发、UI 调整、API / 接口调整、数据库 / SQL、商业逻辑、Git / 发布、文档沉淀、规则调整、临时咨询。
+- 字段变更类任务必须细分为：数据库字段新增 / 删除 / 重命名、字段类型或含义变更、API 字段调整、字段展示或渲染调整。
+- 字段相关需求必须输出字段分类和专项路由：字段影响审视 / 普通改动计划 / SQL 提醒 / 业务流程理解。
+- 字段影响审视触发后必须说明影响对象、检索范围、证据、待确认位置和下一步处理方式；信息不足时最多追问 1-3 个关键问题。
 - 高歧义表达包括：优化一下、处理一下、不对、怪怪的、照之前、顺便、差不多、参考一下。
 - 高风险词包括：订单、支付、退款、优惠券、会员、权益、金额、积分、分润、提现、结算、权限、删除、批量、发布、回滚。
 - 高歧义需求最多追问 1-3 个关键问题；信息足够时直接进入对应任务流程。
@@ -152,6 +157,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。
 
 ## 框架适配
 
@@ -163,6 +172,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 状态：可用 / 不可用 / 降级
+- 降级原因：
+- 工具预算：
+- 证据列表：路径、位置、匹配内容、判断状态
+- 已覆盖范围：
+- 可能遗漏位置：
+- 旧数据兼容方案：
+- 最终风险：
+- 是否需要用户确认：
+```
 
 ## 理解深度状态
 
@@ -189,6 +250,116 @@
 - 创建或更新全局审视后，应同步 `xinyun-ai/global-review/index.json` 和 `xinyun-ai/index/project-index.json`。
 - 全局审视不会授权 AI 直接修改业务代码。
 
+## AI 项目团队与责任闭环
+
+- 初始化时必须创建 `xinyun-ai/team/`。
+- 默认逻辑角色为：`project-owner`、`project-product`、`chief-engineer`、`programmer`、`test-reviewer`。
+- 首次必须创建 5 个 JSON 配置：`roles.json`、`members.json`、`assignments.json`、`responsibility-matrix.json`、`file-ownership.json`。
+- 首次必须创建 5 份职责确认记录：`confirmations/<roleId>.md`，文件名必须使用 `roleId`。
+- 首次必须创建 5 份角色理解记录：`understandings/<roleId>.md`，文件名必须使用 `roleId`。
+- `roles.json` 的 `roleId` 必须全局唯一；所有 ID 必须唯一。
+- `members.json` 未绑定时 `personId` 和 `sessionId` 必须为 `null`，不得虚构真实人员或会话。
+- `confirmations/<roleId>.md` 和 `understandings/<roleId>.md` 的 `createdAt`、`updatedAt` 必须存在且为 ISO 8601 时间；首次落盘可使用模板初始时间或替换为当前时间，但不得留空。
+- `xinyun-ai/manifest.json` 必须包含 `capabilities.teamResponsibilityClosure: true`，并登记 team 的 8 个路径：`directory`、`roles`、`members`、`assignments`、`responsibilityMatrix`、`fileOwnership`、`understandingsDirectory`、`confirmationsDirectory`。
+- `xinyun-ai/index/project-index.json` 必须登记 `team.enabled`、`directory`、`roleCount=5`、`confirmationCount=5`、`status=pending-confirmation` 和同名 `paths`。
+- 注册路径必须与实际文件系统路径逐项一致。
+
+角色职责：
+
+- 项目负责人负责需求最终确认、业务验收和发布授权。
+- 项目产品负责需求整理、任务拆分和产品验收建议，不拥有技术最终确认权或发布授权权。
+- 总工 / 技术负责人负责技术方案、架构风险和技术最终确认。
+- 程序员按确认范围执行代码、配置和测试任务。
+- 测试审查员独立测试、发布阻断判断和测试结论，不修改代码。
+
+状态分层：
+
+- 角色生命周期：`unassigned`、`assigned`、`onboarding`、`ready`、`blocked`、`disabled`。
+- 职责确认状态：`pending`、`confirmed`、`adjustment-required`。
+- 任务分配状态：`pending`、`assigned`、`accepted`、`executing`、`paused`、`blocked`、`completed`、`cancelled`。
+- `status=paused` 时必须填写 `pauseReason`，允许值至少包括 `out-of-scope`、`awaiting-confirmation`、`execution-failed`、`user-requested`；其他状态的 `pauseReason` 必须为 `null`。
+- 确认人不可用或发生成员冲突时使用 `status=blocked`，并填写 `blockedReason=approver-unavailable` 或 `blockedReason=member-conflict`。
+
+可执行前置条件：
+
+- 成员已绑定。
+- 角色生命周期为 `ready`。
+- 职责确认状态为 `confirmed`。
+- 角色理解记录为 `ready`。
+- 任务执行人和确认人不冲突。
+- 角色理解记录不等于代码修改授权；即使 `executionEligible=true`，仍必须有已确认任务单。
+
+成员级确认冲突：
+
+- 执行人不得直接作为自己的最终确认人。
+- 最终确认关系必须在任务分配记录中落到成员 ID。
+- `memberId` 不得等于 `technicalApproverMemberId`、`businessApproverMemberId` 或 `publishAuthorizerMemberId`。
+- `roles.json` 中的默认确认角色只用于候选人推荐，不构成授权，也不能覆盖成员级冲突校验。
+- 总工为执行人时不得回落为自己确认自己。
+- 没有可用技术、业务或发布确认成员时，任务保持 `blocked` / 待分配，不得自动使用执行成员、虚构成员或空确认通过。
+- 程序员不得担任技术最终确认人、业务最终确认人或发布授权人；本版本不设置例外。
+
+角色理解记录最小字段：
+
+- `recordId`
+- `roleId`
+- `memberId`
+- `status`：`pending` / `reading` / `ready` / `partial` / `blocked`
+- `readScope`
+- `readBudget`
+- `unreadablePaths`
+- `confirmedFacts`
+- `inferences`
+- `pendingQuestions`
+- `risks`
+- `evidence`
+- `coverage`
+- `executionEligible`
+- `createdAt`
+- `updatedAt`
+
+任务责任字段：
+
+```md
+- 需求负责人：
+- 技术负责人 / 总工：
+- 执行人：
+- 测试审查人：
+- 技术最终确认人：
+- 业务最终确认人：
+- 发布授权人：
+```
+
+文件目录责任和变更核对：
+
+```md
+## 预计更新文件目录
+- 文件或目录：
+- 文件类型：
+- 负责角色：
+- 执行角色：
+- 审查角色：
+- 最终确认角色：
+
+## 实际更新文件目录
+- 已修改：
+- 新增：
+- 删除：
+- 未修改：
+- 超出预计范围：
+- 是否需要重新确认：
+```
+
+- 目录记录以相对 `repoRoot` 的正斜线路径为准，跨仓库必须分别记录。
+- 文件、目录、通配符分别通过 `pathType` 标注；`pathType` 只能是 `file`、`directory` 或 `glob`。
+- 路径不得包含 `..`。
+- 删除和重命名必须记录旧路径，重命名还必须记录新路径。
+- 生成文件必须列出实际输出路径。
+- `xinyun-ai/team/**`、`xinyun-ai/current-task.md`、`xinyun-ai/index/session-current.md`、`xinyun-ai/handoffs/**` 属于控制文件，计入实际更新记录，但与业务代码修改分栏统计。
+- 实际目录通过文件清单和 diff 只读核对。
+- 发现未授权路径后，任务状态改为 `paused`、`pauseReason=out-of-scope`，记录责任人、发现人、影响范围和重新确认人。
+- 不得使用未定义状态 `paused-out-of-scope`。
+
 ## 双会话执行闭环（MVP）
 
 - 复杂改动可使用一个主会话 + 一个执行会话的手工协作闭环；普通咨询、只读分析和不涉及文件修改的任务仍可使用单会话。

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

@@ -6,6 +6,8 @@
   - 用户原话：
   - AI 理解：
   - 任务类型：
+  - 字段任务分型：
+  - 字段专项路由：
   - 影响对象：
   - 可能涉及：
   - 不确定点：
@@ -31,6 +33,38 @@
   - 推断内容：
   - 待确认内容：
 - Git 模式与仓库影响：
+- 多仓库 Git 只读索引：
+  - repoRoot：
+  - path：
+  - workstream：
+  - kind：
+  - parentRepo：
+  - branch：
+  - remote：
+  - status：
+  - evidence：
+- 轻量框架识别：
+  - workstream：
+  - 框架候选：
+  - 识别状态：
+  - 覆盖范围：
+  - 发现预算：
+  - 证据：
+  - 未检查范围：
+- 字段影响审视：
+  - 审视状态：
+  - 字段分类：
+  - 字段名称与原含义：
+  - 调整后含义：
+  - 检索根目录：
+  - 排除目录与文件：
+  - CodeGraph 状态：
+  - 证据列表：
+  - 已覆盖范围：
+  - 可能遗漏位置：
+  - 旧数据兼容方案：
+  - 最终风险：
+  - 是否需要用户确认：
 - 前端官方组件 / API 选型：
 - 双会话执行：
   - taskId：
@@ -41,6 +75,40 @@
   - status：
   - 执行任务单：
   - 执行交接单：
+- 团队责任闭环：
+  - 需求负责人：
+  - 技术负责人 / 总工：
+  - 执行人：
+  - 测试审查人：
+  - 技术最终确认人：
+  - 业务最终确认人：
+  - 发布授权人：
+  - memberId：
+  - reviewerMemberId：
+  - technicalApproverMemberId：
+  - businessApproverMemberId：
+  - publishAuthorizerMemberId：
+  - blockedReason：
+  - pauseReason：
+  - memberId 冲突检查：
+  - 职责确认状态：
+  - 角色理解状态：
+- 预计更新文件目录：
+  - 文件或目录：
+  - 文件类型：
+  - 负责角色：
+  - 执行角色：
+  - 审查角色：
+  - 最终确认角色：
+- 实际更新文件目录：
+  - 已修改：
+  - 新增：
+  - 删除：
+  - 未修改：
+  - 超出预计范围：
+  - 是否需要重新确认：
+  - 控制文件：
+  - 业务代码：
 - 交付状态：
 - 未完成事项：
 - 下一步动作：

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

@@ -1,6 +1,6 @@
 {
   "projectName": "",
-  "xinyunAiVersion": "1.3.0",
+  "xinyunAiVersion": "1.5.0",
   "scriptVersion": "2026.07.16",
   "schemaVersion": "1",
   "initializationMode": "fast",
@@ -26,6 +26,21 @@
     "unifiedEntryPriority": true,
     "legacyHandoffClassification": true,
     "globalReview": true,
-    "chineseRequirementParsing": true
+    "chineseRequirementParsing": true,
+    "frameworkEvidenceBudget": true,
+    "readonlyGitRepositoryIndex": true,
+    "boundedFieldImpactReview": true,
+    "fieldChangeRequirementRouting": true,
+    "teamResponsibilityClosure": true
+  },
+  "team": {
+    "directory": "xinyun-ai/team/",
+    "roles": "xinyun-ai/team/roles.json",
+    "members": "xinyun-ai/team/members.json",
+    "assignments": "xinyun-ai/team/assignments.json",
+    "responsibilityMatrix": "xinyun-ai/team/responsibility-matrix.json",
+    "fileOwnership": "xinyun-ai/team/file-ownership.json",
+    "understandingsDirectory": "xinyun-ai/team/understandings/",
+    "confirmationsDirectory": "xinyun-ai/team/confirmations/"
   }
 }

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

@@ -15,6 +15,7 @@
 - 配置线索：待填写
 - 测试体系线索：待填写
 - Git 模式与仓库线索：待填写
+- 多仓库 Git 只读索引：待填写
 - 已有 AI 痕迹：待填写
 - 旧 AI 沉淀来源：待填写
 - 可接管内容：待填写
@@ -23,8 +24,26 @@
 - 不存在的旧路径：待填写
 - 规则入口优先级：待填写
 - 中文需求解析触发情况：待填写
+- 字段变更任务分型与专项路由：待填写
 - 全局影响审视触发情况：待填写
 - 轻量框架识别：待填写
+  - 证据路径与证据类型：待填写
+  - 发现预算与覆盖范围：待填写
+- 字段影响审视：待填写
+  - 字段分类：待填写
+  - 检索根目录与排除项：待填写
+  - CodeGraph 状态与降级说明：待填写
+  - 证据、可能遗漏和兼容方案：待填写
+- AI 项目团队与责任闭环：待填写
+  - `xinyun-ai/team/` 是否创建：待填写
+  - 5 个 JSON 配置是否可解析：待填写
+  - 5 份 `confirmations/<roleId>.md` 是否存在：待填写
+  - 5 份 `understandings/<roleId>.md` 是否存在：待填写
+  - `manifest.json` team 路径注册：待填写
+  - `project-index.json` team 路径注册：待填写
+  - 未绑定成员是否使用 `null`：待填写
+  - 自确认 memberId 冲突阻断：待填写
+  - 超范围暂停是否为 `status=paused` + `pauseReason=out-of-scope`：待填写
 
 ## 待确认问题
 

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

@@ -40,6 +40,8 @@
 - 用户原话：待填写。
 - AI 理解：待填写。
 - 任务类型：待填写。
+- 字段任务分型：待填写。
+- 字段专项路由：待填写。
 - 影响对象：待填写。
 - 风险词：待填写。
 - 是否需要追问：待填写。
@@ -64,9 +66,36 @@
 
 待填写。
 
+## 多仓库 Git 只读索引
+
+- Git 模式：待填写。
+- 发现预算：最多 4 层、20 个仓库候选、200 个目录 / 文件条目。
+- 仓库记录字段：`repoRoot`、`path`、`workstream`、`kind`、`parentRepo`、`branch`、`remote`、`status`、`evidence`。
+- 只读状态：待填写。
+- 未确认 / 状态未知范围：待填写。
+
 ## 轻量框架识别结果
 
-待填写。
+- 识别预算：每端最多 3 层目录、20 个关键文件。
+- ThinkPHP：待填写。
+- uni-app：待填写。
+- 微信小程序：待填写。
+- 证据路径和证据类型：待填写。
+- 覆盖范围：待填写。
+- 未检查范围：待填写。
+
+## 字段影响审视
+
+- 是否触发：待填写。
+- 字段分类：数据库字段 / API 字段 / 前端展示字段 / 未确认。
+- 审视状态：完整覆盖 / 部分覆盖 / 状态未知。
+- 检索根目录：待填写。
+- 排除目录与文件：待填写。
+- CodeGraph 状态：待填写。
+- 证据列表：待填写。
+- 可能遗漏位置：待填写。
+- 旧数据兼容方案：待填写。
+- 确认状态：待填写。
 
 ## 数据库、API、测试体系发现情况
 
@@ -76,9 +105,26 @@
 
 - 初始化模式：待填写。
 - 已创建或更新文件：待填写。
+- AI 项目团队：待填写。
+- 团队路径注册：待填写。
+- 角色数量：待填写。
+- 职责确认记录数量：待填写。
+- 角色理解记录数量：待填写。
 - 是否接管旧沉淀：待填写。
 - 是否有待确认项：待填写。
 
+## AI 项目团队与责任闭环
+
+- 团队目录：`xinyun-ai/team/`
+- 角色：项目负责人、项目产品、总工、程序员、测试审查员。
+- 当前状态：pending-confirmation。
+- 未绑定成员：待填写。
+- 职责确认：待填写。
+- 角色理解：待填写。
+- 成员级自确认阻断：待填写。
+- 文件目录责任：待填写。
+- 超范围暂停规则：`status=paused` + `pauseReason=out-of-scope`。
+
 ## CodeGraph 与索引状态
 
 待填写。

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

@@ -8,6 +8,33 @@
   },
   "database": "unknown",
   "api": "unknown",
+  "frameworks": {
+    "frameworkEvidenceBudget": true,
+    "evidenceBudget": {
+      "maxDepthPerWorkstream": 3,
+      "maxKeyFilesPerWorkstream": 20
+    },
+    "records": []
+  },
+  "gitRepositories": {
+    "mode": "unknown",
+    "readonly": true,
+    "discoveryBudget": {
+      "maxDepth": 4,
+      "maxCandidates": 20,
+      "maxEntries": 200
+    },
+    "records": []
+  },
+  "fieldImpactReview": {
+    "enabled": true,
+    "budgetPerWorkstream": {
+      "maxCandidateFiles": 300,
+      "maxMatches": 1000,
+      "maxEvidence": 50
+    },
+    "records": []
+  },
   "tests": "unknown",
   "handoffs": {
     "activeTask": "none",
@@ -38,5 +65,28 @@
     "trigger": "ambiguous_or_change_or_high_risk",
     "ordinaryConsultationRequiresFullParsing": false
   },
+  "fieldChangeRequirementRouting": {
+    "enabled": true,
+    "fieldTypes": ["数据库字段", "API 字段", "前端展示字段", "未确认"],
+    "routes": ["字段影响审视", "普通改动计划", "SQL 提醒", "业务流程理解"]
+  },
+  "team": {
+    "enabled": true,
+    "directory": "xinyun-ai/team/",
+    "roleCount": 5,
+    "confirmationCount": 5,
+    "understandingCount": 5,
+    "status": "pending-confirmation",
+    "paths": {
+      "directory": "xinyun-ai/team/",
+      "roles": "xinyun-ai/team/roles.json",
+      "members": "xinyun-ai/team/members.json",
+      "assignments": "xinyun-ai/team/assignments.json",
+      "responsibilityMatrix": "xinyun-ai/team/responsibility-matrix.json",
+      "fileOwnership": "xinyun-ai/team/file-ownership.json",
+      "understandingsDirectory": "xinyun-ai/team/understandings/",
+      "confirmationsDirectory": "xinyun-ai/team/confirmations/"
+    }
+  },
   "lastUpdatedAt": ""
 }

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

@@ -0,0 +1,40 @@
+# AI 项目团队
+
+本目录用于记录本地 AI 协作团队、职责确认、角色理解、任务责任和文件目录责任。
+
+## 初始化边界
+
+- 团队配置只创建逻辑角色和待绑定成员槽位，不自动创建外部人员账号、外部 AI 会话或无限会话。
+- 未绑定真实人员或会话时，`personId`、`sessionId`、`memberId`、`confirmedBy` 使用 `null`，不得虚构姓名或会话 ID。
+- `confirmations/<roleId>.md` 和 `understandings/<roleId>.md` 的 `createdAt`、`updatedAt` 必须存在且为 ISO 8601 时间；首次落盘可使用模板初始时间或替换为当前时间，但不得留空。
+- `xinyun-ai/team/**` 属于 AI 工作区控制文件，不授权修改业务代码、数据库、API、依赖、构建脚本或执行发布操作。
+
+## 默认角色
+
+- `project-owner`：项目负责人，负责需求最终确认、业务验收和发布授权。
+- `project-product`：项目产品，负责需求整理、任务拆分和产品验收建议。
+- `chief-engineer`：总工 / 技术负责人，负责技术方案、架构风险和技术最终确认。
+- `programmer`：程序员，按确认范围执行代码、配置和测试任务。
+- `test-reviewer`：测试审查员，独立测试、发布阻断判断和测试结论，不修改代码。
+
+## 状态规则
+
+- 角色生命周期：`unassigned`、`assigned`、`onboarding`、`ready`、`blocked`、`disabled`。
+- 职责确认状态：`pending`、`confirmed`、`adjustment-required`。
+- 任务分配状态：`pending`、`assigned`、`accepted`、`executing`、`paused`、`blocked`、`completed`、`cancelled`。
+- `status=paused` 时必须填写 `pauseReason`，超范围统一使用 `pauseReason=out-of-scope`。
+- `status=blocked` 时必须填写 `blockedReason`，确认人不可用为 `approver-unavailable`，成员冲突为 `member-conflict`。
+- 执行人不得作为自己的技术最终确认人、业务最终确认人或发布授权人；冲突必须按 `memberId` 判断。
+
+## 文件目录责任
+
+任务开始前记录预计更新文件目录，任务完成后通过文件清单和 diff 只读核对实际更新文件目录。
+
+发现实际修改超出预计目录时，任务必须设置：
+
+```md
+status=paused
+pauseReason=out-of-scope
+```
+
+不得使用未定义状态 `paused-out-of-scope`。

package/init/xinyun-ai-init/templates/team/assignments.json

@@ -0,0 +1,33 @@
+{
+  "schemaVersion": 1,
+  "assignments": [],
+  "statusEnum": ["pending", "assigned", "accepted", "executing", "paused", "blocked", "completed", "cancelled"],
+  "pauseReasonEnum": ["out-of-scope", "awaiting-confirmation", "execution-failed", "user-requested"],
+  "blockedReasonEnum": ["approver-unavailable", "member-conflict"],
+  "memberConflictRule": "memberId must not equal technicalApproverMemberId, businessApproverMemberId, or publishAuthorizerMemberId.",
+  "recordContract": {
+    "requiredFields": [
+      "assignmentId",
+      "taskId",
+      "roleId",
+      "memberId",
+      "workstream",
+      "scope",
+      "understandingRecordId",
+      "confirmationRecordId",
+      "reviewerMemberId",
+      "technicalApproverMemberId",
+      "businessApproverMemberId",
+      "publishAuthorizerMemberId",
+      "status",
+      "blockedReason",
+      "pauseReason",
+      "createdAt",
+      "updatedAt"
+    ],
+    "pausedRule": "status=paused requires pauseReason; other statuses require pauseReason=null.",
+    "blockedRule": "status=blocked requires blockedReason=approver-unavailable or member-conflict.",
+    "executionEligibility": "member bound, role ready, responsibility confirmed, understanding ready, and executor memberId not equal to final approver member IDs."
+  },
+  "updatedAt": ""
+}

package/init/xinyun-ai-init/templates/team/confirmations/chief-engineer.md

@@ -0,0 +1,24 @@
+# 职责确认记录：chief-engineer
+
+- schemaVersion：1
+- recordId：confirmation-chief-engineer
+- roleId：chief-engineer
+- memberId：null
+- status：pending
+- responsibilityScope：技术方案、架构风险、技术最终确认
+- readScope：architecture, api, database, git, workstreams, rules
+- writeScope：xinyun-ai/global-review/, xinyun-ai/team/understandings/chief-engineer.md
+- forbiddenActions：git-push, npm-publish, execute-sql-without-confirmation
+- reviewerRoleId：test-reviewer
+- technicalApproverRoleId：null
+- businessApproverRoleId：project-owner
+- publishAuthorizerRoleId：project-owner
+- confirmedBy：null
+- confirmedAt：null
+- createdAt：2026-07-19T00:00:00.000Z
+- updatedAt：2026-07-19T00:00:00.000Z
+
+## 待确认
+
+- 总工默认不设置技术确认候选，避免角色默认值自指。
+- 总工为执行人时，不得回落为自己确认自己。

package/init/xinyun-ai-init/templates/team/confirmations/programmer.md

@@ -0,0 +1,24 @@
+# 职责确认记录：programmer
+
+- schemaVersion：1
+- recordId：confirmation-programmer
+- roleId：programmer
+- memberId：null
+- status：pending
+- responsibilityScope：按确认范围执行代码、配置和测试任务
+- readScope：assigned-workstream, framework-rules, entry-files, tests
+- writeScope：confirmed-task-scope
+- forbiddenActions：technical-final-approval, business-final-approval, publish-authorization, git-push, npm-publish
+- reviewerRoleId：test-reviewer
+- technicalApproverRoleId：chief-engineer
+- businessApproverRoleId：project-owner
+- publishAuthorizerRoleId：project-owner
+- confirmedBy：null
+- confirmedAt：null
+- createdAt：2026-07-19T00:00:00.000Z
+- updatedAt：2026-07-19T00:00:00.000Z
+
+## 待确认
+
+- 程序员不得担任技术最终确认人、业务最终确认人或发布授权人。
+- 执行范围必须来自已确认任务单。

package/init/xinyun-ai-init/templates/team/confirmations/project-owner.md

@@ -0,0 +1,24 @@
+# 职责确认记录：project-owner
+
+- schemaVersion：1
+- recordId：confirmation-project-owner
+- roleId：project-owner
+- memberId：null
+- status：pending
+- responsibilityScope：需求最终确认、业务验收、发布授权
+- readScope：requirements, delivery, release, business-acceptance
+- writeScope：
+- forbiddenActions：modify-business-code, execute-sql, git-push, npm-publish
+- reviewerRoleId：test-reviewer
+- technicalApproverRoleId：chief-engineer
+- businessApproverRoleId：null
+- publishAuthorizerRoleId：null
+- confirmedBy：null
+- confirmedAt：null
+- createdAt：2026-07-19T00:00:00.000Z
+- updatedAt：2026-07-19T00:00:00.000Z
+
+## 待确认
+
+- 需要绑定实际项目负责人或用户确认成员后才能进入 `confirmed`。
+- 项目负责人 / 用户保留业务最终确认和发布授权。

package/init/xinyun-ai-init/templates/team/confirmations/project-product.md

@@ -0,0 +1,24 @@
+# 职责确认记录：project-product
+
+- schemaVersion：1
+- recordId：confirmation-project-product
+- roleId：project-product
+- memberId：null
+- status：pending
+- responsibilityScope：需求整理、任务拆分、产品验收建议
+- readScope：requirements, current-task, project-guide, business-notes
+- writeScope：xinyun-ai/requirements/, xinyun-ai/current-task.md
+- forbiddenActions：technical-final-approval, publish-authorization, git-push, npm-publish
+- reviewerRoleId：test-reviewer
+- technicalApproverRoleId：chief-engineer
+- businessApproverRoleId：project-owner
+- publishAuthorizerRoleId：project-owner
+- confirmedBy：null
+- confirmedAt：null
+- createdAt：2026-07-19T00:00:00.000Z
+- updatedAt：2026-07-19T00:00:00.000Z
+
+## 待确认
+
+- 项目产品不拥有技术最终确认权或发布授权权。
+- 未绑定成员前不能领取需要执行权限的任务。