archgraph-argo 0.7.8 → 0.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -38,12 +38,29 @@ applyTo: "**"
|
|
|
38
38
|
<OrganizationGuideline>
|
|
39
39
|
1. `Business Actor` 元素本身就是持久化实体：一旦在意图图谱中创建，就持续存在，直到被显式删除。持久化载体是「图谱元素 + 其名下挂载的 View」。
|
|
40
40
|
2. 当你要调用某个 `Business Actor` 时，按其稳定身份标识（`name`或 `id` ，创建时登记）在意图图谱中查找：已存在则直接复用该元素，并读取其名下 View 恢复长期记忆；不存在则新建该 `Business Actor` 元素并登记一个全局唯一的 `name`。
|
|
41
|
-
3. 启动某个 `Business Actor` 前，先读取该元素的 `description`，把它作为该 agent 的定义（system prompt
|
|
41
|
+
3. 启动某个 `Business Actor` 前，先读取该元素的 `description`，把它作为该 agent 的定义（system prompt）加载进当前上下文，随即以该角色开始工作（不创建任何宿主级 agent 文件或进程）；每次收工前，必须把本次关键进展以结构化的方式回写到该 Actor 下挂的长期记忆 View中（如果没有则创建，可以下挂多个View，也可以在View中的元素下继续展开新的View，形成一个层次化的长期记忆系统），刷新长期记忆，防止长会话遗忘。
|
|
42
42
|
4. 每个 `Business Actor` 的长期记忆挂载在该元素名下的一个或多个 View 中，包含该 `Business Actor` 的所有历史工作信息。
|
|
43
43
|
5. 每个 `Business Actor` 工作时必须与其他 `Business Actor` 保持隔离，即各自使用独立的会话/工作上下文：调用某个 `Business Actor` 时，只加载其自己名下 View 的长期记忆，不得读取或写入其他 `Business Actor` 的 View，不同 `Business Actor` 的记忆与上下文不得混用。
|
|
44
44
|
6. 每个 `Business Actor` 的 `name` 必须全局唯一，不能与其他 `Business Actor` 的 `name` 冲突。
|
|
45
45
|
</OrganizationGuideline>
|
|
46
46
|
|
|
47
|
+
<SessionMemorySummarization>
|
|
48
|
+
每次会话结束（收工）前，必须执行一次短期记忆总结，并将总结写入长期记忆，防止跨会话遗忘：
|
|
49
|
+
1. 先读取短期（会话）记忆：查看 `/memories/session/` 下本次会话的记录；若为空，则依据本次会话的实际工作内容进行总结。
|
|
50
|
+
2. 生成结构化总结，至少包含：本次目标、已完成的关键进展、关键决策及其原因、遗留问题与待办、可复用的经验与教训。
|
|
51
|
+
3. 将总结写入长期记忆：
|
|
52
|
+
- 若本次工作属于某个 `Business Actor` 的角色工作，按 `<OrganizationGuideline>` 写入该 Actor 名下挂载的长期记忆 View；
|
|
53
|
+
4. 总结必须简洁、去重：优先更新已有记忆文件，仅在必要时新建；禁止把会话中的冗余过程内容原文复制进长期记忆。
|
|
54
|
+
</SessionMemorySummarization>
|
|
55
|
+
|
|
56
|
+
<MemoryTriggerTiming>
|
|
57
|
+
除「会话结束」外，以下时机必须即时触发长期记忆写入，不得攒到会话结束：
|
|
58
|
+
1. 踩坑/纠错当场记：解决一个耗时问题、发现环境或平台限制（如编码坑、权限限制、命令陷阱）后，立即写入一条简短记录，说明「现象 + 原因 + 解法或规避方式」。
|
|
59
|
+
2. 关键决策当下记：做出影响后续走向的技术/架构决策时，立即记录「决策 + 理由 + 被否掉的备选方案」，保证理由在决策当下最清晰。
|
|
60
|
+
3. 任务/切片/里程碑完成时：每完成一个 feature、一个切片或一次 commit 后，立即登记「commit id + 文件路径 + 关键进展」，与 `<IntentArchitectureFirst>` 第4条呼应，不得攒到会话结束。
|
|
61
|
+
以上即时记录同样遵守 `<SessionMemorySummarization>` 第4条的简洁、去重要求。
|
|
62
|
+
</MemoryTriggerTiming>
|
|
63
|
+
|
|
47
64
|
<ToolsGuideline>
|
|
48
65
|
你必须通过ARGO MCP server提供的工具来进行意图架构的读写操作，禁止直接修改意图架构的源文件：
|
|
49
66
|
1. getSystemArchitecture: 语义化读取架构（推荐带 query.purpose + query.intent，而非全量读取）。
|
package/package.json
CHANGED