openyida 2026.7.19 → 2026.7.21

package/yida-skills/skills/yida-process-rule/SKILL.md

@@ -1,16 +1,29 @@
 ---
 name: yida-process-rule
-description: 为已有流程表单配置审批规则（审批/办理/抄送、条件/并行分支、字段权限、跳转规则、官方组件节点透传）。适用于流程表单已创建、需要调整审批流程时。
+description: 配置已有流程表单审批规则；schema-managed 流程由根技能或明确 context 路由到 schema workflow。
 ---
 
 # 宜搭流程规则配置技能
 
+> 资源边界：本技能只处理普通 OpenYida 资源；若根技能、上下文或 CLI guard 显示目标是 schema-managed，停止本技能并走 schema workflow；目标不明时回到根技能确认。
+> direct/standalone 路径才可执行本技能；schema-managed 路径必须回到 schema validate → plan → apply，不在本技能内降级写入。
+
+## Resource-First 使用门槛
+
+本技能是已有流程/表单上下文的默认流程修改入口：
+
+- 已有流程表单、`processCode`、流程 URL、bound process 或可确认的 workflow form 时，审批节点、条件分支、字段权限、抄送、跳转规则等诉求默认使用本技能。
+- 已有普通表单 `formUuid` 且用户要“配置审批 / 转为审批流程”，先确认是否对该表单启用流程；如果只是转流程且尚无流程，可由 `yida-create-process --formUuid` 复用该表单，不要新建同名表单。
+- 没有目标表单/流程，且用户明确从零创建审批系统时，才改用 `yida-create-process`。
+- 多个流程候选按根技能来源优先级选择；同级冲突或无法判断目标流程时才问用户。
+
 ## 严格禁止 (NEVER DO)
 
 - 不要在流程定义中使用猜测的 fieldId，必须先用 `yida-get-schema` 获取
 - 不要在未加载本技能内容的情况下编写流程定义 JSON，格式复杂且易出错
 - 不要用此技能创建流程表单，应使用 `yida-create-process`
 - 不要用 shell heredoc、`cat`/`echo`/`printf`/`tee` 或重定向生成流程定义 JSON
+- 已有 process/form context 时不要新建同类流程表单；在原流程上配置/更新。
 
 ## 严格要求 (MUST DO)
 
@@ -25,6 +38,7 @@ description: 为已有流程表单配置审批规则（审批/办理/抄送、
 | 用户意图 | 触发条件 |
 |---------|---------|
 | 配置/修改审批流程 | "配置审批"、"审批节点"、"条件分支"、"字段权限" |
+| 从零创建流程表单 | 仅无既有 form/process context 时 → 改用 `yida-create-process` |
 
 ## 触发条件
 
@@ -51,6 +65,14 @@ description: 为已有流程表单配置审批规则（审批/办理/抄送、
 
 ## 前提
 
+| 场景 | 使用技能 |
+|------|---------|
+| **已有流程表单**：只需修改/配置已有表单的审批流程规则 | **本技能（yida-process-rule）** |
+| **已有普通表单**：要启用/转换审批流程 | 先确认目标表单，再用 `yida-create-process --formUuid` 复用表单或回到本技能配置 |
+| **从零创建**：没有目标表单/流程，需要新建表单 + 配置审批流程 | **yida-create-process** |
+
+> 简单判断：有没有现成的流程表单？有 → 本技能；没有 → `yida-create-process`。
+
 执行本技能前需要已经有目标流程表单、`appType`、`formUuid`、字段 ID 和必要的审批人 / 条件信息。
 
 ## 使用方式
