@pm_zhousl/xinyun-ai-init 1.1.5 → 1.1.6

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

@@ -299,6 +299,103 @@ xinyun-ai/global-review/
 - 验证层
 - 交接层
 
+## 双会话执行闭环（MVP）
+
+复杂改动可使用一个主会话 + 一个执行会话的手工协作闭环。普通咨询、只读分析和不涉及文件修改的任务仍可使用单会话。
+
+产品目标：
+
+- 当前版本只验证一个主会话 + 一个执行会话。
+- 主会话负责理解、计划、确认、派发和复核。
+- 执行会话负责按任务单执行、验证和回传交接单。
+- 只做本地文件手工交接，不自动创建外部 AI 会话，不接入 n8n。
+
+主会话职责：
+
+- 理解中文需求。
+- 识别任务类型和影响范围。
+- 生成改动计划。
+- 等待用户明确确认。
+- 生成执行任务单。
+- 复核执行结果并输出最终交付结论。
+
+执行会话职责：
+
+- 读取任务单。
+- 只在确认范围内执行。
+- 进行必要验证。
+- 输出执行交接单。
+- 不创建第三个会话。
+- 不自行扩大范围。
+
+文件契约和读写权限：
+
+- `xinyun-ai/current-task.md`：主会话维护。
+- `xinyun-ai/index/session-current.md`：主会话创建的临时执行任务单，执行会话只读；该文件不再仅作为普通会话线索。
+- `xinyun-ai/handoffs/current-execution.md`：执行会话写入的执行交接单，主会话只读复核。
+
+任务单和交接单必须记录：
+
+- `taskId`
+- `executionId`
+- `status`
+- `owner`
+- `attempt`
+- 用户确认状态
+- 创建时间
+- 更新时间
+
+任务单必须记录：
+
+- 允许修改文件
+- 禁止修改范围
+- 禁止执行的高风险操作
+- 验证命令
+- 验收标准
+- 发现新影响范围后的暂停规则
+
+交接单必须记录：
+
+- 执行前 Git 或文件状态
+- 实际修改文件
+- diff 摘要
+- 测试结果
+- 未完成事项
+- 新风险
+- 是否存在超范围修改
+
+状态机至少包含：待确认、待执行、执行中、暂停待复核、待主会话复核、已完成、失败、中断、超时、阻塞、取消、需重新确认。
+
+失败、中断、超时后不得自动重试。重试必须由主会话重新确认并增加 `attempt`，不能覆盖历史交接结果。
+
+人工启动第二会话：
+
+1. 主会话在用户确认改动计划后创建或更新 `xinyun-ai/index/session-current.md`。
+2. 用户手工新建或打开执行会话，把任务单路径和执行要求交给执行会话。
+3. 执行会话读取任务单，只在允许范围内执行。
+4. 执行会话完成后写入 `xinyun-ai/handoffs/current-execution.md`。
+5. 用户把执行结果或交接单路径回传给主会话。
+6. 主会话复核交接单、diff、验证结果和风险后，输出最终交付结论。
+
+MVP 边界：
+
+- 单项目。
+- 单活动任务。
+- 一个主会话。
+- 一个执行会话。
+- 本地文件手工交接。
+- 暂不支持第三个会话。
+- 暂不接入 n8n。
+- 暂不自动创建外部 AI 会话。
+- 普通咨询任务仍可使用单会话。
+
+与现有规则关系：
+
+- 改动计划与执行确认规则负责用户确认门禁。
+- 双会话执行闭环负责任务分派、执行和交接。
+- Git 工作区与危险操作门禁必须进入任务单和交接单。
+- `session-current.md` 统一定义为临时执行任务单。
+
 ## 会话工作台
 
 首次初始化不创建会话工作台。复杂任务中可按需创建：
