@pm_zhousl/xinyun-ai-init 1.3.0 → 1.5.0

package/init/xinyun-ai-init/templates/team/confirmations/test-reviewer.md

@@ -0,0 +1,24 @@
+# 职责确认记录：test-reviewer
+
+- schemaVersion：1
+- recordId：confirmation-test-reviewer
+- roleId：test-reviewer
+- memberId：null
+- status：pending
+- responsibilityScope：独立测试、发布阻断判断、测试结论
+- readScope：test-scenarios, acceptance-criteria, permissions, dangerous-actions
+- writeScope：xinyun-ai/handoffs/, xinyun-ai/team/understandings/test-reviewer.md
+- forbiddenActions：modify-business-code, execute-sql, git-push, npm-publish
+- reviewerRoleId：null
+- 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/file-ownership.json

@@ -0,0 +1,32 @@
+{
+  "schemaVersion": 1,
+  "ownerships": [],
+  "pathTypeEnum": ["file", "directory", "glob"],
+  "fileCategoryEnum": ["business-code", "control-file", "test", "config", "database", "api", "ui", "documentation", "generated"],
+  "pathRule": "path must be a forward-slash path relative to repoRoot and must not contain ..",
+  "recordContract": {
+    "requiredFields": [
+      "ownershipId",
+      "pathType",
+      "path",
+      "repoRoot",
+      "workstream",
+      "fileCategory",
+      "ownerRoleId",
+      "executorRoleId",
+      "reviewerRoleId",
+      "technicalApproverRoleId",
+      "businessApproverRoleId",
+      "createdAt",
+      "updatedAt"
+    ],
+    "controlFiles": [
+      "xinyun-ai/team/**",
+      "xinyun-ai/current-task.md",
+      "xinyun-ai/index/session-current.md",
+      "xinyun-ai/handoffs/**"
+    ],
+    "outOfScopeRule": "Actual diff outside expected paths requires status=paused and pauseReason=out-of-scope."
+  },
+  "updatedAt": ""
+}

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

@@ -0,0 +1,61 @@
+{
+  "schemaVersion": 1,
+  "members": [
+    {
+      "memberId": "member-project-owner",
+      "displayName": "项目负责人（待绑定）",
+      "memberType": "logical-slot",
+      "roleIds": ["project-owner"],
+      "personId": null,
+      "sessionId": null,
+      "status": "unassigned",
+      "createdAt": "",
+      "updatedAt": ""
+    },
+    {
+      "memberId": "member-project-product",
+      "displayName": "项目产品（待绑定）",
+      "memberType": "logical-slot",
+      "roleIds": ["project-product"],
+      "personId": null,
+      "sessionId": null,
+      "status": "unassigned",
+      "createdAt": "",
+      "updatedAt": ""
+    },
+    {
+      "memberId": "member-chief-engineer",
+      "displayName": "总工（待绑定）",
+      "memberType": "logical-slot",
+      "roleIds": ["chief-engineer"],
+      "personId": null,
+      "sessionId": null,
+      "status": "unassigned",
+      "createdAt": "",
+      "updatedAt": ""
+    },
+    {
+      "memberId": "member-programmer",
+      "displayName": "程序员（待绑定）",
+      "memberType": "logical-slot",
+      "roleIds": ["programmer"],
+      "personId": null,
+      "sessionId": null,
+      "status": "unassigned",
+      "createdAt": "",
+      "updatedAt": ""
+    },
+    {
+      "memberId": "member-test-reviewer",
+      "displayName": "测试审查员（待绑定）",
+      "memberType": "logical-slot",
+      "roleIds": ["test-reviewer"],
+      "personId": null,
+      "sessionId": null,
+      "status": "unassigned",
+      "createdAt": "",
+      "updatedAt": ""
+    }
+  ],
+  "updatedAt": ""
+}

package/init/xinyun-ai-init/templates/team/responsibility-matrix.json

