@givolt/i3-composer-agent 3.0.0 → 3.2.1

package/docs/ui-prototype-native/MAIN-SESSION-REPORT.md

@@ -1,66 +0,0 @@
-# 主会话原型改造验证报告
-
-<!-- i3:zh-guide:start -->
-## 中文使用说明
-
-按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
-
-默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
-<!-- i3:zh-guide:end -->
-
-日期：2026-10-17。源码分支：feature/prototype-native-pilot。首期为CodeBuddy＋admin-list小模板＋Vue 3/antDv-next设备流程。实施及样例技术验收完成，补充复核后的当前收据已完成；用户视觉/业务评审仍为pending-review。正式main与上游保全基线未变，未合并或发布。
-
-## 已完成改造
-
-取消prototype-specialist专责Agent、常驻分派规则及父子JSON强制；自然语言、using、/i3-prototype、直接Skill均由主会话执行。using以原版aeac41d4为基线，只增加普通原型分支和Quick Reference行；移除两行后SHA256为30787ef2c77bf1a4729fffed0f6523ba6fcbe81bdc436b36371b78c21394d3c3。三宿主命令格式仍是薄入口，不承担企业调度。
-
-企业SOP在外层组织PRD、设计取舍、制作、技术验证、人工认可与工程交接；原型Skill按需复用前端、官方框架、UIUX和浏览器方法。业务/技术规格、任务tracker及正式发布仍依上游方法，不增加企业审批库或专属Agent。
-
-HTML继续可离线修改，是内容和能力输入。生成原型采用真实ConfigProvider/Table/Form/Drawer等组件；本次需求明确绑定“明亮、暗黑、清新、科技”，首次默认明亮，页面内切换，不重挂应用或丢失筛选/页码/选择/未保存输入。旧HTML及未绑定主题的固定实例不自动加入主题、不重写摘要。模板内容和最终框架效果分别验证。
-
-已有安装按清单归属＋已审原字节指纹安全退出旧角色/规则；修改过、来源不明的受管退出资产会阻断，force不绕过；用户文件保留。维护宿主工具不自动成为上游/全局Hook。
-
-## 主要实证
-
-证据根：工作区artifacts/verification/prototype-main-session-20261017/。
-
-| 范围 | 实际结果 | 证据 |
-|---|---|---|
-| 源码与分发 | 全回归528/528、零跳过；实际打包/安装各340/340；最终冻结复验以相邻JSON/log为准 | source-final-guidance.*、source-delivery-final.*、candidate-3-*-test.*、delivery-package/ |
-| 退出与升级 | 真实旧tgz→新tgz项目/global角色5→4，用户规则保留；16项迁移保护通过 | installation/real-upgrade-RESULT.json |
-| 离线HTML | 实际断网file://修改、展示、同步提取，3本地请求、0外部请求/console错误，未起服务 | offline-html-check/ |
-| CLI四入口 | 真实Skill调用、完整分析回传，无Agent；734文件前后同一，SDK/工具/缓存未变 | ENTRY-MATRIX.json、probe-*/ |
-| CodeBuddy IDE入口 | 实际识别/展开命令、UseSkill及主会话中文回传，732安装文件比较无异常差异 | ide-command/ |
-| 全新业务冷生成 | 100工具/22MCP，无Agent，processComplete=true；官方/前端/browser Skill及真实UIUX查询/设计/构建；7/7单测、类型与构建通过 | cold-main-session-v2/、cold-v2-preflight.json |
-| 完整原型专项 | 23/23、零console错误/警告，同一candidate/build，含四主题/状态/偏好/隔离、Drawer动效/毛玻璃/焦点、窄屏/键盘和故障对照 | cold-project-v2/prototypes/main-devices/qa/runs/chrome-1792253902290/ |
-| UIUX实际Skill复查 | Skill(ui-ux-pro-max)真实加载，31工具，零文件/缓存变更；采纳/拒绝与效果分别核对，无阻断 | uiux-final-review/ |
-| 真实交互DevTools补录 | 实际browser Skill，44次MCP/51工具，trace含13 click/1 input，六类观测与操作后console/network已保存；48轮上限后无最终模型回复，未算该轮自动完成 | devtools-interaction-supplement/ |
-| 独立输入/焦点诊断 | 实际固定MCP原生Backspace恢复21；空名保存拒绝、错误/焦点/抽屉/列表均正确，console0 | mcp-empty-fill-diagnostic/run-006/ |
-| 审定与交付 | 原始事件审计、修正登记后build/browser/devtoolsReview/delivery均current，nextAction=return-result；passed、pending-review | FINAL-COLD-AUDIT.json、audited-state-final.json、实例qa/delivery.json |
-| 兼容保护 | 337摘要/模式未变、原先REPORT/TASKS字节前缀保留；旧v1/v2固定合同不追随新模板 | protected-current.json |
-
-当前原型：main-devices/r001，candidateDigest=793e0a1eee86bad6e9a081548840cc6408aded05347fa8485f050611f71f1954；buildId=b-193a4dfa2f1be867ceb1，buildDigest=193a4dfa2f1be867ceb103690bdc451ceabcbee0ef29875d388fc420c88f637c。
-
-## 发现、修复与证据纠正
-
-真实冷运行发现原生分页内部隐藏链接仍能获得焦点。中央starter只将page项渲染为不可聚焦span，保留外层LI及鼠标/键盘；新固定快照启用paginationFocusGuard，旧快照缺字段维持原合同。AX普通鼠标可复现、故障负例能失败、修复后的23项与零候选warning均有实证。
-
-CodeBuddy2.168.2初层fill参数scalar与后层完整对象换ID格式，维护宿主已做极窄兼容（固定managed1.11.0、非只读、精确PreToolUse和fill），19/19及独立审查通过，实际新补录也无auditDenied。不能据此建立通用跨层deny绑定保证；实际文件边界另由OS策略及差异证明，不扩大写目录，不改上游Hook/全局配置。
-
-独立审计发现初版模型报告的时区错误、调用ID占位、MCP网络摘要和冷缓存措辞不实，性能trace只覆盖reload。原始字节与原最终回复保留，未接受其自评结论。当前报告从真实UTC/call_*生成；MCP仅确认URL/状态，真实响应字节SHA来自独立Playwright观测。UIUX原生成有provider查询但没有Skill调用，真实Skill复查由后续只读阶段完成，不改写历史。
-
-补录的完整五分钟交互trace解压70,406,491字节，登记器64MiB边界正确拒绝。原件未改；以明确标注来源、摘要和窗口的前120秒连续原事件导出登记（34,338,470字节、7 click/1 input），不改上限、不筛事件类别、不宣称该片段就是完整录制。索引在实例qa/devtools/audited/trace-excerpt-index.json。
-
-另独立复现固定MCP1.11.0的空fill直接清DOM而未发input/change：查询/校验仍读旧绑定。正常键盘/Playwright为空可正确工作。真实MCP以当前文本和末尾光标为准逐次Backspace验证通过；Meta+A/Control+A未全选、空格可能追加旧值等失败保留。自有Skill已补实测指引，上游浏览器Skill/MCP/组件库不改。该工具事件问题与宿主scalar参数兼容分别记录。诊断run-004在抛弃的独立profile中误做一次非空保存已披露；通过run-006无成功保存，应用文件、共享模型profile、旧QA均未变。
-
-第一次源码/机械浏览器失败、第一次冷生成120轮未完、维护者误期待revise自动刷新快照而停止的阶段、补录48轮上限、客户端参数/解析错误、64MiB拒绝均保留。revise只接受已整理输入摘要，不自动迁移framework；旧实例未手补新字段。
-
-## 结论边界
-
-首期样例经过实际主会话制作、专项回归及补充复核后具备待评审交付条件。不能扩展为所有模型/宿主/页面或单轮无人复核都可靠。短种子未触发长文本ellipsis的专门视觉用例，未声称该效果已经实测。技术验证不代替人类认可，不执行confirm-baseline。
-
-四CLI入口和IDE入口来自C1；C2的using/三命令字节相同，C2完成新业务冷生成。其后仅自有输入事件指引与维护文档修订；最终包与C2实现/模板/框架/浏览器执行器/入口的字节比较、精确包摘要和最终打包/安装结果以delivery-package/及FINAL-PACKAGE.json为准，不冒认最终说明版本另跑了一次完整冷生成。
-
-只读CLI的工具限制、OS写保护及零缓存结论不外推到任意IDE/全工具配置；IDE实际界面请求保留无害残留前缀，项目根重定位只归一确切安装路径，不对用户级会话日志宣称零写入。可写冷生成使用独立npm缓存产生正常依赖缓存/日志；SDK与固定工具未改。
-
-本次改造提交保留在试点分支，未安装覆盖用户现有全局环境、未合并、未发布。最终可预览当前候选，仍需用户针对明确revision/digest进行业务和视觉评审。

