openmatrix 0.1.53 → 0.1.55

package/dist/agents/agent-runner.d.ts

@@ -67,6 +67,12 @@ export declare class AgentRunner {
      * 构建完整的执行提示词
      */
     buildExecutionPrompt(task: Task): string;
+    /**
+     * 构建累积上下文 - 从已完成任务中提取共享信息
+     *
+     * 读取所有已完成任务的 context.md，为当前 Agent 提供前序 Agent 的决策和知识
+     */
+    private buildAccumulatedContext;
     /**
      * 构建阶段上下文
      */

package/dist/agents/agent-runner.js

@@ -1,6 +1,41 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentRunner = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
 /**
  * AgentRunner - 使用 Subagent 执行任务
  *
@@ -101,6 +136,7 @@ class AgentRunner {
     buildExecutionPrompt(task) {
         const agentPrompt = this.buildAgentPrompt(task);
         const phaseContext = this.buildPhaseContext(task);
+        const accumulatedContext = this.buildAccumulatedContext(task);
         return `# 任务执行
 
 ## 任务信息
@@ -118,6 +154,8 @@ ${task.dependencies.length > 0
             ? task.dependencies.map(d => `- ${d}`).join('\n')
             : '无依赖'}
 
+${accumulatedContext}
+
 ---
 
 ${agentPrompt.context}
@@ -130,8 +168,47 @@ ${agentPrompt.instructions}
 
 1. 完成任务后，更新任务状态文件: \`.openmatrix/tasks/${task.id}/task.json\`
 2. 将执行结果写入: \`.openmatrix/tasks/${task.id}/artifacts/result.md\`
-3. 如需审批，创建审批请求: \`.openmatrix/approvals/\` 目录
+3. 将上下文摘要写入: \`.openmatrix/tasks/${task.id}/context.md\` (供后续 Agent 读取)
+4. 如需审批，创建审批请求: \`.openmatrix/approvals/\` 目录
+`;
+    }
+    /**
+     * 构建累积上下文 - 从已完成任务中提取共享信息
+     *
+     * 读取所有已完成任务的 context.md，为当前 Agent 提供前序 Agent 的决策和知识
+     */
+    buildAccumulatedContext(currentTask) {
+        const omPath = path.join(process.cwd(), '.openmatrix');
+        const tasksDir = path.join(omPath, 'tasks');
+        try {
+            if (!fs.existsSync(tasksDir))
+                return '';
+            const contextParts = [];
+            // 读取所有已完成任务的 context.md
+            const taskDirs = fs.readdirSync(tasksDir).filter(name => name.startsWith('TASK-'));
+            for (const taskId of taskDirs) {
+                const contextFile = path.join(tasksDir, taskId, 'context.md');
+                if (fs.existsSync(contextFile)) {
+                    const content = fs.readFileSync(contextFile, 'utf-8').trim();
+                    if (content) {
+                        contextParts.push(`### ${taskId}\n${content}`);
+                    }
+                }
+            }
+            if (contextParts.length === 0)
+                return '';
+            return `
+## 前序 Agent 共享上下文 (Agent Memory)
+
+以下是之前执行的 Agent 留下的上下文信息，包含它们的决策、发现和注意事项。
+你应该基于这些信息来工作，避免重复犯错或与已有决策冲突。
+
+${contextParts.join('\n\n')}
 `;
+        }
+        catch {
+            return '';
+        }
     }
     /**
      * 构建阶段上下文

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openmatrix",
-  "version": "0.1.53",
+  "version": "0.1.55",
   "description": "AI Agent task orchestration system with Claude Code Skills integration",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/skills/auto.md

@@ -118,7 +118,32 @@ CLI 返回的 JSON 中 `subagentTasks` 数组包含每个待执行任务:
 
 ## === 执行阶段（只有此阶段才能写业务代码）===
 
-### Step 6: 逐个执行 subagentTasks
+### Step 6: 逐个执行 subagentTasks（禁止中断）
+
+<LOOP-ENFORCEMENT>
+**此步骤是执行循环，必须执行完所有任务后才能停止。**
+
+❌ **禁止在还有未完成任务时停止** — 即使 Agent 返回了大段输出，也必须继续下一个
+❌ **禁止询问"是否继续"** — 直接执行下一个任务
+❌ **禁止输出"让我知道是否..."后停止** — 继续执行
+❌ **禁止因为上下文压缩而忘记剩余任务** — 每完成一个任务后，重新读取 state.json 确认剩余任务
+
+**执行循环伪代码:**
+```
+remaining = subagentTasks 中 status !== 'completed' 的任务
+while (remaining.length > 0) {
+  task = remaining[0]
+  result = Agent(task)           // 执行
+  更新任务状态为 completed
+  remaining = 从 state.json 重新读取未完成任务
+}
+```
+
+**中断恢复:** 如果会话中断，再次执行 `/om:auto` 时:
+1. 读取 `.openmatrix/state.json`
+2. 如果 `status === 'running'`，读取所有任务，找到 status 不是 completed 的任务
+3. 从中断的任务继续执行，不需要重新开始
+</LOOP-ENFORCEMENT>
 
 对 `subagentTasks` 列表中的每个任务，调用 Agent 工具执行:
 
@@ -132,18 +157,74 @@ Agent({
 ```
 
 每个 Agent 完成后:
-1. 更新任务状态
-2. Git 自动提交:
+1. **保存 Agent 上下文** — 将执行结果摘要写入 `.openmatrix/tasks/TASK-XXX/context.md`，格式如下:
+
+```markdown
+## 任务: TASK-XXX 任务标题
+
+### 关键决策
+- [做出的重要决策]
+
+### 创建/修改的文件
+- `path/to/file1.ts` - 简述用途
+- `path/to/file2.ts` - 简述用途
+
+### 重要发现
+- [发现的问题、模式、注意事项]
+
+### 对后续任务的建议
+- [下一个 Agent 应该注意什么]
+```
+
+2. 更新任务状态
+3. **立即检查是否还有未完成任务** — 读取 `.openmatrix/state.json` 中的 statistics，如果 completed < totalTasks，继续执行下一个
+4. Git 自动提交（**必须使用 HEREDOC 格式**）:
+
+**Agent 上下文共享机制 (Agent Memory):**
+
+每个 Agent 执行时会自动接收前序 Agent 的上下文信息（通过 `context.md` 文件）。
+这确保 Agent 之间共享知识、避免重复工作、保持决策一致性。
+
+```
+Agent-1 完成 → 写入 context.md → Agent-2 读取 Agent-1 的上下文 → 写入 context.md → ...
+```
 ```bash
-git add -A
-git commit -m "feat(task-id): 任务标题
+git add -A && git commit -m "$(cat <<'EOF'
+feat: (TASK-XXX) 任务标题
 
-任务ID: TASK-XXX
-RunID: run-XXX"
+- 改动点1
+- 改动点2
+
+影响范围: 模块名
+文件改动: 文件1, 文件2
+
+Run: run-XXX
+Co-Authored-By: OpenMatrix <https://github.com/bigfish1913/openmatrix>
+EOF
+)"
 ```
 
 **在 auto 模式下不得询问用户确认，自动批准所有审批点。**
 
+**Git 提交格式规范（所有提交必须遵守）:**
+
+```
+<type>: (TASK-XXX) 简短描述
+
+- 改动点1
+- 改动点2
+
+影响范围: 模块名
+文件改动: 文件1, 文件2
+
+Run: run-XXX
+Co-Authored-By: OpenMatrix <https://github.com/bigfish1913/openmatrix>
+```
+
+**type 映射:** feat(新功能) / fix(修复) / test(测试) / refactor(重构) / docs(文档)
+**禁止使用:** `Co-Authored-By: Claude` 格式，必须使用 `Co-Authored-By: OpenMatrix <https://github.com/bigfish1913/openmatrix>`
+**禁止使用 emoji**，使用纯文本格式
+
 </process>
 
 <arguments>

package/skills/start.md

@@ -166,7 +166,27 @@ CLI 返回 JSON 中 `subagentTasks` 数组包含待执行任务。
 
 ## === 执行阶段（只有此阶段才能写业务代码）===
 
-### Step 10: 逐个执行 subagentTasks
+### Step 10: 逐个执行 subagentTasks（禁止中断）
+
+<LOOP-ENFORCEMENT>
+**此步骤是执行循环，必须执行完所有任务后才能停止。**
+
+❌ **禁止在还有未完成任务时停止** — 即使 Agent 返回了大段输出，也必须继续下一个
+❌ **禁止询问"是否继续"** — 直接执行下一个任务
+❌ **禁止输出"让我知道是否..."后停止** — 继续执行
+❌ **禁止因为上下文压缩而忘记剩余任务** — 每完成一个任务后，重新读取 state.json 确认剩余任务
+
+**执行循环伪代码:**
+```
+remaining = subagentTasks 中 status !== 'completed' 的任务
+while (remaining.length > 0) {
+  task = remaining[0]
+  result = Agent(task)           // 执行
+  更新任务状态为 completed
+  remaining = 从 state.json 重新读取未完成任务
+}
+```
+</LOOP-ENFORCEMENT>
 
 对每个任务调用 Agent 工具:
 
@@ -180,9 +200,43 @@ Agent({
 ```
 
 每个 Agent 完成后:
-1. 更新任务状态
-2. Git 自动提交
-3. 检查审批点（auto 模式自动批准，其他模式按配置暂停）
+1. **保存 Agent 上下文** — 将执行结果摘要写入 `.openmatrix/tasks/TASK-XXX/context.md`，格式如下:
+
+```markdown
+## 任务: TASK-XXX 任务标题
+
+### 关键决策
+- [做出的重要决策]
+
+### 创建/修改的文件
+- `path/to/file1.ts` - 简述用途
+- `path/to/file2.ts` - 简述用途
+
+### 重要发现
+- [发现的问题、模式、注意事项]
+
+### 对后续任务的建议
+- [下一个 Agent 应该注意什么]
+```
+
+2. 更新任务状态: `openmatrix complete <taskId>` 或更新 state
+3. Git 自动提交（必须使用下方统一提交格式）
+4. **立即检查是否还有未完成任务** — 读取 `.openmatrix/state.json` 中的 statistics，如果 completed < totalTasks，继续执行下一个
+5. 检查审批点（auto 模式自动批准，其他模式按配置暂停）
+
+**Agent 上下文共享机制 (Agent Memory):**
+
+每个 Agent 执行时会自动接收前序 Agent 的上下文信息（通过 `context.md` 文件）。
+这确保 Agent 之间共享知识、避免重复工作、保持决策一致性。
+
+```
+Agent-1 完成 → 写入 context.md → Agent-2 读取 Agent-1 的上下文 → 写入 context.md → ...
+```
+
+**中断恢复:** 如果会话中断，再次执行 `/om:start` 时:
+1. 读取 `.openmatrix/state.json`
+2. 如果 `status === 'running'`，读取所有任务，找到 status 不是 completed 的任务
+3. 从中断的任务继续执行，不需要重新开始
 
 **Meeting 处理（auto 模式）:** 记录并跳过，执行完成后统一展示。
 
@@ -192,14 +246,42 @@ openmatrix meeting --list
 ```
 如有 pending Meeting，交互式处理。
 
-最终 Git 提交:
+所有任务完成后，执行最终 Git 提交（**必须使用 HEREDOC 格式**）:
 ```bash
-git add -A
-git commit -m "feat: 完成所有任务
+git add -A && git commit -m "$(cat <<'EOF'
+feat: 完成所有任务
+
+- 任务1标题
+- 任务2标题
+- ...
+
+影响范围: 全部模块
+文件改动: 统计变更文件数
+
+Run: run-XXX
+Co-Authored-By: OpenMatrix <https://github.com/bigfish1913/openmatrix>
+EOF
+)"
+```
+
+**Git 提交格式规范（所有提交必须遵守）:**
 
-RunID: run-XXX
-任务数: N"
 ```
+<type>: (TASK-XXX) 简短描述
+
+- 改动点1
+- 改动点2
+
+影响范围: 模块名
+文件改动: 文件1, 文件2
+
+Run: run-XXX
+Co-Authored-By: OpenMatrix <https://github.com/bigfish1913/openmatrix>
+```
+
+**type 映射:** feat(新功能) / fix(修复) / test(测试) / refactor(重构) / docs(文档)
+**禁止使用:** `Co-Authored-By: Claude` 格式，必须使用 `Co-Authored-By: OpenMatrix <https://github.com/bigfish1913/openmatrix>`
+**禁止使用 emoji**，使用纯文本格式
 
 </process>