@@ -0,0 +1,81 @@
+{
+  "schemaVersion": 1,
+  "matrix": [
+    {
+      "matrixId": "matrix-project-owner",
+      "roleId": "project-owner",
+      "responsibilities": ["需求最终确认", "业务验收", "发布授权"],
+      "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,
+      "confirmationStatus": "pending",
+      "confirmedBy": null,
+      "confirmedAt": null
+    },
+    {
+      "matrixId": "matrix-project-product",
+      "roleId": "project-product",
+      "responsibilities": ["需求整理", "任务拆分", "产品验收建议"],
+      "readScope": ["requirements", "current-task", "project-guide"],
+      "writeScope": ["xinyun-ai/requirements/", "xinyun-ai/current-task.md"],
+      "forbiddenActions": ["technical-final-approval", "publish-authorization"],
+      "reviewerRoleId": "test-reviewer",
+      "technicalApproverRoleId": "chief-engineer",
+      "businessApproverRoleId": "project-owner",
+      "publishAuthorizerRoleId": "project-owner",
+      "confirmationStatus": "pending",
+      "confirmedBy": null,
+      "confirmedAt": null
+    },
+    {
+      "matrixId": "matrix-chief-engineer",
+      "roleId": "chief-engineer",
+      "responsibilities": ["技术方案", "架构风险", "技术最终确认"],
+      "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",
+      "confirmationStatus": "pending",
+      "confirmedBy": null,
+      "confirmedAt": null
+    },
+    {
+      "matrixId": "matrix-programmer",
+      "roleId": "programmer",
+      "responsibilities": ["按确认范围执行代码、配置和测试任务"],
+      "readScope": ["assigned-workstream", "framework-rules", "entry-files", "tests"],
+      "writeScope": ["confirmed-task-scope"],
+      "forbiddenActions": ["technical-final-approval", "business-final-approval", "publish-authorization"],
+      "reviewerRoleId": "test-reviewer",
+      "technicalApproverRoleId": "chief-engineer",
+      "businessApproverRoleId": "project-owner",
+      "publishAuthorizerRoleId": "project-owner",
+      "confirmationStatus": "pending",
+      "confirmedBy": null,
+      "confirmedAt": null
+    },
+    {
+      "matrixId": "matrix-test-reviewer",
+      "roleId": "test-reviewer",
+      "responsibilities": ["独立测试", "发布阻断判断", "测试结论"],
+      "readScope": ["test-scenarios", "acceptance-criteria", "permissions", "dangerous-actions"],
+      "writeScope": ["xinyun-ai/handoffs/", "xinyun-ai/team/understandings/test-reviewer.md"],
+      "forbiddenActions": ["modify-business-code", "execute-sql", "git-push", "npm-publish"],
+      "reviewerRoleId": null,
+      "technicalApproverRoleId": "chief-engineer",
+      "businessApproverRoleId": "project-owner",
+      "publishAuthorizerRoleId": "project-owner",
+      "confirmationStatus": "pending",
+      "confirmedBy": null,
+      "confirmedAt": null
+    }
+  ],
+  "updatedAt": ""
+}

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