@@ -420,3 +442,15 @@ OpenYida 会自动兼容常见别名：
 yida-process-rule/
 └── SKILL.md                    # 本文档
 ```
+
+## 与其他技能配合
+
+| 步骤 | 技能 | 说明 |
+| --- | --- | --- |
+| 1 | 已有 app 或 `yida-create-app` | 复用已解析 `appType`；仅无 app 且允许创建时新建 |
+| 2 | 已有表单或 `yida-create-form-page` | 复用已解析 `formUuid`；仅缺表单且允许创建时新建，并获取字段 ID |
+| 3 | **本技能** | 配置表单的流程规则 |
+| 4 | `yida-custom-page` | 编写自定义页面代码 |
+| 5 | `yida-publish-page` | 发布自定义页面 |
+
+> **快捷方式**：使用 `yida-create-process` 技能可一键完成步骤 2-3（创建表单 + 配置流程）。

package/yida-skills/skills/yida-publish-page/SKILL.md

@@ -1,16 +1,30 @@
 ---
 name: yida-publish-page
-description: 将 JSX 源码编译发布到宜搭自定义页面。Babel 转 ES5 + UglifyJS 压缩 + Schema 构建 + saveFormSchema 接口部署。适用于自定义页面代码编写完成后的编译和发布。
+description: 自定义页面 JSX 编译发布技能；schema-managed 页面由根技能或明确 context 路由到 schema workflow。
 ---
 
 # 发布自定义页面
 
+> 资源边界：本技能只处理普通 OpenYida 资源；若根技能、上下文或 CLI guard 显示目标是 schema-managed，停止本技能并走 schema workflow；目标不明时回到根技能确认。
+> direct/standalone 路径才可执行本技能；schema-managed 路径必须回到 schema validate → plan → apply，不在本技能内降级写入。
+
+## Resource-First 发布目标
+
+发布前必须先解析目标页面 context；本技能优先服务已有页面：
+
+- 用户说“优化这个页面 URL / 修改这个页面 / 重新发布 / 覆盖现有页面”并提供页面 URL、`formUuid`、bound page 或 workspace 中可确认的 display page 时，直接把该页面作为发布目标，不创建 app/page。
+- bound page 是默认发布候选，不是强制目标；如果当前会话绑定页面 A，而用户本轮明确指定页面 B，必须先解析 B。B 有唯一 URL / display `formUuid` 时发布到 B；B 只有名称或描述且无法唯一匹配时先问用户；不要静默发布到 A。
+- 只有无法解析目标页面，且用户明确要新增一个页面容器时，才回到 `yida-create-page` 创建缺失 display page；已有 appType 不代表需要新建 app。
+- 发布目标必须是 `formType=display` 的自定义页面；普通表单、流程表单、数据底表的 `formUuid` 不能作为 `openyida publish` 第三个参数。
+- 多个页面候选按根技能来源优先级选择；同级冲突或无法判断页面类型时才问用户或执行只读 `list-forms` 确认。
+
 ## 严格禁止 (NEVER DO)
 
 - 不要在未加载对应页面子技能的情况下编写页面源码：普通自定义页面 JSX/Jsx 组件链路加载 `yida-custom-page`，Code Canvas 链路加载 `yida-canvas-custom-page`
 - 不要把 AI 生成的普通 React 项目代码直接发布；源码应使用 OpenYida 页面源码格式：普通自定义页面 JSX/Jsx 组件链路用 `.oyd.jsx` / `.jsx` 并通过 `check-page` / `compile` 预检，Code Canvas 用 `.canvas.jsx` 并通过 `publish` 的 Canvas 编译阶段校验
 - 不要在宜搭原生 `export function renderJsx()` 页面里手写 Hooks；如确需 `useState/useEffect`，必须使用 `.oyd.jsx` 的 `export default function Page()` authoring 模式，让 OpenYida 兼容编译器降级
 - 不要编造 appType 和 formUuid，必须从已有记录或命令返回中获取
+- 用户已给页面 URL / `formUuid` / bound page 时，不要先创建新 app 或新 page；直接确认目标并发布到已有页面。
 
 ## 严格要求 (MUST DO)
 
@@ -22,17 +36,19 @@ description: 将 JSX 源码编译发布到宜搭自定义页面。Babel 转 ES5
 - corpId 不匹配时，必须询问用户是否切换组织，不得强行发布
 - 重新发布已有自定义页面时，`openyida publish` 会自动读取目标页面现有 Schema 并合并页面级 `dataSource`；不要靠 Agent 口头承诺“保留数据源”，必须使用新版 CLI 的默认保护能力
 - 如果源码包含 `this.dataSourceMap.`，而发布输出包含 `No custom page data sources to preserve`，本次发布不能视为完成；说明源码依赖设计器数据源但目标页没有可保留数据源。必须改为 `this.utils.yida.*` / 入口型页面后重新 check、compile、publish，或先通过 `yida-data-source-connectors` 创建并绑定数据源后重新发布
+- **发布证据闭环**：本轮只要 Write/Edit/Create 了 `project/pages/src/*.{canvas.jsx,canvas.tsx,oyd.jsx,jsx,tsx}`，final 证据只认真实执行成功的 `openyida publish <source> <appType> <displayPageFormUuid>` 命令结果；本地文件编辑、diff、`check-page`、`compile`、`compileCanvasLocal` 或口头声明都不能证明远端页面已更新
 - **本技能不读写 memory**：发布操作通过 CLI 命令写入宜搭平台，不依赖跨会话的 memory 状态
 
 ## 适用场景
 
-编写完自定义页面 JSX 代码后，执行此技能将代码编译发布到宜搭平台。
+编写完自定义页面 JSX 代码后，执行此技能将代码编译发布到宜搭平台。已有页面 URL / `formUuid` / bound page 时，默认发布到该已有页面。
 通常在 `yida-custom-page`（普通自定义页面 JSX/Jsx 组件链路）或 `yida-canvas-custom-page`（Code Canvas 链路）之后执行。
 
 ## 触发条件
 
 **正向触发**：
 - "发布页面"、"上线页面"、"部署页面"
+- "优化这个页面 URL"、"修改现有页面后重新发布"
 - `yida-custom-page` 或 `yida-canvas-custom-page` 代码编写完成后的下一步
 - "编译发布"、"把代码发布到宜搭"
 
@@ -70,6 +86,13 @@ openyida list-forms <appType> --keyword <页面名>
 
 只选择 `formType=display` 的 `formUuid` 作为发布目标。源码里用于 `this.utils.yida` 读写数据的普通表单常量（如 `FORM_SKILL`、`FORM_DATA`、`FORM_TABLE`）通常是数据底表，不能作为 `openyida publish` 的第三个参数。
 
+## Final 证据契约
+
+- final 中“页面已更新 / 已重新发布 / 已上线”的依据只能是成功的 `openyida publish <source> <appType> <displayPageFormUuid>` 命令结果，最好同时带发布输出中的 URL、`formUuid`、`success:true` 或 health-check 摘要。
+- `<source>` 必须是本轮实际 Write/Edit/Create 过的页面源码；`<displayPageFormUuid>` 必须是已解析的 display 自定义页面。发布了其他文件或其他目标页面，不满足本轮源码修改的 doneWhen。
+- 若 publish 没执行、执行失败、目标不明、登录态/组织不一致或用户要求先暂停，final 只能说“源码已修改，尚未发布”，并给出下一步需要执行的 publish 命令或阻塞原因。
+- 普通自定义页面的 `check-page` / `compile`、Code Canvas 的 `compileCanvasLocal` 或 `generate-page --compile` 都是发布前 guard，不是远端完成证据。
+
 ## 数据源保留
 
 `openyida publish` 默认是非破坏式发布：保存新 JSX Schema 前会调用 `getFormSchema` 读取目标自定义页面已有 Schema，提取 Page 组件上的 `dataSource`，再与发布脚本内置的 `urlParams`、`timestamp` 数据源合并。用户在宜搭设计器里手工创建的 HTTP / VALUE / URI 等页面级数据源会随新源码一起保留。
@@ -116,8 +139,8 @@ body { background-color: #f2f3f5; }
 
 ## 注意事项
 
-- 发布目标地址由当前环境配置和 token session 中的 `base_url` 决定
-- 碰到组织 corpId 不匹配时，询问用户是否创建新应用发布
+- 发布目标地址由当前环境配置和 auth context（默认 token session；`YIDA_AUTH_ENABLED=true` 时为宿主注入 token）中的 `base_url` 决定
+- 碰到组织 corpId 不匹配时，询问用户是重新登录到目标组织，还是确认在当前组织继续发布到已解析页面；不要通过新建应用规避不匹配
 - **编写源码前必须先加载对应页面子技能**：普通自定义页面 JSX/Jsx 组件链路调用 `use_skill("yida-custom-page", "编写宜搭普通自定义页面 JSX")`；Code Canvas 链路调用 `use_skill("yida-canvas-custom-page", "编写 Code Canvas 自定义页面")`。旧式 `renderJsx` 写法不要使用 Hooks，现代普通自定义页面 authoring 写法必须走 `.oyd.jsx` 兼容编译；Canvas 源码写成 `.canvas.jsx`
 
 ## 异常处理
@@ -147,3 +170,22 @@ body { background-color: #f2f3f5; }
 | corpId 不匹配 | 停止执行，询问用户是否切换组织或创建新应用 |
 | 网络超时 | 重试 1 次，仍失败则停止并提示用户检查网络 |
 | 未知错误 | 停止执行，完整展示错误信息，建议用户反馈问题 |
+
+## 与其他技能配合
+
+本技能在完整开发流程中的位置：
+
+```
+resolve existing page or create missing page → yida-custom-page / yida-canvas-custom-page → [本技能] yida-publish-page
+                                                                                 ↑
+                                                                            编写 JSX 代码
+```
+
+| 相关技能 | 关系说明 |
+|---------|----------|
+| `yida-create-page` | 可选前置技能，仅在目标 display page 缺失且允许新增时创建页面容器，获取 formUuid |
+| `yida-custom-page` | native 前置技能，编写 `.oyd.jsx` / `.jsx` 源码 |
+| `yida-canvas-custom-page` | Code Canvas 前置技能，编写 `.canvas.jsx` 源码 |
+| `yida-create-form-page` | 无关，用于创建表单页面，不需要本技能发布 |
+| `yida-page-config` | 后续技能，发布后可配置页面公开访问/分享 |
+| `yida-ppt-slider` | 特殊场景，PPT 幻灯片页面也使用本技能发布 |

package/yida-skills/skills/yida-report/SKILL.md

@@ -1,10 +1,16 @@
 ---
 name: yida-report
-description: "宜搭原生报表创建，支持 16 种图表/表格/筛选器组件。普通「报表」「统计」需求默认使用本技能。触发词：「报表」「统计」「图表」「数据汇总」。"
+description: "Standalone 创建宜搭原生报表；如果请求来自 Schema-as-Code manifest/state，停止，不降级直写。"
 ---
 
 # 宜搭原生报表技能
 
+## 适用范围：standalone 资源
+
+- SAC Phase 1 下，本技能只处理明确 standalone 的原生报表。用户提供 Schema-as-Code manifest、要求 schema validate/plan/apply，或报表身份来自 Schema-as-Code state 时，不执行创建、追加或发布，稳定停止为 unsupported。
+- 不得把 SAC unsupported/conflict/uncertain 降级为 `create-report` 等 legacy 写入，不得按标题、组件类型或数组位置 adopt、猜 report/chart/filter ID。
+- 只有报表明确 standalone/unmanaged，或用户明确要求 standalone legacy 报表命令时，以下示例、stdout/stderr 和返回行为才按原契约使用；所有权不明确时零远端写。
+
 ## 严格禁止 (NEVER DO)
 
 - 不要在前端直接聚合表单数据，必须通过宜搭原生报表的 `getDataAsync.json` 或 `getCacheData.json` 接口获取聚合数据

package/yida-skills/skills-index.json

@@ -3,39 +3,6 @@
   "source": "openyida",
   "entry": "openyida",
   "skills": [
-    {
-      "name": "large-file-write",
-      "path": "skills/large-file-write/SKILL.md",
-      "display_name": "大文件可靠写入",
-      "description": "解决 heredoc 或 shell 命令写入大文件内容被截断的问题。优先使用 agent 结构化文件写入工具；超大文件可用该工具创建 Node.js payload 后执行。适用于需要可靠写入超过 100 行文本文件时。",
-      "category": "yida-skills/agent",
-      "tags": [
-        "大文件",
-        "写入",
-        "结构化文件",
-        "heredoc"
-      ],
-      "aliases": [
-        "大文件写入"
-      ]
-    },
-    {
-      "name": "sls-log-workbench",
-      "path": "skills/sls-log-workbench/SKILL.md",
-      "display_name": "SLS 日志查询工作台",
-      "description": "SLS 日志查询工作台排查技能。用于快速定位和排查宜搭平台的页面请求、业务规则、集成自动化、流程审批、TraceId、灰度匹配等问题。",
-      "category": "yida-skills/ops",
-      "tags": [
-        "SLS",
-        "日志",
-        "排查",
-        "TraceId"
-      ],
-      "aliases": [
-        "日志查询",
-        "平台排障"
-      ]
-    },
     {
       "name": "yida-agent-center",
       "path": "skills/yida-agent-center/SKILL.md",
@@ -56,7 +23,8 @@
       "name": "yida-app",
       "path": "skills/yida-app/SKILL.md",
       "display_name": "宜搭完整应用开发",
-      "description": "从零到一搭建完整宜搭应用的流程编排技能。默认 fast_build 只创建应用、必要表单、主页面、发布并输出链接；不默认使用未绑定 dataSourceMap，导航、示例数据和深度设计按需后置。",
+      "description": "完整搭建或补齐普通 OpenYida 应用的流程编排技能。默认 fast_build 先解析并复用 app/page/form/process 上下文，只创建缺失且允许创建的应用、表单或页面；预创建占位应用在语义名称稳定后通过 update-app 重命名；不默认使用未绑定 dataSourceMap，导航、示例数据和深度设计按需后置。",
+      "done_when": "若本轮 Write/Edit 页面源码，必须真实执行成功 openyida publish <source> <appType> <displayPageFormUuid> 并返回访问 URL；没有 publish 证据只能声明源码已修改，尚未发布。",
       "category": "yida-skills/app",
       "tags": [
         "宜搭",
@@ -192,7 +160,7 @@
         "build-page",
         "publish"
       ],
-      "done_when": "Canvas 源码生成并通过 Canvas 发布链路写入 YidaCodeCanvas Schema。"
+      "done_when": "Canvas 源码生成或修改后，必须真实执行成功 openyida publish <source> <appType> <displayPageFormUuid> 写入 YidaCodeCanvas Schema；没有 publish 证据只能声明源码已修改，尚未发布。"
     },
     {
       "name": "yida-canvas-data-binding",
@@ -330,7 +298,7 @@
       "name": "yida-create-app",
       "path": "skills/yida-create-app/SKILL.md",
       "display_name": "创建宜搭应用",
-      "description": "创建宜搭应用并返回 appType。搭建应用的第一步。",
+      "description": "仅在没有目标 app 且允许创建时创建宜搭应用并返回 appType。已绑定或预创建 app 不调用 create-app，应交给 yida-app 复用，并在需要时通过 update-app 重命名。",
       "category": "yida-skills/app",
       "tags": [
         "创建应用",
@@ -451,7 +419,7 @@
         "compile",
         "publish"
       ],
-      "done_when": "普通自定义页面源码通过 check-page / compile 并发布到目标页面。"
+      "done_when": "普通自定义页面源码通过 check-page / compile 后，必须真实执行成功 openyida publish <source> <appType> <displayPageFormUuid> 发布到目标 display 页面；没有 publish 证据只能声明源码已修改，尚未发布。"
     },
     {
       "name": "yida-dashboard",
@@ -745,7 +713,7 @@
       "name": "yida-login",
       "path": "skills/yida-login/SKILL.md",
       "display_name": "宜搭登录态管理",
-      "description": "宜搭登录态管理。默认 OAuth token 模式，access_token / refresh_token 持久化到 .cache/auth-token-<env>.json。",
+      "description": "宜搭登录态管理。默认 OAuth token 模式；YIDA_AUTH_ENABLED=true 时使用宿主注入 token。",
       "category": "yida-skills/context",
       "tags": [
         "登录",
@@ -924,6 +892,12 @@
       "path": "skills/yida-publish-page/SKILL.md",
       "display_name": "发布自定义页面",
       "description": "将自定义页面源码编译为宜搭可运行 Schema 并发布；源码依赖 dataSourceMap 但发布无数据源时不能视为完成。",
+      "command_ids": [
+        "check-page",
+        "compile",
+        "publish"
+      ],
+      "done_when": "final 证据只认真实执行成功的 openyida publish <source> <appType> <displayPageFormUuid> 命令结果；本地文件编辑、diff、check-page 或 compile 不能证明远端页面已更新。",
       "category": "yida-skills/page",
       "tags": [
         "发布",
@@ -1162,13 +1136,8 @@
     {
       "name": "yida-skills/ops",
       "display_name": "排障与支持",
-      "description": "SLS 日志排查、数据库 Sequence 修复、VOC 故障/需求反馈材料整理。",
+      "description": "数据库 Sequence 修复、VOC 故障/需求反馈材料整理。",
       "signals": [
-        "SLS",
-        "日志",
-        "traceId",
-        "排障",
-        "灰度",
         "Sequence",
         "主键冲突",
         "VOC",
@@ -1178,9 +1147,8 @@
     {
       "name": "yida-skills/agent",
       "display_name": "Agent 辅助工具",
-      "description": "非宜搭业务资源本身的 agent 辅助能力：大文件可靠写入、导出对话、会议/闪记转 PRD。",
+      "description": "非宜搭业务资源本身的 agent 辅助能力：导出对话、会议/闪记转 PRD。",
       "signals": [
-        "大文件写入",
         "导出对话",
         "会议纪要",
         "闪记",

package/yida-skills/skills/large-file-write/SKILL.md

@@ -1,93 +0,0 @@
----
-name: large-file-write
-description: 解决 heredoc 或 shell 命令写入大文件内容被截断的问题。优先使用 agent 结构化文件写入工具；超大文件可用该工具创建 Node.js payload 后执行。适用于需要可靠写入超过 100 行文本文件时。
----
-
-# Large File Write Skill
-
-## 问题背景
-
-在 AI Agent 模式下，使用 shell here-document 或其他 shell 命令向文件写入大块内容时，经常出现：
-- 内容被截断（工具输出超过 token 限制）
-- heredoc 内容未生效（zsh 特殊字符转义问题）
-- 多次追加导致重复内容或语法错误
-- Windows PowerShell 为了转义内容而执行 `Get-Content -Raw | ConvertTo-Json`，会把大 JSX/JS 文件整体读入内存并 JSON 转义，可能导致内存暴涨
-
-## 解决方案
-
-优先使用当前 agent 运行时提供的结构化文件写入工具（如 create_file / Write / file edit tool）直接创建目标文件。内容过大、单次写入可能截断时，再用结构化写入工具创建 Node.js payload 脚本，由 payload 调用 `fs.writeFileSync` 写目标文件。
-
-OpenYida 业务场景下，payload、内容片段和验证脚本必须放在 `<projectRoot>/.cache/openyida/<项目名或任务名>/scripts/`，不要写系统临时目录、仓库根目录或 `.cache/` 顶层。
-
-## 使用方式
-
-三种写入模式的完整代码示例，详见 [references/write-patterns.md](./references/write-patterns.md)：
-
-- **模式一**：创建内容脚本后执行（推荐）— 用结构化文件写入工具创建临时 JS 脚本，再 `node` 执行
-- **模式二**：追加内容到已有文件 — 用 `fs.appendFileSync` 追加大块内容
-- **模式三**：使用通用写入脚本（content-file 模式）— 内容文件也先由结构化文件写入工具创建
-
-### 快速示例
-
-```js
-// <projectRoot>/.cache/openyida/<任务名>/scripts/content-payload.js
-const fs = require('fs');
-const content = `// 你的大块内容（支持任意长度）
-export function myFunction() { ... }
-`;
-fs.writeFileSync('/path/to/target.js', content, 'utf8');
-console.log('写入完成，行数：', content.split('\n').length);
-```
-
-```bash
-node .cache/openyida/<任务名>/scripts/content-payload.js
-wc -l /path/to/target.js   # 验证行数
-```
-
-## 核心原则
-
-1. **永远不要用 heredoc 写大文件** — 改用结构化文件写入工具创建临时 JS 脚本
-2. **永远不要用 PowerShell JSON 化大文件** — 禁止 `Get-Content -Raw <file> | ConvertTo-Json`、`ConvertFrom-Json` 处理 `.oyd.jsx/.jsx/.js` 页面源码
-3. **内容放在 JS 模板字符串里** — 支持任意长度，不受 shell 限制
-4. **写完立即验证** — `wc -l` 检查行数，`tail` 检查末尾内容
-5. **分段写入大文件** — 超过 300 行的内容，拆分为多个结构化写入 + `node` 执行
-6. **本技能不读写 memory**：文件写入为纯本地操作，不依赖跨会话的 memory 状态
-
-## 适用场景
-
-- 宜搭自定义页面代码（通常 500-1500 行）
-- Three.js 场景代码
-- 任何超过 100 行的代码文件写入
-- Windows 环境下写入/修补大 `.oyd.jsx` 页面源码
-
-## Windows / PowerShell 禁止模式
-
-不要为了转义或生成 patch，把大页面源码转换成 JSON 字符串：
-
-```powershell
-# 禁止：会整体读入并生成多份转义副本，可能瞬间占用几十 GB 内存
-Get-Content -Raw project\pages\src\vendor-section.oyd.jsx | ConvertTo-Json
-```
-
-正确做法是直接用 Node 写入目标文件；需要局部替换时，用 Node 读取后做精确字符串/AST 替换并直接 `fs.writeFileSync` 写回，不要额外包成 JSON patch。
-
-## 触发条件
-
-**正向触发**：
-- 需要写入超过 100 行的代码文件
-- 使用 heredoc 或 shell 命令写文件时出现内容截断
-- 写入宜搭自定义页面代码（通常 500-1500 行）
-
-**不适用场景（不要触发）**：
-- 文件内容少于 100 行 → 直接使用 `create_file` 工具
-- 二进制文件写入 → 不适用
-- 仅追加少量内容 → 直接使用 `create_file`
-
-## 异常处理
-
-| 问题 | 原因 | 处理方式 |
-|------|------|----------|
-| `node: command not found` | Node.js 未安装 | 先安装 Node.js ≥ 16 |
-| 脚本执行后文件为空 | 模板字符串语法错误 | 检查反引号是否闭合，特殊字符是否转义 |
-| 写入不完整 | 内容超过单次 create_file 限制 | 按「分段写入」方式拆分为多个脚本 |
-| 权限拒绝 | 目标路径无写权限 | 检查目标目录权限；OpenYida 业务文件仍应留在 project 工作目录内 |

package/yida-skills/skills/large-file-write/references/write-patterns.md

@@ -1,147 +0,0 @@
-# 大文件写入模式参考
-
-本文档提供三种大文件写入模式的完整代码示例，供 AI Agent 直接参考使用。
-
-## 模式一：创建内容脚本后执行（推荐）
-
-适用于一次性写入大块内容（>100 行）。
-
-### Step 1：用结构化文件写入工具创建临时内容脚本
-
-```js
-// <projectRoot>/.cache/openyida/<任务名>/scripts/content-payload.js
-const fs = require('fs');
-const content = `
-// 这里放你要写入的大块内容
-// 支持任意长度，不受 heredoc 限制
-export function myFunction() {
-  // ...
-}
-`;
-fs.writeFileSync('/path/to/target.js', content, 'utf8');
-console.log('写入完成，行数：', content.split('\n').length);
-```
-
-### Step 2：执行脚本
-
-```bash
-node .cache/openyida/<任务名>/scripts/content-payload.js
-```
-
-### Step 3：验证写入结果
-
-```bash
-wc -l /path/to/target.js
-tail -5 /path/to/target.js
-```
-
----
-
-## 模式二：追加内容到已有文件
-
-适用于向已有文件末尾追加大块内容。
-
-```js
-// <projectRoot>/.cache/openyida/<任务名>/scripts/append-payload.js
-const fs = require('fs');
-const appendContent = `
-// 追加的内容
-export function additionalFunction() {
-  // ...
-}
-`;
-fs.appendFileSync('/path/to/target.js', appendContent, 'utf8');
-console.log('追加完成');
-```
-
-执行：
-
-```bash
-node .cache/openyida/<任务名>/scripts/append-payload.js
-```
-
----
-
-## 模式三：使用通用写入脚本（content-file 模式）
-
-适用于内容已经由结构化文件写入工具保存为独立文件的场景。
-
-```bash
-node ~/.agents/skills/large-file-write/scripts/write.js \
-  --file /path/to/target.js \
-  --content-file .cache/openyida/<任务名>/scripts/content.txt \
-  --mode write   # 或 append
-```
-
-不要通过 shell 管道、heredoc 或重定向临时生成 `content.txt`；先使用 create_file / Write / file edit tool 创建它。
-
----
-
-## Windows / PowerShell 禁止模式
-
-**不要**用 PowerShell 把大 JSX/JS 文件转成 JSON patch：
-
-禁止把整个文件读入内存再重定向成 JSON patch，例如 `Get-Content -Raw ... | ConvertTo-Json` 这类流程会制造巨大中间数据，也违反“命令输入文件由结构化写入工具创建”的约定。
-
-这种写法会同时持有原始源码、JSON 转义字符串、管道对象和输出缓冲。对包含 vendor、base64、压缩代码的 `.oyd.jsx` 文件，内存可能被放大到数十 GB。
-
-请改用 Node：
-
-```js
-const fs = require('fs');
-const target = 'project/pages/src/vendor-section.oyd.jsx';
-const source = fs.readFileSync(target, 'utf8');
-const next = source.replace('old snippet', 'new snippet');
-fs.writeFileSync(target, next, 'utf8');
-```
-
-如果替换内容很大，按下文“分段写入大文件”拆分。
-
----
-
-## 分段写入大文件（>300 行）
-
-当单次内容超过 300 行时，拆分为多个脚本分段写入：
-
-```js
-// <projectRoot>/.cache/openyida/<任务名>/scripts/part1-payload.js — 写入第一段（文件头 + 前半部分）
-const fs = require('fs');
-const part1 = `
-// === 第一段内容 ===
-const CONSTANTS = { ... };
-export function functionA() { ... }
-`;
-fs.writeFileSync('/path/to/target.js', part1, 'utf8');
-console.log('第一段写入完成');
-```
-
-```js
-// <projectRoot>/.cache/openyida/<任务名>/scripts/part2-payload.js — 追加第二段
-const fs = require('fs');
-const part2 = `
-// === 第二段内容 ===
-export function functionB() { ... }
-export function functionC() { ... }
-`;
-fs.appendFileSync('/path/to/target.js', part2, 'utf8');
-console.log('第二段追加完成');
-```
-
-验证最终结果：
-
-```bash
-wc -l /path/to/target.js
-head -5 /path/to/target.js
-tail -5 /path/to/target.js
-```
-
----
-
-## 常见错误与修复
-
-| 错误现象 | 原因 | 修复方式 |
-|---------|------|---------|
-| 文件为空 | 模板字符串反引号未闭合 | 检查 `` ` `` 是否成对，特殊字符是否转义 |
-| 内容截断 | 单次 create_file 超过 token 限制 | 拆分为多个脚本分段写入 |
-| 权限拒绝 | 目标路径无写权限 | 检查目标目录权限；OpenYida 业务文件仍应留在 project 工作目录内 |
-| node 命令未找到 | Node.js 未安装 | 先安装 Node.js ≥ 16 |