package/docs/ui-prototype-native/USAGE.md

@@ -1,93 +0,0 @@
-# 原型制作与续接
-
-<!-- i3:zh-guide:start -->
-## 中文使用说明
-
-按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
-
-默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
-<!-- i3:zh-guide:end -->
-
-当前默认内容模板为完整企业管理后台，生成目标为 Vue3＋antDv-next。HTML 参考可以离线编辑；生成的框架工程需要安装依赖、构建并启动预览。安装方式见 [CodeBuddy 说明](../codebuddy-setup.md)。
-
-## 在 CodeBuddy 发起
-
-```text
-/i3-prototype analyze 根据 PRD 分析原型范围和模板适用能力，先不写入或安装
-/i3-prototype create 根据 PRD，参考完整 enterprise-admin 模板，生成 Vue3＋antDv-next 原型，ID 为 assets
-```
-
-自然语言、命令、using 选择及直接调用 Skill 均由主会话执行，无原型专责 Agent。using 按普通发现逻辑选择原型 Skill；原型流程按阶段复用前端、官方框架、UIUX 和浏览器能力，避免一次加载全部模板、依赖源码及历史日志。
-
-只读分析交付覆盖、选型、验收计划及缺口，不创建原型、安装依赖、启动浏览器或保存用户级记忆。创建／修订的写入限于本次项目与明确范围，长期记忆、全局配置及其他项目另需明确授权。
-
-## 可选官方 Skill 与后续检测
-
-从业务项目根运行：
-
-```sh
-node .codebuddy/skills/i3-ui-prototype/scripts/prototype-dependencies.cjs check --project .
-# 以下仅在明确选择安装后执行，可单独选 uiux 或 antdv：
-node .codebuddy/skills/i3-ui-prototype/scripts/prototype-dependencies.cjs install --project . --skills uiux,antdv
-```
-
-i3 默认不安装这两项依赖，跳过不永久禁用。后续补装后重新检测即可，无需重装 i3；必要时重载 CodeBuddy 窗口或新建会话让宿主发现。已有可用全局 UIUX 可复用，已有第三方技能和工具不覆盖。缺 Python 仅报告，不安装系统运行环境。官方正文、许可、版本和来源保留，详情见已安装 Skill 的 references/optional-skills.md。
-
-UIUX 专业模式为默认，缺少可用查询资源会提示，不静默降级；用户明确选择基础模板模式后仍完成同样业务功能、四主题和验收。安装依赖不会自动改变既有原型的模式、源码或证据。检测不代表真实宿主调用；CodeBuddy 仍须通过其 Skill 工具实际加载。
-
-antDv 官方 Skill 和组件库是独立部分：未安装 Skill 时可使用对应版本官方文档／类型／源码，记录实际渠道；生成工程仍需 antDv-next 库。新工具目录为对应宿主基址下的 tools/i3-prototype/antdv-cli，支持项目和全局安装；旧 .prototype-tools/antdv-cli 保留读取兼容；只读检测返回可执行的 Node 入口，也识别既有 .prototype-tools/node_modules 布局。固定 CLI 0.0.0-beta.1 的 1.5.2 知识仅作参考，目标组件库 1.5.3 仍核对实际类型／源码。不自动升级 CLI，不以 Error 文本、exit 0 或占位 lint 代替成功。
-
-## 内置模板与业务原型
-
-```sh
-node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs template-page --page models-page
-```
-
-默认只读使用 Skill 安装目录 assets/templates/enterprise-admin 中随版本发布的完整模板，业务项目不生成 ui-templates。可双击内置 index.html 离线查看；模板内容由维护者在 Skill 源码中修改、校验并随包发布，业务使用期间不修改安装目录。索引在内存只读计算，随生成时的模板、范围与能力快照固定到 inputs。业务修改直接落在 prototypes/<id>/app/，Skill 升级不隐式改写已有原型。
-
-只读取本次相关页面。完整索引提供参考页面、路由和资源清单，不表示自动理解或实现全部旧业务。已有 ui-templates 副本保留，不自动读取、覆盖或删除；明确需要其手工内容时，先显式 sync-template 该副本，再在 create 时传 --template-root <已有目录>。旧 prepare-template 命令继续用于兼容，不是新流程必需步骤。
-
-## 需求范围与创建
-
-主会话根据实际 PRD 整理 schemaVersion=2 的 prototypes/.preparation/assets/scope.json，moduleIds 填实际模块 ID（未关联填 []），索引 appliesTo 自动去重生成：逐页声明业务标题、referencePage、区域类型、需求原文及来源。列表适用查询、复选、分页、批量与状态反馈；编辑区域适用校验、保存失败保留和重试。豁免须有明确需求依据。不能漏报实际区域来逃避能力。
-
-新原型默认提供明亮、暗黑、清新、科技，默认明亮，无编号。列表默认可调分页 10／20／50，默认 10；在 scope 的区域参数中明确覆盖真实需要。旧实例仍按原有固定输入，不追溯修改。
-
-```sh
-node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs create --project . --id assets --scope prototypes/.preparation/assets/scope.json --host codebuddy
-# 仅在明确选择基础模板模式后，增加 --expert-mode template。
-```
-
-必须提供有来源的 scope，不再自动回退设备演示需求。目标存在时先读取 state，按修订流程保留已有手改，不重新 create。初始化仅提供需求对应的原生框架骨架和主题，business.status 为 needs-adaptation；主会话继续实现实际业务页面、字段、模拟数据和交互后才可验收。
-
-## 实现、构建与真实验收
-
-按需使用 i3-frontend-ui-engineering、可调用的 antDv 官方 Skill、UIUX 查询和取舍。官方 Skill 可调用时先实际加载；无法调用时记录官方资料等效渠道。UIUX 的加载、真实查询、建议采用与效果验证分别有依据。
-
-```sh
-node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs state prototypes/assets
-node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs build prototypes/assets --install
-node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs preview prototypes/assets
-```
-
-首次且允许安装工程依赖时用 --install，之后复用已安装依赖。业务流程覆盖查询、多选、分页、编辑抽屉、校验失败、提交失败、重试保存及列表同步；另验抽屉进入／退出、模糊遮罩、四主题保留状态、窄屏、键盘与焦点恢复。
-
-主会话实际加载 i3-browser-testing-with-devtools，通过 Chrome DevTools MCP 对当前构建检查 DOM／计算样式、截图、console、network、可访问性及性能。缺少工具时保留未验证；读取 Skill、只有截图或运行补充脚本不能冒充该链路通过。浏览器使用项目 localhost 和隔离测试环境。
-
-按 inputs/acceptance.json 的本次业务场景实测，保存真实报告，再登记：
-
-```sh
-node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs record-run prototypes/assets --report /absolute/path/actual-business-report.json
-node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs record-devtools-review prototypes/assets --report /absolute/path/actual-devtools-report.json
-node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs state prototypes/assets
-```
-
-从 state 取得当前准确的 finalize／revise 命令；不要复用修改前摘要。结构校验及报告导入不证明真实 Skill 调用，仍须核对原始宿主调用记录。源码或固定输入变化后重建并重验受影响场景。native-pilot 的历史 browser 子命令仅服务旧设备合同，不适用于新完整模板业务。
-
-## 续接、兼容与交付
-
-新会话先 state 恢复身份、范围、模式、构建与证据，按 nextAction 继续，不重新生成覆盖。已有 v1 HTML 与旧 v2 原生实例按原合同检查，保留原摘要、手改和认可基线；小模板仅保留测试夹具，旧设备框架起点在 legacy-starter，不作为新生成入口。
-
-最终回复给出原型路径、范围、revision、实际模式、已执行检查、证据及未决项。完成本地技术验证仍为 pending-review，人工认可具体 revision／digest 后才能冻结基线；不把骨架、安装通过或自填报告当作业务完成。
-
-共享索引为 prototypes/index.json，旧根索引保持兼容。只安装不创建业务目录；全局 Skill 仍把原型留在业务项目，缓存按宿主与项目隔离。查询、同步、显式迁移和浏览器输出命令见 Skill 的 references/project-layout.md。