@@ -0,0 +1,71 @@
+{
+  "schemaVersion": 1,
+  "roles": [
+    {
+      "roleId": "project-owner",
+      "name": "项目负责人",
+      "roleType": "logical-role",
+      "lifecycleStatus": "unassigned",
+      "readScope": ["requirements", "delivery", "release", "business-acceptance"],
+      "writeScope": ["xinyun-ai/team/confirmations/project-owner.md"],
+      "forbiddenActions": ["modify-business-code", "execute-sql", "git-push", "npm-publish"],
+      "defaultReviewerRoleId": "test-reviewer",
+      "defaultTechnicalApproverRoleId": "chief-engineer",
+      "defaultBusinessApproverRoleId": null,
+      "defaultPublishAuthorizerRoleId": null
+    },
+    {
+      "roleId": "project-product",
+      "name": "项目产品",
+      "roleType": "logical-role",
+      "lifecycleStatus": "unassigned",
+      "readScope": ["requirements", "current-task", "project-guide", "business-notes"],
+      "writeScope": ["xinyun-ai/requirements/", "xinyun-ai/current-task.md", "xinyun-ai/team/understandings/project-product.md"],
+      "forbiddenActions": ["technical-final-approval", "publish-authorization", "git-push", "npm-publish"],
+      "defaultReviewerRoleId": "test-reviewer",
+      "defaultTechnicalApproverRoleId": "chief-engineer",
+      "defaultBusinessApproverRoleId": "project-owner",
+      "defaultPublishAuthorizerRoleId": "project-owner"
+    },
+    {
+      "roleId": "chief-engineer",
+      "name": "总工",
+      "roleType": "logical-role",
+      "lifecycleStatus": "unassigned",
+      "readScope": ["architecture", "api", "database", "git", "workstreams", "rules"],
+      "writeScope": ["xinyun-ai/team/understandings/chief-engineer.md", "xinyun-ai/global-review/"],
+      "forbiddenActions": ["git-push", "npm-publish", "execute-sql-without-confirmation"],
+      "defaultReviewerRoleId": "test-reviewer",
+      "defaultTechnicalApproverRoleId": null,
+      "defaultBusinessApproverRoleId": "project-owner",
+      "defaultPublishAuthorizerRoleId": "project-owner"
+    },
+    {
+      "roleId": "programmer",
+      "name": "程序员",
+      "roleType": "logical-role",
+      "lifecycleStatus": "unassigned",
+      "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"],
+      "defaultReviewerRoleId": "test-reviewer",
+      "defaultTechnicalApproverRoleId": "chief-engineer",
+      "defaultBusinessApproverRoleId": "project-owner",
+      "defaultPublishAuthorizerRoleId": "project-owner"
+    },
+    {
+      "roleId": "test-reviewer",
+      "name": "测试审查员",
+      "roleType": "logical-role",
+      "lifecycleStatus": "unassigned",
+      "readScope": ["test-scenarios", "acceptance-criteria", "permissions", "dangerous-actions"],
+      "writeScope": ["xinyun-ai/team/understandings/test-reviewer.md", "xinyun-ai/handoffs/"],
+      "forbiddenActions": ["modify-business-code", "execute-sql", "git-push", "npm-publish"],
+      "defaultReviewerRoleId": null,
+      "defaultTechnicalApproverRoleId": "chief-engineer",
+      "defaultBusinessApproverRoleId": "project-owner",
+      "defaultPublishAuthorizerRoleId": "project-owner"
+    }
+  ],
+  "updatedAt": ""
+}

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

@@ -0,0 +1,23 @@
+# 角色理解记录：chief-engineer
+
+- recordId：understanding-chief-engineer
+- roleId：chief-engineer
+- memberId：null
+- status：pending
+- readScope：项目结构、端口、框架、接口、数据库、Git、构建线索
+- readBudget：按任务触发读取，不全量扫描业务代码
+- unreadablePaths：
+- confirmedFacts：
+- inferences：
+- pendingQuestions：
+- risks：
+- evidence：
+- coverage：
+- executionEligible：false
+- createdAt：2026-07-19T00:00:00.000Z
+- updatedAt：2026-07-19T00:00:00.000Z
+
+## 后续动作
+
+- 绑定总工成员。
+- 完成技术范围理解和职责确认后才能技术确认。

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