@@ -307,7 +404,7 @@ xinyun-ai/global-review/
 xinyun-ai/index/session-current.md
 ```
 
-`session-current.md` 只记录本轮临时线索，不是项目事实源。会话结束前筛选：长期有价值的沉淀到正式目录，仅本轮有价值的写入 `sessions/`，无价值、误判、非项目内容不沉淀。
+`session-current.md` 在普通单会话任务中只记录本轮临时线索；在双会话执行闭环中统一作为临时执行任务单。它不是项目事实源。会话结束前筛选：长期有价值的沉淀到正式目录，仅本轮有价值的写入 `sessions/`，无价值、误判、非项目内容不沉淀。
 
 ## 自我学习
 

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

@@ -8,9 +8,15 @@ xinyun-ai/index/session-current.md
 
 规则：
 
-- `session-current.md` 只记录本轮临时线索，不是项目事实源。
+- 普通单会话任务中，`session-current.md` 只记录本轮临时线索，不是项目事实源。
+- 双会话执行闭环中，`session-current.md` 统一作为主会话创建的临时执行任务单，执行会话只读。
+- 执行会话的交接结果写入 `xinyun-ai/handoffs/current-execution.md`，主会话只读复核。
 - 不记录非项目内容、闲聊、敏感值。
 - 不记录完整搜索流水账，只记录关键文件、关键发现、待确认点、候选沉淀。
 - 如果发现旧 AI 沉淀，只记录来源路径、分类结果和是否可接管，不直接把旧内容写成事实。
 - 会话结束前必须筛选：长期有价值的沉淀到正式目录；仅本轮有价值的写入 `sessions/`；无价值、误判、非项目内容不沉淀。
 - 筛选完成后更新 `index/project-index.json`。
+
+双会话任务单至少记录：`taskId`、`executionId`、`status`、`owner`、`attempt`、用户确认状态、允许修改文件、禁止修改范围、高风险操作、验证命令、验收标准和发现新影响范围后的暂停规则。
+
+双会话交接单至少记录：执行前 Git 或文件状态、实际修改文件、diff 摘要、测试结果、未完成事项、新风险和是否存在超范围修改。

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

@@ -129,7 +129,7 @@
 
 ## 会话工作台
 
-复杂任务可按需创建 `xinyun-ai/index/session-current.md`。该文件只记录本轮临时线索，不是项目事实源。
+复杂任务可按需创建 `xinyun-ai/index/session-current.md`。普通单会话任务中，该文件只记录本轮临时线索；双会话执行闭环中，该文件统一作为临时执行任务单。它不是项目事实源。
 
 ## 通用项目全局视角
 
@@ -139,6 +139,22 @@
 - 全局审视不代替改动计划，它是改动计划前的影响检查。
 - 建议审视入口层、目录层、索引层、任务层、规则层、多端层、数据层、API 层、UI 层、验证层和交接层。
 
+## 双会话执行闭环（MVP）
+
+- 复杂改动可使用一个主会话 + 一个执行会话的手工协作闭环；普通咨询、只读分析和不涉及文件修改的任务仍可使用单会话。
+- 主会话负责理解中文需求、识别任务类型和影响范围、生成改动计划、等待用户确认、生成执行任务单、复核执行结果并输出最终交付结论。
+- 执行会话负责读取任务单、只在确认范围内执行、进行必要验证、输出执行交接单、不创建第三个会话、不自行扩大范围。
+- `xinyun-ai/current-task.md` 由主会话维护。
+- `xinyun-ai/index/session-current.md` 是主会话创建的临时执行任务单，执行会话只读；该文件不再仅作为普通会话线索。
+- `xinyun-ai/handoffs/current-execution.md` 是执行会话写入的执行交接单，主会话只读复核。
+- 任务单和交接单必须记录 `taskId`、`executionId`、`status`、`owner`、`attempt`、用户确认状态、创建时间和更新时间。
+- 任务单必须记录允许修改文件、禁止修改范围、禁止执行的高风险操作、验证命令、验收标准、发现新影响范围后的暂停规则。
+- 交接单必须记录执行前 Git 或文件状态、实际修改文件、diff 摘要、测试结果、未完成事项、新风险、是否存在超范围修改。
+- 状态机至少包含：待确认、待执行、执行中、暂停待复核、待主会话复核、已完成、失败、中断、超时、阻塞、取消、需重新确认。
+- 失败、中断、超时后不得自动重试；重试必须由主会话重新确认并增加 `attempt`，不能覆盖历史交接结果。
+- MVP 边界：单项目、单活动任务、一个主会话、一个执行会话、本地文件手工交接、暂不支持第三个会话、暂不接入 n8n、暂不自动创建外部 AI 会话。
+- 改动计划与执行确认规则负责用户确认门禁；双会话执行闭环负责任务分派、执行和交接。
+
 ## 自我学习
 
 发现可复用经验时，先记录为候选经验。候选经验必须标注来源、适用范围、可信度、状态和最后验证时间。用户确认后，才能合并进正式规则。

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

@@ -12,6 +12,14 @@
 - 全局影响审视：
 - Git 模式与仓库影响：
 - 前端官方组件 / API 选型：
+- 双会话执行：
+  - taskId：
+  - executionId：
+  - owner：
+  - attempt：
+  - 用户确认状态：
+  - 执行任务单：
+  - 执行交接单：
 - 验证结果：
 - 旧沉淀接管：
 - 本轮沉淀位置：

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

@@ -1,6 +1,6 @@
 {
   "projectName": "",
-  "xinyunAiVersion": "1.1.5",
+  "xinyunAiVersion": "1.1.6",
   "scriptVersion": "2026.07.15",
   "schemaVersion": "1",
   "initializationMode": "fast",

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

@@ -9,5 +9,10 @@
   "database": "unknown",
   "api": "unknown",
   "tests": "unknown",
+  "handoffs": {
+    "activeTask": "none",
+    "taskFile": "xinyun-ai/index/session-current.md",
+    "handoffFile": "xinyun-ai/handoffs/current-execution.md"
+  },
   "lastUpdatedAt": ""
 }

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

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

package/package.json

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

package/scripts/verify-init-package.js

@@ -129,6 +129,13 @@ function verifyInitRules() {
     "Vue2 / Vue3",
     "React",
     "第三方库",
+    "双会话执行闭环（MVP）",
+    "xinyun-ai/index/session-current.md",
+    "xinyun-ai/handoffs/current-execution.md",
+    "taskId",
+    "executionId",
+    "待主会话复核",
+    "不得自动重试",
   ]);
 
   requireIncludes("init/xinyun-ai-init/templates/AGENTS.template.md", [
@@ -152,6 +159,12 @@ function verifyInitRules() {
     "Git 工作区与危险操作门禁",
     "单仓库 / 多仓库 / 混合仓库 / 无 Git",
     "不得自动执行 `commit`、`tag`、`push`、`pull`、`merge`、`rebase`、`reset`、`checkout` 回滚或切分支",
+    "双会话执行闭环（MVP）",
+    "xinyun-ai/index/session-current.md",
+    "xinyun-ai/handoffs/current-execution.md",
+    "taskId",
+    "executionId",
+    "不得自动重试",
   ]);
 }