@pm_zhousl/xinyun-ai-init 1.4.0 → 1.5.0

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
+
+## 待确认
+
+- 项目产品不拥有技术最终确认权或发布授权权。
+- 未绑定成员前不能领取需要执行权限的任务。

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/version.json

@@ -1,7 +1,7 @@
 {
   "packageName": "xinyun-ai-init",
   "displayName": "欣芸技术开发 Agent 流初始化包",
-  "version": "1.4.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.4.0",
+  "version": "1.5.0",
   "description": "欣芸技术开发 Agent 流初始化包",
   "bin": {
     "xinyun-ai-init": "bin/xinyun-ai-init.js"