package/references/engineering-skeleton-resources/README.md

@@ -1,52 +0,0 @@
-# 工程骨架资源入口
-
-<!-- i3:zh-guide:start -->
-## 中文使用说明
-
-按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
-
-默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
-<!-- i3:zh-guide:end -->
-
-资源内容版本：1.0.0。定位：语言无关的工程目录规范。AD 确定工程与模块的落点，原 Plan 把路径写入任务，获准的原 Build 在这些位置实现，再核对实际文件。目录规范不要求先取得企业代码模板或选定统一技术栈。
-
-## 1. 从哪里开始
-
-1. 读 [目录规范](directory-standard.md)，按实际项目选择 PBC 组合工程或独立 Agent 组织方式；只采用需要的工程目录。
-2. 按 [采用与交接说明](adoption.md)，在项目已有工程说明或 AD 中写明采用版本、实际路径和必要例外。
-3. 把明确采用的 AD、公共技术规约及该说明交给原 Plan；计划经所需审阅后，由原 Build 或原 Build auto 按原有条件执行。
-4. 按采用说明核对新增、修改文件的真实落点；构建、测试和业务验证仍执行各自原有要求。
-
-现有项目规范优先，已有代码不为套目录批量迁移。安装资源、目录存在或 JSON 引用本身都不会自动启用企业 SOP，也不会使原 Plan／Build 自动读取本资源。必须在本次任务或已采用项目指引中明确引用。
-
-## 2. 本资源包含什么
-
-| 文件 | 用途 |
-| --- | --- |
-| [catalog.json](catalog.json) | 资源版本、目录规范及两类组织方式的索引 |
-| [directory-standard.md](directory-standard.md) | 目录职责、命名、工程边界、共享内容及实际落点规则 |
-| [adoption.md](adoption.md) | AD、原 Plan、原 Build 的交接，手动／JSON 引用及目录验收；§6 提供存量映射、规范选择性更新、人工保护和按需迁移说明 |
-
-pbc-composite 与 agent-standalone 是目录组织方式。frontend、backend、agents、jobs 是可按需采用的工程类别；它们不表示本资源已提供或验证任何语言／框架的代码模板。
-
-公共技术规约继续使用项目已有规范或企业 SOP 已有资源，本资源不另建技术权威。UI 原型模板仍用于交互与样式设计，生产工程由实际 AD、任务和技术栈确定。
-
-## 3. 实施与采用边界
-
-本资源不新增顶级 Skill 或命令，不改原版技能、命令、原型、Hook、安装器或 SOP 运行资源。原版 25 个 Skill／9 个命令与已发布版本的既有能力保留；整合 SOP 后的目标数量仍为 27／11／4。
-
-业务 JSON 顶层仍为 schemaVersion、scope、selected。需要时沿用 selected 主题内已有 engineeringSkeleton，引用项目真实采用说明；直接给原 Plan 同一组实际路径也可。不另建 project.yaml、锁文件、任务数据库或候选登记流程。
-
-目录规范已形成自有源码资源；原生命令的真实读取／实施效果、发行包与宿主安装、人工验收分别验证。该资源没有提供目录生成器或代码框架模板，也不声称用提示词即可硬性拦截所有越界写入。
-
-## 4. 现有项目与规范更新从哪里开始
-
-- 已有工程先按[采用说明 §6](adoption.md)只读映射实际目录和命令，复用 web、services 或框架根布局，不为统一示例搬源码或再造同名工程。
-- 新资源只供比较。先读项目当前采用说明和本次明确的新来源，展示差异及受影响规格／任务；人可选择保留当前、部分采用或整体采用。没有明确采用就不写项目副本、JSON 或代码。
-- 明确采用后，保留项目例外、人工条款和文件历史。使用项目既有说明或规格承载结果；不另建采用状态库，目录确需迁移再交原 Plan／获准 Build。
-
-标准项目沿用自己的 SPEC 或等效规格，不因为采用目录规范就补企业 BRD／PRD／AD 或启用企业 SOP。企业项目按已选 AD／PRD 交接。手动路径继续可用；已有 JSON 只引用实际采用文件，不增加更新或迁移状态。
-
-安装文件与项目采用副本需区分：直接改过安装目录的内容先识别并保留为项目资料，不把本说明当作安装器自动保护所有人工修改的证明。已选来源不可读或旧版本已被替换时，展示准确缺项和选择，不静默换源或宣称仍在用旧版。
-
-本版补齐的是采用规则与可复制用法；实际模型读取、选择性更新、迁移、包／安装效果仍按各自证据验收，不以说明存在或版本号提高代替。