@@ -0,0 +1,23 @@
+# 角色理解记录：programmer
+
+- recordId：understanding-programmer
+- roleId：programmer
+- memberId：null
+- status：pending
+- readScope：被分配端口、框架规则、入口文件、已有封装、测试方式
+- readBudget：仅读取确认任务范围内文件
+- unreadablePaths：
+- confirmedFacts：
+- inferences：
+- pendingQuestions：
+- risks：
+- evidence：
+- coverage：
+- executionEligible：false
+- createdAt：2026-07-19T00:00:00.000Z
+- updatedAt：2026-07-19T00:00:00.000Z
+
+## 后续动作
+
+- 绑定执行成员。
+- 等待已确认任务单和允许修改范围。

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

@@ -0,0 +1,23 @@
+# 角色理解记录：project-owner
+
+- recordId：understanding-project-owner
+- roleId：project-owner
+- memberId：null
+- status：pending
+- readScope：审批流程、交付结论、发布授权规则
+- readBudget：首次初始化不全量扫描业务代码
+- unreadablePaths：
+- confirmedFacts：
+- inferences：
+- pendingQuestions：
+- risks：
+- evidence：
+- coverage：
+- executionEligible：false
+- createdAt：2026-07-19T00:00:00.000Z
+- updatedAt：2026-07-19T00:00:00.000Z
+
+## 后续动作
+
+- 绑定实际确认成员。
+- 确认业务验收和发布授权边界。

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

@@ -0,0 +1,23 @@
+# 角色理解记录：project-product
+
+- recordId：understanding-project-product
+- roleId：project-product
+- memberId：null
+- status：pending
+- readScope：项目导读、需求沉淀、当前任务、业务说明
+- readBudget：首次初始化只读关键文档，不全量扫描业务代码
+- unreadablePaths：
+- confirmedFacts：
+- inferences：
+- pendingQuestions：
+- risks：
+- evidence：
+- coverage：
+- executionEligible：false
+- createdAt：2026-07-19T00:00:00.000Z
+- updatedAt：2026-07-19T00:00:00.000Z
+
+## 后续动作
+
+- 绑定产品成员。
+- 梳理当前需求和产品验收建议。

package/init/xinyun-ai-init/templates/team/understandings/test-reviewer.md

@@ -0,0 +1,23 @@
+# 角色理解记录：test-reviewer
+
+- recordId：understanding-test-reviewer
+- roleId：test-reviewer
+- memberId：null
+- status：pending
+- readScope：测试场景、验收标准、权限边界、危险操作规则
+- readBudget：优先读取测试材料和交付证据
+- unreadablePaths：
+- confirmedFacts：
+- inferences：
+- pendingQuestions：
+- risks：
+- evidence：
+- coverage：
+- executionEligible：false
+- createdAt：2026-07-19T00:00:00.000Z
+- updatedAt：2026-07-19T00:00:00.000Z
+
+## 后续动作
+
+- 绑定测试审查成员。
+- 独立复核测试结果和发布阻断项。

package/init/xinyun-ai-init/templates/workstreams-readme.template.md

@@ -19,3 +19,18 @@
 ## 端口 Git 仓库
 
 待填写。
+
+## 端口轻量框架识别
+
+- 每个端口最多发现 3 层目录、读取 20 个关键文件。
+- 正向识别记录证据路径和证据类型。
+- 预算内无证据标注 `未在项目中发现`。
+- 超预算、权限不足或路径不可读标注 `状态未知` 和 `覆盖范围：部分`。
+- 不混用 uni-app 与原生微信小程序规则。
+
+## 端口字段影响审视
+
+- 每个端口最多检查 300 个候选文件、1000 条匹配结果和 50 条证据记录。
+- 字段分类：数据库字段 / API 字段 / 前端展示字段 / 未确认。
+- 记录检索根目录、排除项、CodeGraph 状态、证据、覆盖范围、可能遗漏位置和兼容方案。
+- 未确认前不得执行 SQL、migration、seed、批量数据修复或接口兼容改动。

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pm_zhousl/xinyun-ai-init",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "欣芸技术开发 Agent 流初始化包",
   "bin": {
     "xinyun-ai-init": "bin/xinyun-ai-init.js"