yugoo-design 0.1.2 → 0.2.2

package/payload/shared/authoring/studio-creators/source/.agents/skills/design-bundle-creator/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: design-bundle-creator
+description: 创建或修订 Design System 自包含的交互 Bundle，包括 manifest、schema、校验、面板、摘要及方法；组合 design-skill-creator。用于扩展 Kit 内容，不用于执行设计任务。
+---
+
+# Design Bundle Creator
+
+Bundle 是一个可交互、自包含的信息切片，不是一个按钮、脚本或流程阶段。先明确用户在这里理解/修改什么，以及它独占哪些 canonical 事实。
+
+将已有 Skill 扩展为 Bundle 时，保留其专业方法和配套资源，为其中用户需要理解、比较、修改或确认的内容设计贴合任务的交互面板。提问、对话或后台执行都可能有有价值的交互对象，不能按执行形式预先跳过面板。问题与选择、变更与影响、结果与修订都可以成为表达的角度；从实际用途选择，不将聊天逐句搬成表单或添加无用字段。保存后的判断应可回看、修订并供 Agent 继续使用。确实找不到有意义的交互对象时说明具体原因，而不是仅补齐配置就声称完成了交互式扩展。
+
+## 组合下层技能
+
+必须读取并使用 [design-skill-creator](../design-skill-creator/SKILL.md) 及其要求的参考来编写方法/输出契约。不是仅在文档里提到技能名；在交付记录中保留这一步的实际参考和验证结果。同一 Agent 可顺序完成，不要求创建子代理。下层技能缺失时说明依赖缺口，不假称已调用。
+
+## Bundle 层工作
+
+1. 读取 [bundle-checklist.md](references/bundle-checklist.md)，核对目标仓库的 loader、schema、panel DSL 当前实现与同类参考。
+2. 确定状态所有权、用户交互、直接依赖和 artifact 边界，再协同设计 schema/面板/输出契约。不要先生成大段方法再猜字段，也不要只做技术对象 CRUD 而丢掉专业交互。
+   所有 Kit 的所有 Bundle 都遵守 [字段取舍](references/panel-authoring.md#字段取舍)：每个独立填写字段须有具体用途；一般性待确认、假设、依据与来源说明统一为可选备注，不另设通用字段组，也不只改标题。未知在备注中明确说明；真正影响方案的业务规则、约束和专用任务的核心内容保留对应表达。核对已有内容与方法契约的保留方式。
+3. 创建对应 presentation profile 的固定槽位和必要资源。默认优先使用已有声明式基础组件；组件不足时明确缺口，不在 Host/Core 硬编码 Bundle 名，也不默默降级成纯文字假称可视化完成。
+   编写或维护声明式面板时，读取 [panel-authoring.md](references/panel-authoring.md)，从实际运行时目录选择组件，先核对交互能力再写 DSL。
+   遵循 [唯一共享基础与作者边界](references/panel-authoring.md#唯一共享基础与作者边界)：所有 Kit 使用相同的侧栏、内容框架、基础控件和编辑操作范式。作者声明业务内容、关系和已有视图选择，不逐面板调整字号、边距或按钮，不复制 CSS/控件。基础缺陷在共享层修复一次；新的信息表达需要通用能力时明确提出组件缺口。
+   信息组织按目标仓库的 `docs/panel-uiux-standard.md` 判断；组件自动落实文字层级、控件和状态反馈。入口与安装版读取方式见该指南，不把场景尺寸强加给全部 Bundle。
+   含画布时还须读取 [canvas-authoring.md](references/canvas-authoring.md)，统一方法的文件入口、责任边界和验证方式，不统一各 Bundle 的画布类型；沿用 `reference/`，不另建技能目录。
+   有跨 Bundle 事实对齐或补充需求时，读取 [cooperation-authoring.md](references/cooperation-authoring.md)，按需编写 `reference/cooperation-guide.md` 并从方法与输出契约链接；规范只约定位置和职责，不要求补齐模板或调用全部 Bundle，不扩大写入权限。
+4. 使用下层技能完成方法；用同一 fixture 验证 schema、规则、面板编辑、摘要和引用。对含产物的 Bundle 验证生成文件、引用与保存后刷新，不只验证一个空 JSON 能载入。
+
+创建或更新 Bundle 时都要维护能体现主要用途的非空合成样例，与方法、字段和面板一起更新。声明式 Studio 预览沿用实际入口的 `reference/preview.json`，文件产物配齐可读取的有限样例资源；原生或无面板 Bundle 使用相应可验证示例，不新增统一 loader 必填槽。预览数据不得冒充实际求解、用户事实或模型执行证据。
+Bundle 的职责或交互变化还要复查 Kit 挂载说明与 Mindset 的引导，用一次有限的建议、展开、反馈和修订检查顾问式体验是否连贯，不按固定顺序运行全部 Bundle。
+
+交付前按 Panel 声明指南核对组件、section/字段的数据路径、schema 和语言资源，
+让同一记录的编辑、摘要与保存指向同一 canonical 事实。内容修改通过目标宿主
+实际支持的 Kit 加载/更新入口生效，须校验后发布；编辑源码或任意文件并不自动
+更新已安装 Kit、打开中的面板或项目固定版本。复用已有组件的声明修改无需
+重编译插件；新增共享组件实现则属于运行时构建与发布。
+
+## 验收
+
+Bundle 的介绍、方法和交付说明遵循[面向读者的文档原则](../design-skill-creator/references/standards.md#面向读者的文档reader-focused)：让用户或执行者能理解用途并行动，内部调试过程与验证记录不混入正常操作步骤；专业方法与必要契约仍需完整可达。
+
+新建、修订或迁移面板时，按 [Panel 指南的面板自查](references/panel-authoring.md#面板自查)
+回答信息表达是否帮助理解和思考、交互是否方便且符合习惯、信息量与组织是否便于
+人工改写表达、修改结果是否支持与 AI 对齐。原则上不推荐多个内部 Tab，不把
+底层集合直接拆成导航；确有独立任务或视图时说明依据及上下文保留方式。
+结合代表性内容与阅读/改写路径，将结果写入现有交付记录；字段完整或结构校验
+通过不能代替体验判断，不因此增加单独审批或全产品测试。
+
+从实际 Kit loader 加载；检查资源通过运行期入口可读，样例合法，错误输入被拒绝。面板能编辑 canonical 并保存/重开，摘要反映实际内容，跨 Bundle 引用解析到真实记录。新增交互组件要做相应浏览器检查，但不为纯方法修改启动全产品 E2E。
+
+验收必须包含与风险相称的首次生成和保存继续；只有静态/单测证据时明确尚未验证真实 Agent。已有数据不为通过测试而批量改写。
+
+交付给 Kit 层：文件清单、选择描述、执行/handoff 策略、依赖和可选环境要求、验证证据及限制。不得把共享运行时修复、插件安装或发布当成本技能隐含授权。

package/payload/shared/authoring/studio-creators/source/.agents/skills/design-bundle-creator/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Design Bundle Creator"
+  short_description: "Create self-contained interactive Bundles"
+  default_prompt: "Use $design-bundle-creator to build this interactive information slice using the method-authoring skill."

package/payload/shared/authoring/studio-creators/source/.agents/skills/design-bundle-creator/assets/skill.template.yaml

@@ -0,0 +1,40 @@
+# Copy to bundles/<catalog_identity>/skill.yaml and replace the example identity/copy.
+# This is a manifest starting point, not a complete or installed Bundle.
+# Also author SKILL.md, schema.yaml, validation.yaml and panel.yaml.
+# Optional summary.fields/collections below belong in this manifest, not renderer.md.
+# Omit summary entirely when no model-facing summary is needed; Panel/execution remain available.
+# identity is the independent catalog id: use it for the directory resolver and Kit mount name.
+# name is the runtime id: match SKILL.md name, validation.yaml skill and canonical paths.
+# A copied Bundle can have a new identity while retaining its runtime name and method.
+# Required version: quoted major.minor only (e.g. "0.1"), without leading zeros,
+# patch components or prerelease suffixes; this is not an npm package version.
+# Required title and label: each needs non-empty zh and en strings.
+identity: example_bundle
+name: example_bundle
+version: "0.1"
+title:
+  zh: "示例设计切片"
+  en: "Example Design Slice"
+label:
+  zh: "编辑示例设计切片"
+  en: "Edit Example Design Slice"
+# Capability/routing description belongs in SKILL.md frontmatter, not here.
+# Optional translated picker copy: bundleDescription in the panel's declared
+# zh-CN/en-US locale JSON files. Never duplicate it in this manifest.
+# Optional display metadata; neither value controls capability routing.
+order: 1
+icon: list
+execution:
+  # Choose main or subagent deliberately; this example is not a universal policy.
+  mode: main
+  # must_edit returns an editable result to the user. Other allowed values are
+  # none and user_continue; user_continue additionally requires resume_action.
+  handoff: must_edit
+presentation:
+  # Default authoring path: compose approved components without Bundle-local JS.
+  # Native mode needs an existing trusted provider; auto/none have different slots.
+  mode: declarative
+# The declarative interpreter is selected by the runtime, not by the author.
+# Add runtime.driver, capabilities or semantic_capabilities only when an actual
+# registered contribution or semantic contract requires them. Do not invent
+# scheduler, Worker-permission, model or search-credential fields here.

package/payload/shared/authoring/studio-creators/source/.agents/skills/design-bundle-creator/references/bundle-checklist.md

@@ -0,0 +1,55 @@
+# Bundle 固定槽位和验收参考
+
+仓库相对依据：`docs/bundle-contract.md`、`packages/core/src/kit-loader.ts`、`packages/core/src/panel-dsl.ts`。运行机制以当前实现为准，历史差异见下层技能的 standards.md。
+
+| 文件/资源 | 必须表达什么 |
+| --- | --- |
+| `skill.yaml` | 独立 catalog identity 与运行时 name 分开，配合精确 version、可读 title 与 label（两者都必需，且各含非空 zh/en）、presentation；execution.mode(main/subagent) 与 handoff 分开选择，不添加自造调度字段 |
+| `SKILL.md` | 调用 design-skill-creator 产出可执行方法；frontmatter name 与 manifest 的运行时 name 一致。独立目录使用 identity，不强迫运行时名称随目录改动 |
+| `schema.yaml` | canonical 结构、类型/枚举、扩展策略；问答真实答案、记录集合、跨文件引用/metadata 使用已有知识标注能力 |
+| `validation.yaml` | 工作中与 completion 的真实消费者约束；先读[校验创作说明](validation-authoring.md)中的完整 rule 与合法算子，不以长度、图表数、风格偏好充当有效性 |
+| `panel.yaml` | declarative profile 必需；先核对 `packages/core/src/panel-dsl.ts` 的 `CONTROL_KINDS` / `COMPONENT_KINDS`，不用猜测的控件名。字段与 schema 对齐，引用选项来自实际记录，交互能落回本 Bundle 状态 |
+| `skill.yaml.summary` | 可选模型摘要声明；缺省不阻断加载、执行、面板和保存。`fields` 和集合记录字段仅支持 scalar；数组/嵌套对象不可直接塞入 fields。旧 renderer.md 迁移时保留说明为注释，禁止双源 |
+| 可读契约/例子 | 方法内联完整形状，或链接 Bundle 内的实际资源；不假设 schema 固定槽位能从资源工具读 |
+| `reference/canvas-guide.md` | 含画布时的统一方法入口；按 [画布创作规范](canvas-authoring.md) 说明本领域表达、生成、布局责任及验收，索引而非替换已有专项资料。不是新增 loader 必需槽位 |
+| `reference/cooperation-guide.md` | 有跨 Bundle 对齐/补充需求时按 [协作方法规范](cooperation-authoring.md) 填写真实 owner、证据与回交边界；方法和输出契约双入口可达。按需内容位置，不是 loader 必需槽位或强制协作流程 |
+| scripts/artifact refs | 仅在必要时提供；领域代码归 Bundle，参数/文件范围/返回状态明确，不能借另一个 Bundle 的私有脚本 |
+
+完整 manifest 起点见 [skill.template.yaml](../assets/skill.template.yaml)，不要只凭字段名称重写槽位；`title` 与 `label` 都要保留。安装版作者通过资源索引读取本说明、模板、校验说明及成熟示例，无需开发源码路径。
+
+## 可选 profile
+
+- `presentation.mode: declarative`：系统选择解释器，带 panel.yaml；可选摘要写在 skill.yaml.summary，无需固定 renderer/version 字段。
+- `native`：需要已有可信 provider contribution 和真实注册验证；不附一套冲突的 declarative 槽位，不声称零代码接入。
+- `none`：明确没有交互面板的特殊能力，不用于省略用户要求的面板。
+
+## 声明式表达的实际边界
+
+控件和组件是封闭集合，写入前读 `panel-dsl.ts` 中相应类型与绑定规则。例如当前有 `list` / `multi_select`，没有一个可任意猜用的 `tags` 控件；子表格控件还受 `ROW_COLUMN_CONTROLS` 限制。按数据和交互目标选类型，不照搬其他 UI 框架的命名。
+
+问题清单优先使用标准 `question_workspace`（无侧栏需求的极小清单可用 `question_list`），不要用 `record_form` 重新拼一套问答 UI。工作区复用通用 `panel_workspace` 的左侧导航和主内容边界；左侧只承载导航，工作区说明写在 `description`，由共享的顶部悬浮 Tip Bar 呈现，不要把长说明塞进窄侧栏。可选 `round` 自动形成轮次，未声明轮次时仍形成一个“当前问题”分组。记录的通用字段是 `prompt`、可选 `note`、`kind`（`text | single | multiple`）、可选 `choices`、`answer` 和可选 `detail`；其中 `choices` 仅服务交互选项，用户事实以非空 `answer` 为准。文本题只编辑一个 `answer` 文本框，已有 `detail` 作为只读上下文保留；选择题可用 `detail` 补充所选答案。可选 `rejected` 只表达问题交互状态；可选 `multimodal_answer` 使用标准本地附件引用，上传字节由 Host 的浏览器传输与 Panel Save 原子保存，绝不能进入 canonical JSON。不要为不需要的 Bundle 强制添加轮次、拒答或附件字段。
+
+需要 Panel 内左侧导航的其他信息切片使用 `panel_workspace` 的 `sidebar` / `main` slots，复用统一的 containment、滚动和窄宽度退化；不要只为某个 Kit 复制一套双栏 CSS。该布局只定义交互骨架，不改变 Bundle 的 canonical 所有权和领域结构。
+
+摘要由 `packages/core/src/renderer.ts` 定义，`kit-loader.ts` 的 `assertDeclarativeConsistency` 核对 schema。顶层字段和集合的记录字段必须是 scalar；`collections.source` 可指向符合契约的 map/array，不意味着其中任意嵌套数组都可作为记录字段输出。数组内容使用支持的集合摘要或面板组件；无法完整概括时说明摘要覆盖限制，引导读取 canonical，而不是伪造扁平化事实字段或静默丢弃重要信息。
+
+## 推荐参考（按类型读，不全量照搬）
+
+- Record/method：`packages/skills-web-app/bundles/function_modules/`。
+- Artifact + script：`packages/skills-web-app/bundles/page_design/`。
+- Declarative record/question：`packages/skills-web-app/bundles/smart_questions/`。
+- Declarative graph/record relations：`packages/skills-web-app/bundles/business_data/`。
+- Declarative table/artifact：`packages/skills-web-app/bundles/role_access/`、`packages/skills-web-app/bundles/web_app_prd_assembly/`；矩阵等其他表达先核对 `docs/dsl-spec.md` 的实际组件契约，不从示例目录推断支持范围。
+- 可运行验收结构：`packages/skills-web-app/test/test-page-file-contract.mjs` 和 `packages/panel/test/relation-graph-contract.test.mjs`；不要只复制测试名，要换成真实目标数据。
+
+## 验证层次
+
+从目标版本的实际 Core 加载；任意完整内容包与非空样例可先按[现有 API 校验样例](../../../../docs/wiki/extending.md#校验独立内容包)检查。它不代替以下运行期资源、面板和专业能力验收。
+
+1. 实际 loader：固定槽位、schema/panel/renderer 一致、跨面板绑定可解析。
+2. Agent 入口：从 SKILL body 读取链接资源；以 loader 的 resources 模拟绑定读取，不绕到源码直接读。
+3. 正/负数据：真实非空 fixture 合法；错枚举/缺必需字段/坏引用/越界产物按对应约束失败。schema 通过不意味着所有引用已被其检查。
+4. 状态流：编辑一个字段后保存重开；相关 artifact 已刷新或诚实标为未刷新，没有覆盖无关记录。
+5. 交互与领域：新增 UI 实测；专业规则和证据独立核对；外部求解/调研缺失时不伪造完成。
+
+运行策略示例：`execution: {mode: main, handoff: must_edit}` 适合需立即在主对话准备的交互记录，但不是问答 Bundle 的强制选项。`user_continue` 适合已有实际两阶段流程；不要给所有 Bundle 套双阶段。

package/payload/shared/authoring/studio-creators/source/.agents/skills/design-bundle-creator/references/canvas-authoring.md

@@ -0,0 +1,74 @@
+# Bundle 画布方法的文件与内容规范
+
+本规范用于创作或修订含画布的信息切片，包括关系图、流程图、导航地图、脑图和
+自由画布。统一的是资料归属、读取入口、内容边界和验收方式，**不是图形类型、
+视觉风格或布局算法**。没有画布的 Bundle 不需要补文件或增加画布。
+
+## 文件归属与读取入口
+
+每个含画布的 Bundle 用自身的 `reference/canvas-guide.md` 作为方法入口。
+沿用现有 Bundle 目录，不新增 `.skill` 目录、manifest 槽位或另一套资源读取 API。
+这是系统建议的创作文件规范，不是对已有第三方 Bundle 新增的加载必需项。
+
+| 位置 | 职责 | 不应承担的职责 |
+| --- | --- | --- |
+| `SKILL.md` | 领域方法及何时读取画布指南；首次设计、修订时的判断 | 复制完整画布指南、声明并不存在的组件能力 |
+| `reference/canvas-guide.md` | 如何把本领域证据与事实表达为可用画布；索引已有专项方法 | 另一套 schema、运行时状态、宿主协议或事实来源 |
+| `reference/artifact-contract.md` | 合法数据、引用和产物契约；链接画布指南 | 用字段清单代替生成方法 |
+| `schema.yaml` / `validation.yaml` | 持久数据形状及适用阶段的机械约束 | 用风格、图数量或像素布局判定领域设计完成 |
+| `panel.yaml` | 当前运行时支持的组件、数据绑定与交互声明 | 任意 JSX/CSS、生成方法正文或第二套图数据 |
+| Bundle 专项 `reference/`、`scripts/`、`assets/` | 本领域格式、生成/布局/校验方法与必要资源 | 绕过原有文件权限、校验和发布通道 |
+| 共享 Panel / DSL 与 UIUX 规范 | 同类组件的文字、状态、操作与实际渲染能力 | 依据 Bundle 名硬编码领域方法或要求所有画布同形 |
+
+`SKILL.md` 链接 `reference/canvas-guide.md`；契约从同目录链接 `canvas-guide.md`。
+若简单 Bundle 的输出契约原本内联，须先确认其还原入口如何读取共用画布约束，
+不能仅在正向正文加链接就声称还原可达。当前仓库的显式还原入口会提示读取
+`reference/artifact-contract.md`，不注入正向 Skill Body。
+运行时读取仍使用 Bundle 已绑定的资源路径，而不是作者机器上的绝对路径。
+
+已有 `bpmn_authoring.md`、`task-to-page-method.md`、`drawing-method.md` 等专项资料
+保留为唯一详细来源，由指南说明何时读取；不得复制全文后维护两个版本。
+一个 Bundle 有多种画布时，用同一入口分流到各自方法。不要为了统一文件名删掉
+旧方法，或强制所有内容改成相同章节、相同长度。
+
+## 画布方法需要回答的问题
+
+以下是覆盖要求，允许交叉引用已有 Bundle 资源，不是七个必填表单或固定标题。
+
+1. **表达什么、为什么用这种图？** 明确用户要理解或作出的判断、表达范围、
+   选用的图形语义。流程顺序、实体关联、继承、依赖和自由批注不能混为一谈。
+2. **事实从哪里来？** 指明 canonical 文件/集合/字段、稳定 ID、引用端点和
+   条件性产物。区分从记录投影的图、需生成的文件型图、持久布局和临时视图状态。
+   名称相同不建立同一身份；图和详情不得维护两套业务事实。
+3. **如何生成和修订？** 给出从本领域证据选择节点、关系、分组、标签和粒度的
+   方法，而非只说“生成美观图”。解释设计可提出什么、还原只能恢复什么，以及
+   局部修订应保留哪些用户编辑、ID、未受影响产物与来源。
+4. **谁负责布局和可读性？** 明确自动投影由共享运行时布局，还是 Agent/既有
+   脚本生成 artifact 几何。说明领域特有的阅读方向、分区、标签与避让要求，
+   防止文字遮挡或截断关键含义。只引用适用的共享规则：React Flow 节点端口
+   约定不能强加给 BPMN 或自由白板。没有坐标契约时不能让 Agent 发明坐标字段。
+5. **如何处理未知、缺失和密集关系？** 不为填满图而编造对象、连接或状态；
+   区分未知与不存在。说明缺端点、缺产物、外部资源不可用和密集图时的真实
+   表达/诊断方式；不能丢失既有事实来换取整齐，也不能伪造执行成功。
+6. **用户能做什么、如何保存？** 按实际组件说明选择与详情联动、允许的编辑、
+   只读边界、切换/刷新以及保存后的结果。点击、拖拽或双向连线只在已实现时
+   承诺；使用现有 canonical/产物原子保存路径，不新增保存权威。
+7. **怎样验证？** 链接有意义的合法示例及适用校验入口，明确示例不是用户事实。
+   选择相关失败例（如缺失端点、非法引用或无效 artifact），区分结构校验、
+   实际渲染/交互、持久保存重开与真实 Agent 生成质量，不以其中之一代替其他。
+
+共享 UIUX 细节以目标运行时的 `docs/panel-uiux-standard.md` 或组件发现接口
+返回的同包 `sharedStandards` 为准。执行者需要的领域约束必须写入 Bundle 可达
+资源，不能只链接仓库开发文档。产品图形的配色/风格由其表达任务决定；工具栏、
+状态提示等公共控件才复用对应共享规范。
+
+## 交付与核验
+
+- 先列出原方法的保留映射；仅增加入口/索引时保持原文不动。冲突条款按当前
+  owning contract 和已授权范围显式纠正，不能把旧要求与新要求同时当权威。
+- 经实际 Kit loader 检查指南及链接的专项资源在 `kit.resources` 内可读，分别
+  从普通方法和还原契约追踪入口。不要只验证源码文件存在或 Markdown 链接拼写。
+- 示例用当前 schema/validation 检查；有交互或渲染改动才做相应浏览器及保存
+  检查。纯方法整理不要求重跑所有面板，也不据此声称原生 Agent 或安装包通过。
+- 新能力尚未接线时明确标为待实现，不把 HTML 原型、愿景图或静态例子写成
+  当前 Bundle 的运行承诺。保留不同画布的领域差异，不借规范化重设计其他切片。

package/payload/shared/authoring/studio-creators/source/.agents/skills/design-bundle-creator/references/cooperation-authoring.md

@@ -0,0 +1,52 @@
+# 跨 Bundle 协作方法的文件与内容边界
+
+这是按需内容组织规范，不是新增运行时文件槽位。只有当本领域依赖其他设计
+切片、或本次设计会带来需要对齐的补充时，才在 Bundle 内编写
+`reference/cooperation-guide.md`。没有需求不加占位文件，不要求填写全部章节，
+也不要求依次调用所有 Bundle。
+
+## 信息应放在哪里
+
+| 位置 | 职责 |
+| --- | --- |
+| `SKILL.md` | 本领域完整方法与何时读取协作说明；不靠仓库规范替代安装后的方法输入 |
+| `reference/cooperation-guide.md` | 本领域实际的相关事实 owner、触发条件、证据输入、最小补充/冲突判断和回交边界 |
+| `reference/artifact-contract.md` | 合法数据表达与还原共用边界；链接协作资源，使实际还原入口可达 |
+| `schema.yaml` / `validation.yaml` | 已有 canonical 引用与机械校验；协作说明不新增另一份关系状态或伪造跨文件校验 |
+| 当前调用方 / 目标 Bundle 的实际入口 | 根据用户授权、执行权限与当前结算/交接状态选择下一步；目标 owner 验证、发布自己的内容 |
+
+规范约定位置、职责和检查问题，具体 Bundle 根据真实需要组织内容。不统一
+相关 Bundle 列表、步骤数量、章节名或表格格式。可链接自己的既有专项方法，
+不复制或删减专业判断，也不把产品里的 Agent 协作和设计 Bundle 协作混为一谈。
+
+## 有需要时回答哪些问题
+
+- 哪些事实由当前 Bundle 持有，哪些事实由别的 owner 持有？什么时候确实
+  需要读取或补充，什么时候应保持对方不变？避免两份提示词/说明成为双重权威。
+- 依据哪些当前请求、保存状态、源文件/版本、用户决定或观察进行对齐？设计
+  建议、还原事实、用户确认和未知如何区分？不能因为有一个示例就补齐产品。
+- 如何识别真实目标和稳定 ID，保留已有精确来源 pin，发现缺项、重复或冲突？
+  缺少 owner 内容时不猜 ID，不创建空实体，不用同名证明同一事实。
+- 交回调用方的最小信息是什么：受影响记录、目标 owner/已知目标 ID、证据位置、
+  必要补充或待确认问题？这是结果说明，不是新增持久化状态协议。
+- 当前 executor 的读取/写入、工具调用与交接边界是什么？相关性不授予写权限。
+  隔离 Producer 不得写其他 Bundle 或嵌套调用另一个生成器；由主/调用 Agent
+  在既有授权、结算和人在环规则下调用目标 owner。main 模式也不扩大 Bundle
+  文件所有权。不绕过 must_edit，不另造保存、校验、发布或模型客户端。
+- 目标缺席、未挂载、工具不可用或用户尚未确认时如何保留缺口并退回适当交互？
+  不强制安装/运行所有相关 Bundle，不把指导文档当执行 receipts。
+- 后续真实补充前如何重读目标当前状态、保留用户修改；结算后如何检查实际事实
+  与引用？未执行、未保存、未验证的部分必须独立报告，不能用本地 schema 通过
+  声称跨 Bundle 一致性或 native 执行已验证。
+
+## 验证与保留
+
+从普通方法和实际还原 prompt 分别沿链接读取同一 Bundle 内资源；通过真实
+loader/resource 通道检查，不只直接读取开发目录。两处必须有明确的条件入口。
+如果宿主没有还原通道，则报告边界，不由源码 prompt 推断所有 native host 支持。
+共享作者规范不作为已安装 Bundle 的运行输入，故实际必要约束应随资源自包含。
+
+整理已有方法前做保留映射；旧引用、字段、专业方法、失败处理与用户事实保持
+可达。只按获准范围纠正与实际权威冲突的规则，不借“协作规范”删除原方法。
+验证相关本地引用、未解决引用/冲突的负例、缺少可选 owner 的路径；没有新增
+运行时机制时不引入新的必填 slot、DSL、状态机或完成条件。