package/references/engineering-skeleton-resources/adoption.md

@@ -1,200 +0,0 @@
-# 工程目录规范的采用与原 Plan／Build 交接
-
-<!-- i3:zh-guide:start -->
-## 中文使用说明
-
-按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
-
-默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
-<!-- i3:zh-guide:end -->
-
-版本：1.0.0。配套：[工程目录规范](directory-standard.md)。适用于明确选择该规范的新项目或现有项目，不随安装自动启用。§1—5 以企业 AD 交接为例；标准项目沿用自己的 SPEC 或等效规格，不补企业文档。存量接入、选择性更新和人工保护见 §6；入口与资源索引见 [README](README.md)。
-
-## 1. 采用时明确什么
-
-先确定真实业务项目根、当前能力／需求主题、所选 AD 及已有代码位置。项目已有工程规范时优先复用；本资源补充目录职责或映射，不重选技术栈，也不把维护 i3 Skill 的仓库当成业务工程根。
-
-目录规范可以在 AD 准备时选定，无需另外调用一个工程骨架命令。技术栈、工程内部布局及构建命令仍由公共技术规约、实际配置和 AD 明确。目录规范能够先采用；尚未确定的技术决策只限制依赖它的设计或实施任务。
-
-将采用结果写入项目已有工程说明；没有合适位置时，可使用 docs/engineering/engineering-layout.md，或直接写在 AD 的相应章节。以下是填写要点，实际路径和状态据实填写，不为每个项目重复建立全部文档：
-
-| 项目 | 填写内容 |
-| --- | --- |
-| 采用来源 | 实际采用规范的真实可读路径及正文版本（本资源为 1.0.0）；使用项目副本时保留其来源、明确选用范围及本项目修改说明 |
-| 组织方式 | pbc-composite 或 agent-standalone；选择理由与项目根 |
-| 实际工程映射 | 工程稳定标识、类别、实际根、已有／拟建、业务模块、共享维护方与消费者 |
-| 配套依据 | 当前 AD 的身份／版本／路径、公共技术规约、必要契约及已有代码 |
-| 目录例外 | 现有结构或框架惯例与规范示例的差异、理由、影响及明确采用情况 |
-| 验证要求 | 本次文件落点核对及实际构建／测试方法；尚无代码时写待实施，不预填通过 |
-
-使用项目已采用副本后，以该副本为本次输入；发行资源更新不覆盖它。原路径失效、版本含糊或映射冲突时先说明准确缺项，不静默改读另一个来源。
-
-## 2. AD 如何引用
-
-沿用现有 AD 模板的栏目，不修改模板或原 Spec：
-
-| 现有 AD 位置 | 本次承接内容 |
-| --- | --- |
-| §0.3 公共技术规约、契约与骨架的本次采用 | 引用目录规范或项目采用说明的准确路径／版本，说明适用工程 |
-| §9.2 项目目录与维护位置 | 工程根、模块／源码、配置、测试、契约和运行装配的真实或拟建路径及 owner |
-| §9.6 工程骨架采用与落地 | 区分现有工程事实与拟建内容；落实当前技术选择、构建／启动／验证／恢复条件及依赖缺口 |
-
-其他版本的 AD 使用同义栏目。AD 的整体技术架构图、功能架构图、数据实体关系及必要详细设计仍完整保留，不能以目录规范替代。
-
-目录标准是实际可读的规范输入，不能据此把“可运行代码模板已取得”或“工程已生成”填为成功。未采用代码框架模板时可据实写“目录规范已采用；工程拟建；未采用代码框架模板”；语言／框架代码由后续获准任务实现。已有代码则引用真实代码／配置。若本项目另行要求复用特定代码模板，仍需取得它，不由本规范替代。
-
-一个 PBC 多份主题 PRD 的各自 AD 引用同一项目规范，并分别映射相关模块；不因 PRD 数量或版本变化重复创建工程。
-
-## 3. 交给原 Plan 的方式
-
-原 Plan 读取 SPEC.md 或等效规格。选定 AD 与其准确 PRD、公共技术规约、契约及目录采用说明共同提供本次等效规格；原 SPEC 六项内容须足够明确。独立 TestCase 为可选输入，已有且适用就引用；原型按需，可与 AD 并行。
-
-手动方式直接提供上述实际路径。已有三字段 JSON 时，可让本次任务先解析 selected 中当前主题的 engineeringSkeleton 及配套路径，再实际读取正文；选择路径不等于读取成功、认可或实施许可。无需为了目录规范新建 JSON，也不把工程说明写入新的顶层字段。
-
-先按当前主题读采用说明和必要规范条款，再读该主题 AD／PRD、所涉代码和共享消费者；不一次加载全部历史、所有主题或所有工程源码。跨主题共用约束及直接依赖仍须读齐。
-
-在项目根使用以下提示；替换方括号中的实际路径。它是原命令的明确任务上下文，不是新增命令参数：
-
-```text
-/i3-plan
-为本次已明确的需求范围制定计划：
-AD：[实际 AD 路径]；准确 PRD：[实际 PRD 路径]。
-公共技术规约：[已采用规范路径]；工程目录采用说明：[实际路径]。
-必要共享契约及已有代码：[实际路径；没有则说明不适用]。
-请实际读取这些来源；缺项或冲突先列出，不猜技术版本。
-按 AD 的工程／模块映射拆任务，明确新增或修改文件相对项目根的位置、
-工程负责人／共享依赖、验收条件及实际验证方法。
-将源码、配置和测试放入已采用位置；已有结构的例外明确写在计划里。
-保留原 Plan 的默认产物、唯一任务目标和审阅停点，不改业务稿。
-```
-
-计划沿用 tasks/plan.md 和原方法确定的唯一任务目标；默认文件目标为 tasks/todo.md，采用其他 tracker 时不复制竞争状态。不同未完成工作不覆盖。工程落点不是把模块名写入任务即可：任务的 Files likely touched 应包含预计路径，验收条件要核对真实新增／修改文件；实施中合理新增文件也须按映射核对。
-
-## 4. 原 Build 如何执行
-
-计划满足原有认可及执行条件后，原 Build 从计划取任务。任务必须指向当前 AD、目录采用说明和所需规范，使执行时能实际回读，而非只相信计划摘要或 JSON 的存在。
-
-```text
-/i3-build
-执行当前计划的下一项获准任务。
-先回读该任务引用的 AD、目录采用说明及所需规范／代码。
-按已采用工程根和模块路径实现；出现目录冲突先说明位置、原因和建议，
-不自行另建同名工程或把源码放进 spec、tasks、文档模板目录。
-完成原有验证后，对照任务及目录映射列出实际变更文件和落点差异。
-业务稿、人工代码和已完成任务按原规则保留。
-```
-
-原 /i3-build auto 使用同一份获准 Plan 和目录映射，保持原有 spec/ 识别、Git、计划认可、TDD／构建及逐任务执行条件。它不会因为本资源存在而自动读取规范；需要时在本次任务上下文明确引用。企业跨阶段 auto／调度不在本资源范围。
-
-规范期望目录约束被设计、任务和验收共同落实，不提供拦截一切写入的 Hook。未实际读取、任务没有落点或实际文件越界时，不声称目录验收通过。
-
-## 5. Build 后如何核目录
-
-在实际业务项目中核对本次任务新增、修改和必要删除的文件。可用 git status --short、针对任务的 git diff／文件清单及实际配置获取事实；不把其他人的未提交文件混作本次结果，也不只看空目录树。
-
-| 核对项 | 通过条件 |
-| --- | --- |
-| 来源与范围 | 当前 AD、目录采用说明及任务可回读，采用版本和实际工程根一致 |
-| 文件落点 | 每个变更文件都能映射到工程／模块、共用资产或原有管理文档位置；例外有明确依据 |
-| 工程边界 | 同一工程标识未重复创建，未按每份 PRD 再造底座；没有未经采用的顶层代码目录 |
-| 共享责任 | 契约、共用代码及跨工程测试各有实际维护位置与相关消费者，未复制其他主题的共享权威 |
-| 构建与测试 | 实际配置的源码、资源、测试和产物路径与采用映射一致；完成本次要求的原有验证 |
-| 人工内容 | 既有目录、项目自改规范、人工代码和已完成任务保留；无整仓覆盖或未经说明的移动／删除 |
-
-结果沿用原工程验证记录或本次任务总结，至少列出“文件／实际位置／采用依据／差异处理／验证结果”。不另建任务完成率或审批状态文件。构建产物、依赖、缓存按实际工具配置和忽略规则处理，不因出现 dist、target、node_modules 等就判源码越界。
-
-落点有偏差时先标注准确位置、影响、推荐和可选处理（按规范调整，或明确采用例外后同步 AD／Plan），不自动移动人工代码或改业务稿。目录核对通过与构建、业务测试、独立审查、Ship 就绪及发布分别记录。
-
-## 6. 现有工程与后续变更
-
-### 6.1 先确定本次范围与真实现状
-
-仅在本次任务明确采用或项目已采用指引指定时读取本资源。标准项目沿用自己的 SPEC 或等效规格，目录采用不要求补企业 BRD／PRD／AD；§2—5 的 AD 交接是企业 SOP 用法，标准项目将相同目录依据交给自己的规格与原 Plan。安装、目录存在、PRD 或 JSON 字样不激活企业 SOP。
-
-先确定实际业务项目根、本次需求／工程范围、已选规格、当前采用说明和唯一任务目标，再只读检查相关工程入口、源码／测试、构建／运行配置、项目自改说明及必要共享消费者。按当前主题加载必要来源和直接依赖，不一次读全部历史或所有工程；不猜语言／框架版本，不因缺项重选技术栈。
-
-### 6.2 把现有目录映射到逻辑职责
-
-| 逻辑职责 | 现有位置示例 | 映射与保护要求 |
-| --- | --- | --- |
-| frontend | web/、apps/console/ | 保留前端工程标识、框架入口和内部结构；不另外生成同名 frontend 工程 |
-| backend | services/asset-api/、server/ | 映射真实源码／测试／配置位置，不再建 backend/asset-api/ 的第二套底座 |
-| agents | 项目根“.”、已有服务内模块、agents/ 下工程 | 独立 Agent 可沿用根布局；服务内组件映射真实子路径，不强行拆工程 |
-| jobs | worker/、jobs/、现有后端任务模块 | 按触发与执行职责映射；目录名不决定进程或部署边界 |
-| 共用资产与配置 | 既有契约、shared、测试、CI／运行装配位置 | 保留实际维护位置、owner 和消费者；不按每份 PRD 复制共享权威 |
-
-采用结果复用项目现有工程说明，或写入当前规格；没有合适载体时才按需使用 docs/engineering/engineering-layout.md。至少列出来源／版本、项目根与组织方式、工程稳定标识及类别、实际根、已有／拟建、源码／配置／测试位置、维护方／消费者、例外与理由、真实验证命令和未定项。不要求每个项目重复建全部文档。
-
-在只读接入阶段，输出映射建议、缺项和影响，不创建目录、不写采用说明、不改业务稿或 JSON。人明确采用后才更新获准的工程说明；规格变化可由人修改或按原 Spec 形成候审稿，I5 不自动修业务稿。缺失事实只限制依赖它的任务，不能无依据阻断其他范围。
-
-已有不同工作的未完计划时，指出准确冲突并保留 tasks/plan.md、todo 或已有 tracker；不覆盖、批量关闭或另建竞争任务库。接入规范不清除旧任务、未提交改动或原始失败记录。
-
-### 6.3 比较新资源，再明确选择
-
-实际读取项目当前采用说明／副本，以及本次明确比较的新资源；先展示准确路径、正文版本、条款差异、项目例外和受影响工程／规格／未完任务。如有可读的旧采用来源，可辅助判断；没有时列明无法确定之处，不猜哪些段落属于用户修改，不建立新的基线库或自动合并器。
-
-| 选择 | 可写范围 | 后续依据 |
-| --- | --- | --- |
-| 保留当前 | 项目采用资料、业务稿、JSON、代码和历史均不写；在本次答复说明选择即可 | 继续读取原采用文件，不因新资源可读而换源 |
-| 部分采用 | 仅更新明确选中的条款及必要采用说明；保留其余本地约定和人工段落 | 标明选用来源／版本、选中条款及本地例外，不宣称整套新版都已采用 |
-| 整体采用 | 明确替换的是哪些规范内容，并逐项说明人工差异如何保留或处理；变更前保留原文件历史 | 新项目采用资料成为依据；整体采用不等于整文件／整仓覆盖或源码迁移 |
-
-人已明确选择且范围充分时继续完成该范围，不重复索要同一确认。涉及未明确的冲突，先给出准确位置、影响、推荐和可选操作：保留原约定、采用具体条款，或先人工修改。审查只标注问题，保留人工修改空间；不以审查意见自动修业务稿。
-
-仅改获准位置，保留人工代码、项目副本、其他主题及已完成任务。无法区分段落或文件归属时先列冲突，不把整个文件当成可替换生成物。选定新规则与现有规格／任务不一致时，先处理受影响范围，再实施依赖它的任务；采用说明更新不自动扩大已有 Build／auto 授权。
-
-### 6.4 版本和引用如何传递
-
-资源版本、项目采用内容和已实现工程分别核对。1.0.0 是资源内容版本，不使项目规格、工程代码或软件发行版自动升级。项目采用内容沿用现有文档版本／变更记录；版本从实际文件名与正文回读，不新增强制版本字段、成功锁或另一套状态库。
-
-手动方式直接交入当前规格、已采用说明及必要技术规范／契约／代码的实际路径。已有业务 JSON 顶层仍只有 schemaVersion、scope、selected，需要时沿用 selected.topics 中该主题 engineeringSkeleton 的字符串路径。没有 JSON 可以继续，不为本资源强制新建清单。
-
-采用文件路径未变时，JSON 不为记录版本重复写入；同路径人工改稿后重新读当前正文并核对任务，不要求保持旧 SHA256，不凭旧报告沿用认可。路径确需改选时，在人明确采用后沿用现有交接工具的准确预览／确认规则，只改相关主题引用并保留历史；其他 selected 和人工内容保留。不增加更新、迁移、候选、交付或审批字段。
-
-已选来源不可读或版本含糊时，展示缺项、影响和可选操作，不静默改读全局／另一路径或最高版本。原采用路径若直接指向已被升级替换的安装文件、旧版已不可读，就不能声称“仍使用旧版”；由人选择采用当前真实版本，或从实际可读历史恢复项目副本，不伪造旧内容。
-
-安装目录和项目采用副本分开。曾直接修改安装文件时，先识别并另存为项目资料，再处理升级。本规则保护采用作业中的项目自改内容，不证明原安装器已保护所有安装目录修改；安装／分发行为另按实际合同验证。
-
-### 6.5 需要物理迁移时交给原 Plan／Build
-
-规范更新默认不移动代码。只有真实工程、维护、构建或部署需求才提出迁移，不能仅因旧路径与示例不同就改名。目录迁移方案复用已有规格／工程说明与原 Plan，不另建迁移登记库。
-
-迁移任务须明确旧路径→新路径、实际涉及文件、共同消费者、导入引用、源码／测试／资源及构建／运行／CI／部署配置、人工与未提交内容保护、验证方法和失败恢复范围。企业项目按所选 AD 衔接；标准项目用本次规格承接。未知影响不能填为已核对。
-
-原 Plan 实际读取后，将文件路径、依赖、验收和恢复写进 tasks/plan.md 与原方法确定的唯一任务目标，保留计划认可停点。获准原 Build 回读任务所需来源，只处理明确清单，核实际新增／修改／必要删除文件和共享消费者；不以采用规范为由整仓复制、整目录覆盖或递归删除。
-
-完成本次要求的程序测试、构建和消费者回归，按 §5 核真实落点。只检查过 CI／部署配置而未实际运行时分别说明，不能报为运行通过。迁移完成不清除旧完成任务，以新任务记录本次变化；撤销未实施需求不自动删工程，功能退役另有明确移除／迁移／回归任务。
-
-恢复复用项目已有 Git／备份和明确文件范围，保留本地及其他人的修改，不执行整仓 reset 或覆盖人工内容来还原。计划认可、单任务实施、目录验收、业务审查和发布按各自原条件执行，不由 JSON 或目录存在推导。
-
-### 6.6 可复制的任务说明
-
-以下是自然语言任务或原命令的任务上下文，不是新参数。已采用指引能准确定位时先按指引查找并展示来源，只向用户补问缺少的选择或事实。
-
-```text
-先只读检查当前项目已采用的工程说明、当前规格、相关代码／构建配置和未完计划。
-按现状列出工程类别、真实根、源码／测试位置、维护方与必要例外。
-优先保留已有目录和人工内容，不生成目录、不搬代码、不改业务稿或 JSON。
-给出映射建议、准确缺项、推荐和可选操作，交我决定。
-```
-
-```text
-比较项目当前采用说明与本次明确的新目录资源；先展示实际路径和正文版本。
-按项目已采用指引查找，不能准确定位的来源再向我确认，不自动选最高版本。
-列出条款差异及对当前规格／未完任务的影响，保留人工约定。
-我尚未选择时只给建议；我明确选择后仅更新获准条款并展示差量、保留原文件历史。
-未采用的条款不写回，目录不迁移，业务稿和代码不自动修改。
-```
-
-```text
-/i3-plan
-依据当前明确采用的工程说明和本次规格，规划已明确的目录调整：
-旧位置：[路径] → 新位置：[路径]；范围：[文件／模块]。
-先实际读取所选来源、代码、引用和相关配置；按需读直接消费者。
-每项任务写明文件路径、人工内容保护、测试／构建和失败恢复方法。
-保留原计划／唯一任务目标和已完成事实；本轮只规划，等待原有认可后再 Build。
-```
-
-获准后使用原 /i3-build 执行当前明确任务，要求回读采用依据、核实际文件与配置落点，并如实列出验证和未通过项。原 /i3-build auto 的原有条件保持，不把上述迁移任务扩展为企业跨阶段调度。
-
-本节提供作业规则，不能代替真实调用／读取、任务认可、文件保护和迁移结果的证据；没有运行的步骤保留待验证，原始失败和人工处理意见不转写为通过。

package/references/engineering-skeleton-resources/catalog.json

@@ -1,17 +0,0 @@
-{
-  "schemaVersion": 1,
-  "resourceVersion": "1.0.0",
-  "kind": "directory-standard",
-  "standard": "directory-standard.md",
-  "adoption": "adoption.md",
-  "layouts": [
-    {
-      "id": "pbc-composite",
-      "description": "PBC组合工程，按需映射前端、后端、Agent和任务工程"
-    },
-    {
-      "id": "agent-standalone",
-      "description": "独立Agent工程，允许采用框架原有的根目录布局"
-    }
-  ]
-}