@givolt/i3-composer-agent 2.3.6 → 3.0.0

package/.agents/plugins/marketplace.json

@@ -6,7 +6,7 @@
   "plugins": [
     {
       "name": "i3-composer-agent",
-      "version": "2.3.6",
+      "version": "3.0.0",
       "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
       "source": {
         "source": "local",

package/.claude/commands/i3-sop.md

@@ -0,0 +1,19 @@
+---
+description: "显式使用企业 SOP，复用原规格方法完成单阶段文档与交接"
+# i3-description-source: "description: 显式使用企业 SOP，复用原规格方法完成单阶段文档与交接"
+---
+
+<!-- i3:zh-CN:start -->
+## 中文交互与输出
+
+默认使用简体中文回复，包括追问、选项说明、阶段进度、分析、规格、计划、验收、代码审查与发布报告。只有用户明确要求其他语言时才切换；输入中出现英文术语、代码或引用不构成切换语言的要求。
+下文的工程步骤、审批要求、退出条件和工具约束完整有效。英文示例中的人类可读标题、说明和占位内容在实际输出时应译为中文；保留原有信息与验证标准，不删减方法。
+Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
+严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
+
+适用说明：显式使用企业 SOP，复用原规格方法完成单阶段文档与交接
+<!-- i3:zh-CN:end -->
+
+Invoke the i3-enterprise-sop skill and pass the complete arguments unchanged. The skill owns operation handling, resource selection, original-method invocation, handoff and stopping rules.
+
+$ARGUMENTS

package/.claude-plugin/marketplace.json

@@ -8,7 +8,7 @@
   "plugins": [
     {
       "name": "i3-composer-agent",
-      "version": "2.3.6",
+      "version": "3.0.0",
       "source": "./",
       "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
       "homepage": "https://github.com/49780522/i3-composer-agent",

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "i3-composer-agent",
-  "version": "2.3.6",
+  "version": "3.0.0",
   "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
   "author": {
     "name": "Givolt"

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "i3-composer-agent",
-  "version": "2.3.6",
+  "version": "3.0.0",
   "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
   "author": {
     "name": "Givolt"
@@ -12,7 +12,7 @@
   "interface": {
     "displayName": "i3 Composer Agent",
     "shortDescription": "中文软件工程全流程技能",
-    "longDescription": "i3 Composer Agent 提供 26 项工程技能，覆盖需求、计划、实现、测试、审查与发布，默认使用简体中文。",
+    "longDescription": "i3 Composer Agent 提供 27 项工程技能，覆盖需求、计划、实现、测试、审查与发布，默认使用简体中文。",
     "developerName": "Givolt",
     "category": "Productivity",
     "capabilities": [

package/.gemini/commands/i3-sop.toml

@@ -0,0 +1,19 @@
+description = "显式使用企业 SOP，复用原规格方法完成单阶段文档与交接"
+# i3-description-source: "description = \"显式使用企业 SOP，复用原规格方法完成单阶段文档与交接\""
+
+prompt = """
+<!-- i3:zh-CN:start -->
+## 中文交互与输出
+
+默认使用简体中文回复，包括追问、选项说明、阶段进度、分析、规格、计划、验收、代码审查与发布报告。只有用户明确要求其他语言时才切换；输入中出现英文术语、代码或引用不构成切换语言的要求。
+下文的工程步骤、审批要求、退出条件和工具约束完整有效。英文示例中的人类可读标题、说明和占位内容在实际输出时应译为中文；保留原有信息与验证标准，不删减方法。
+Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
+严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
+
+适用说明：显式使用企业 SOP，复用原规格方法完成单阶段文档与交接
+<!-- i3:zh-CN:end -->
+
+Invoke the i3-enterprise-sop skill and pass the complete arguments unchanged. The skill owns operation handling, resource selection, original-method invocation, handoff and stopping rules.
+
+$ARGUMENTS
+"""

package/README.md

@@ -1,4 +1,4 @@
-# i3 Composer Agent v2.3.6
+# i3 Composer Agent v3.0.0
 
 **Intelligence. Integration. Innovation.**
 
@@ -7,6 +7,38 @@
 Skill 和命令使用 `i3-` 前缀。默认简体中文交互；用户明确要求时可切换语言。
 代码标识、路径、参数、工具协议和机器状态保持原样。
 
+## 企业 SOP 文档与规划
+
+新增 `/i3-sop` 命令和 `i3-enterprise-sop` Skill，共 27 个技能、11 个命令。
+标准流程继续使用原 `/i3-spec`、`/i3-plan`、`/i3-build` 等入口；企业 SOP 需要明确选择，
+普通安装或原 using 不会自动切换为企业流程。
+
+在项目中使用短命令加一句任务，缺少范围、主题或来源时由模型先澄清：
+
+```text
+/i3-sop brd 梳理设备运营的业务能力，先确认业务边界。
+/i3-sop prd 根据已选 BRD，为巡检管理编写任务编排主题 PRD。
+/i3-sop ad 根据已选 PRD 制定详细设计，优先采用本项目现有技术规约。
+/i3-sop testcase 根据当前 AD 设计测试用例和测试报告要求。
+/i3-sop plan 为已选主题制定实施计划，读取完整的设计和必要工程依据。
+```
+
+显式 Skill 使用同一规则，例如“使用 i3-enterprise-sop，根据当前 PRD 编写 AD”。
+文档生成／修订复用原 Spec 方法，Plan 动作复用原规划方法，输出原 `tasks/plan.md` 和
+`tasks/todo.md`，交人审阅。计划获准后继续使用原 `/i3-build` 或 `/i3-build auto`；
+auto 仍遵守原规格、Git 基线、明确认可、测试与逐任务提交要求。
+
+支持同一 PBC 的多份独立主题 PRD，各自独立版本并关联对应 AD／TestCase；
+原型按需，可与 AD 并行；独立 TestCase 不作为 Plan 的统一必填前置。
+JSON 交接只保留 `schemaVersion`、`scope`、`selected`，也保留手动传递路径的方式。
+项目自改模板与已有工程规范优先采用，审查只报告问题，不自动修改业务稿。
+
+包内提供四阶段模板／提示词、公共技术规约模板及采用示例，以及工程目录与采用资源 **1.0.0**。
+技术规约示例需按实际项目确认采用，工程目录资源不等于已生成整套业务代码。
+安装后的配套根中可读 [SOP 采用说明](references/enterprise-sop-resources/README.md) 和
+[工程骨架资源](references/engineering-skeleton-resources/README.md)。
+3.0.0 由人逐阶段发起与审阅；SOP 全流程自动调度和 i3-config 不包含在本次发行。
+
 ## 通过向导安装
 
 在要使用技能的项目中运行：
@@ -27,8 +59,8 @@ WorkBuddy 在第 2 项。上下键移动，空格勾选/取消，回车确认；
 
 可直接输入工具编号，例如 `1` 选择 CodeBuddy，或 `1,2` 多选，再按回车。安装范围、UIUX／antDv 及最终确认支持数字选择。CodeBuddy／WorkBuddy 默认注册原型审计 Hooks，保留明确禁用状态；无需选择 Hook 组或 IDE／CLI。其他原版 Hook 脚本随包交付，按需通过统一管理器另行启用。UIUX／antDv 可选择安装两项、单项或跳过，之后也可补装。
 
-全部目标均安装 26 个技能、共享参考资料，以及完整评测/Hook/脚本配套。
-全部目标同时提供 10 个命令和 4 个 Agent 角色提示。
+全部目标均安装 27 个技能、共享参考资料，以及完整评测/Hook/脚本配套。
+全部目标同时提供 11 个命令和 4 个 Agent 角色提示。
 CodeBuddy、WorkBuddy、Claude Code 使用原生命令入口；其他工具通过 Skills 机制使用，
 命令和角色文件可作为资料读取，是否自动发现取决于宿主。
 目录预设来自固定的 [Skills CLI 工具登记](https://github.com/vercel-labs/skills/blob/48dc9e8eb8aa19040e91cb90ba0b642c9cbad57e/src/agents.ts)
@@ -166,6 +198,7 @@ CodeBuddy、WorkBuddy、Claude Code 原生安装使用 `/i3-spec`、`/i3-plan`
 | /i3-composer-agent:i3-prototype | 在主会话中分析、创建、检查与迭代 UI 交互原型。 |
 | /i3-composer-agent:i3-review | 从正确性、可读性、架构、安全和性能五个维度审查代码。 |
 | /i3-composer-agent:i3-ship | 并行调用三个专业角色执行发布前检查，主会话汇总 GO/NO-GO 决策与回滚计划。 |
+| /i3-composer-agent:i3-sop | 显式使用企业 SOP，复用原规格方法完成单阶段文档与交接 |
 | /i3-composer-agent:i3-spec | 先编写结构化规格、目标、范围与验收标准，再进入实现。 |
 | /i3-composer-agent:i3-test | 执行 TDD：先编写失败测试，再实现和验证；缺陷使用 Prove-It 模式复现。 |
 | /i3-composer-agent:i3-webperf | 调用 web-performance-auditor 角色审查网页性能与 Core Web Vitals。 |
@@ -203,6 +236,7 @@ UI/UX Pro Max 与 antDv 官方 Skill 可通过 `--prototype-skills uiux,antdv`
 | [i3-deprecation-and-migration](skills/i3-deprecation-and-migration/SKILL.md) | 管理废弃与迁移。适用于替换旧系统、API 或功能、迁移用户、生产数据库无停机扩展/收缩，以及决定维护或退役现有代码。 |
 | [i3-documentation-and-adrs](skills/i3-documentation-and-adrs/SKILL.md) | 记录文档、架构决策与设计理由。适用于编写 ADR、公共 API 发生变化时补充文档、交付功能，以及保存后续工程师和代理理解设计取舍所需的背景。 |
 | [i3-doubt-driven-development](skills/i3-doubt-driven-development/SKILL.md) | 对非平凡决策进行独立的对抗式审查。适用于核查假设、压力测试计划、寻找隐藏失败模式、陌生代码、安全敏感功能、生产认证或高风险不可逆迁移。 |
+| [i3-enterprise-sop](skills/i3-enterprise-sop/SKILL.md) | 组织显式选择的企业 SOP 文档与规划交接。适用于明确调用 i3-enterprise-sop 起草 BRD、PRD、AD、TestCase、制定 Plan 或传递选定资料；短命令先澄清缺口，再复用原版方法。 |
 | [i3-frontend-ui-engineering](skills/i3-frontend-ui-engineering/SKILL.md) | 实现可访问、响应式、具有生产质量的前端界面。适用于页面/组件开发、布局、状态管理、WCAG 无障碍、交互与视觉质量改进。 |
 | [i3-git-workflow-and-versioning](skills/i3-git-workflow-and-versioning/SKILL.md) | 组织 Git 分支、提交、冲突处理、PR 与版本发布。适用于任何代码改动、拆分工作区改动、并行开发、推送、合并、语义化版本、标签及变更日志。 |
 | [i3-idea-refine](skills/i3-idea-refine/SKILL.md) | 通过发散与收敛思考完善模糊想法。适用于创意探索、细化方案、验证假设、压力测试计划，以及确定方向前比较更多选项。 |

package/commands/i3-sop.toml

@@ -0,0 +1,19 @@
+description = "显式使用企业 SOP，复用原规格方法完成单阶段文档与交接"
+# i3-description-source: "description = \"显式使用企业 SOP，复用原规格方法完成单阶段文档与交接\""
+
+prompt = """
+<!-- i3:zh-CN:start -->
+## 中文交互与输出
+
+默认使用简体中文回复，包括追问、选项说明、阶段进度、分析、规格、计划、验收、代码审查与发布报告。只有用户明确要求其他语言时才切换；输入中出现英文术语、代码或引用不构成切换语言的要求。
+下文的工程步骤、审批要求、退出条件和工具约束完整有效。英文示例中的人类可读标题、说明和占位内容在实际输出时应译为中文；保留原有信息与验证标准，不删减方法。
+Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
+严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
+
+适用说明：显式使用企业 SOP，复用原规格方法完成单阶段文档与交接
+<!-- i3:zh-CN:end -->
+
+Invoke the i3-enterprise-sop skill and pass the complete arguments unchanged. The skill owns operation handling, resource selection, original-method invocation, handoff and stopping rules.
+
+$ARGUMENTS
+"""

package/docs/codebuddy-setup.md

@@ -9,8 +9,8 @@ npx @givolt/i3-composer-agent --codebuddy
 ```
 
 向导预选 CodeBuddy，可增加其他工具，再选择项目或全局范围。
-项目安装提供 `.codebuddy/skills/`（26 个技能）、
-`commands/`（10 个命令）和 `agents/`（4 个角色）。
+项目安装提供 `.codebuddy/skills/`（27 个技能）、
+`commands/`（11 个命令）和 `agents/`（4 个角色）。
 同级 `i3-composer-agent/` 是配套工具根，集中提供 `package.json`、`evals/`、`hooks/`、`scripts/`、`docs/`、`references/` 和校验输入 `adapters/`，
 只有一份实际技能、命令和角色，评测与宿主共用。
 全局使用 `~/.codebuddy/` 的相同结构。默认中文说明和回复；技能/命令标识不改名。
@@ -48,7 +48,7 @@ CodeBuddy 与 WorkBuddy 项目共用 `.codebuddy/`；同版本追加客户端会
 npx @givolt/i3-composer-agent --codebuddy --scope project --yes --prototype-skills uiux,antdv
 ```
 
-值为 none、uiux、antdv 或 uiux,antdv；默认 none。可选工具跟随宿主和项目／全局范围，位于基址下 `tools/i3-prototype/`；旧项目 `.prototype-tools` 保持读取兼容。需要固定本次版本时使用 `npx @givolt/i3-composer-agent@2.3.6`。已安装后可随时单独检测／补装，无需重装 i3：
+值为 none、uiux、antdv 或 uiux,antdv；默认 none。可选工具跟随宿主和项目／全局范围，位于基址下 `tools/i3-prototype/`；旧项目 `.prototype-tools` 保持读取兼容。需要固定本次版本时使用 `npx @givolt/i3-composer-agent@3.0.0`。已安装后可随时单独检测／补装，无需重装 i3：
 
 ```bash
 node .codebuddy/skills/i3-ui-prototype/scripts/prototype-dependencies.cjs check --host codebuddy --scope project --project .

package/docs/codex-setup.md

@@ -7,7 +7,7 @@ npx @givolt/i3-composer-agent --codex
 ```
 
 项目范围写入 `.agents/skills/`，全局写入 `~/.agents/skills/`，并安装同级 `i3-composer-agent/references/`。
-提供全部 26 个 `i3-` 技能，中文选择说明与默认中文回复在每个入口独立生效。
+提供全部 27 个 `i3-` 技能，中文选择说明与默认中文回复在每个入口独立生效。
 同级 `evals/`、`hooks/`、`scripts/`、`docs/` 各自以 `i3-composer-agent/` 分组资料。
 命令与角色文件也会提供，供按需阅读，其自动发现由宿主决定。
 从项目目录执行 `node .agents/i3-composer-agent/scripts/run-evals.js --min-rank1 95`
@@ -37,6 +37,6 @@ Codex 已有原生技能路由，勿把元技能全文预加载为常驻上下
 
 ## 可选原型工具
 
-原型辅助工具位于本宿主基址的 `tools/i3-prototype/`，支持项目和全局范围；旧项目 `.prototype-tools` 继续读取兼容。项目安装可使用 `npx @givolt/i3-composer-agent@2.3.6 --codex --scope project --yes --prototype-skills uiux,antdv`；全局安装将 scope 改为 global。可选依赖默认 none，后续也可使用已安装 Skill 的 prototype-dependencies.cjs 单独检测／补装。完整用法见原型 Skill 的 references/optional-skills.md。
+原型辅助工具位于本宿主基址的 `tools/i3-prototype/`，支持项目和全局范围；旧项目 `.prototype-tools` 继续读取兼容。项目安装可使用 `npx @givolt/i3-composer-agent@3.0.0 --codex --scope project --yes --prototype-skills uiux,antdv`；全局安装将 scope 改为 global。可选依赖默认 none，后续也可使用已安装 Skill 的 prototype-dependencies.cjs 单独检测／补装。完整用法见原型 Skill 的 references/optional-skills.md。
 
 原型共享资料统一在项目 prototypes/：新索引 prototypes/index.json，准备范围 prototypes/.preparation/<id>/scope.json。新原生 scope.moduleIds 自动生成 appliesTo；旧索引、输入和实例保持兼容，安装升级不自动迁移。工具及运行缓存使用所选宿主基址；全局浏览器缓存按业务项目身份隔离。详细规则和只读查询／显式迁移命令见 i3-ui-prototype/references/project-layout.md。

package/docs/other-hosts.md

@@ -2,11 +2,11 @@
 
 这些宿主尚未完成当前版本的真实宿主与模型执行验证。安装文件、宿主发现技能和模型正确执行是三项独立检查；请在测试项目中验证后再用于正式工作。
 
-技能包包含 26 个技能及共享资源。接入时应保留完整的技能、引用与配套工具，不能只复制 `SKILL.md`。
+技能包包含 27 个技能及共享资源。接入时应保留完整的技能、引用与配套工具，不能只复制 `SKILL.md`。
 
 ## 使用本地分发目录
 
-以下命令使用完整分发包解压目录里的 CLI，适用于本地测试和离线接入。`/absolute/path/to/package` 均替换为实际解压目录；已发布版本也可使用 `npx @givolt/i3-composer-agent@2.3.6` 的对应入口。
+以下命令使用完整分发包解压目录里的 CLI，适用于本地测试和离线接入。`/absolute/path/to/package` 均替换为实际解压目录；已发布版本也可使用 `npx @givolt/i3-composer-agent@3.0.0` 的对应入口。
 
 ### fx
 

package/docs/workbuddy-setup.md

@@ -10,8 +10,8 @@ npx @givolt/i3-composer-agent --agents codebuddy,workbuddy --scope global --yes
 
 向导中 WorkBuddy 位于第 2 项，预选后仍可多选。全局目录：
 
-- `~/.workbuddy/skills/`：26 个 `i3-` 技能，选择说明和默认回复中文。
-- `~/.workbuddy/commands/`：10 个 `/i3-*` 短命令。
+- `~/.workbuddy/skills/`：27 个 `i3-` 技能，选择说明和默认回复中文。
+- `~/.workbuddy/commands/`：11 个 `/i3-*` 短命令。
 - `~/.workbuddy/agents/`：4 个专业角色。
 - `~/.workbuddy/i3-composer-agent/references/`：共享参考。
 - `~/.workbuddy/i3-composer-agent/docs/agents.md`：角色说明。
@@ -85,7 +85,7 @@ npx @givolt/i3-composer-agent --workbuddy --scope global --yes --force
 
 ## 可选原型工具
 
-原型辅助工具位于本宿主基址的 `tools/i3-prototype/`，支持项目和全局范围；旧项目 `.prototype-tools` 继续读取兼容。推荐使用 `npx @givolt/i3-composer-agent@2.3.6 --workbuddy --scope global --yes --prototype-skills uiux,antdv`；项目安装将 scope 改为 project。可选依赖默认 none，后续也可使用已安装 Skill 的 prototype-dependencies.cjs 单独检测／补装。完整用法见原型 Skill 的 references/optional-skills.md。
+原型辅助工具位于本宿主基址的 `tools/i3-prototype/`，支持项目和全局范围；旧项目 `.prototype-tools` 继续读取兼容。推荐使用 `npx @givolt/i3-composer-agent@3.0.0 --workbuddy --scope global --yes --prototype-skills uiux,antdv`；项目安装将 scope 改为 project。可选依赖默认 none，后续也可使用已安装 Skill 的 prototype-dependencies.cjs 单独检测／补装。完整用法见原型 Skill 的 references/optional-skills.md。
 
 原型共享资料统一在项目 prototypes/：新索引 prototypes/index.json，准备范围 prototypes/.preparation/<id>/scope.json。新原生 scope.moduleIds 自动生成 appliesTo；旧索引、输入和实例保持兼容，安装升级不自动迁移。工具及运行缓存使用所选宿主基址；全局浏览器缓存按业务项目身份隔离。详细规则和只读查询／显式迁移命令见 i3-ui-prototype/references/project-layout.md。
 

package/evals/cases/i3-enterprise-sop.json

@@ -0,0 +1,64 @@
+{
+  "skill_name": "i3-enterprise-sop",
+  "trigger": {
+    "positive": [
+      {
+        "prompt": "Explicitly use i3-enterprise-sop to record this explicitly selected PRD path without editing business documents",
+        "top_k": 3
+      },
+      {
+        "prompt": "Use i3-enterprise-sop for this named PBC PRD and AD reference handoff",
+        "top_k": 3
+      },
+      {
+        "prompt": "Explicitly use i3-enterprise-sop in manual handoff mode without creating JSON",
+        "top_k": 3
+      },
+      {
+        "prompt": "Explicitly use i3-enterprise-sop to draft this named PBC AD through native Spec, then stop for review",
+        "top_k": 3
+      },
+      {
+        "prompt": "Explicitly use i3-enterprise-sop plan for this selected topic, reuse native planning and stop for review",
+        "top_k": 3
+      }
+    ],
+    "negative": [
+      {
+        "prompt": "Write the standard SPEC.md with objectives, behavior and explicit boundaries",
+        "owner": "i3-spec-driven-development"
+      },
+      {
+        "prompt": "Break the approved spec into ordered implementation tasks",
+        "owner": "i3-planning-and-task-breakdown"
+      }
+    ]
+  },
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "Read brief.md. Explicitly use i3-enterprise-sop for the requested path handoff only.",
+      "files": [
+        "i3-enterprise-sop"
+      ],
+      "expected_output": "A handoff of explicitly selected document paths using schemaVersion, scope and selected only, or a read-only manual summary when requested",
+      "expectations": [
+        "Paths resolve against the confirmed project root and actual documents are read",
+        "A newly generated draft is only reported by path; selected changes only for an explicit user choice and business text is unchanged",
+        "Manual handoff does not create a JSON file or project directories",
+        "Original skills, commands, plans and task state are unchanged",
+        "No business approval, next-stage execution or publication is inferred",
+        "Drafting BRD, PRD, AD or TestCase loads original Spec successfully and preserves its save-and-stop gate",
+        "New business documents default to spec/ per capability; existing adopted paths are retained",
+        "Only the selected topic and necessary shared dependencies become original Plan inputs; original Build auto gates are retained",
+        "Short brd, prd, ad, testcase and plan actions ask only missing facts and do not write while awaiting an answer",
+        "Explicit plan successfully loads original planning Skill and preserves original command obligations and outputs, without JSON writes or Build",
+        "Manual and JSON Plan complete the same indexed shared reads and original command before native planning; scripts do not count as model reads; actual relevant dependency/build configuration is read rather than inferred from AD commands",
+        "AD capability/topic identity or direct-upstream path/PRD-version conflicts stop before native planning and any plan/todo or candidate-plan writes; suspected header typos are not self-resolved",
+        "PRD and AD independent version numbers may differ when the AD references the exact selected PRD version; optional TestCase/prototype do not become universal blockers",
+        "SOP preparation uses Read/Glob/Grep for file discovery instead of probing shell permission with ls/find/mkdir",
+        "The native plan retains full actual source paths and document versions for PRD, AD, adopted norms, contracts and engineering adoption; aliases in the plan or paths only in the conversation report are insufficient"
+      ]
+    }
+  ]
+}

package/evals/fixtures/i3-enterprise-sop/brief.md

@@ -0,0 +1,11 @@
+# 企业路径交接任务
+
+项目根、当前工作范围和本次主题必须从实际任务确认。采用项目中明确给出的 PRD 与配套 AD；先读正文核身份及直接上游，不按最大版本推断。
+
+生成文档后仅展示真实路径；只有本轮已明确采用准确文档并允许登记时才写 selected。清单顶层仅 schemaVersion、scope、selected，不生成 candidates 或 delivery。已有 PRD／AD 的接入不重做业务文档。业务稿、人工模板、原 Plan 和已完成任务保持。
+
+如果本轮要求手动方式，就只提供准确路径、正文来源及缺口，不创建 JSON 或目录。未提供的 TestCase 不作规划统一门槛；不推断任何业务批准或实施许可。
+
+## Native handoff extension
+
+For a separately requested drafting task, load original Spec, use the selected enterprise template and preserve its final human-review stop. New business documents default to spec/{capability}/; existing adopted paths are retained. For engineering handoff, the selected AD plus accurate PRD, shared constraints, skeleton and relevant code forms the equivalent spec. Native Plan outputs and Build/Build auto gates remain unchanged. This fixture grants no actual business approval or publication permission.

package/evals/zh-CN/cases/i3-enterprise-sop.json

@@ -0,0 +1,61 @@
+{
+  "skill_name": "i3-enterprise-sop",
+  "trigger": {
+    "positive": [
+      {
+        "prompt": "显式使用 i3-enterprise-sop，为本次 PBC 的 PRD 和 AD 做路径交接",
+        "top_k": 3
+      },
+      {
+        "prompt": "显式使用 i3-enterprise-sop，以原 Spec 和企业模板起草本主题 AD 后停轮",
+        "top_k": 3
+      },
+      {
+        "prompt": "显式使用 i3-enterprise-sop，手动传递准确路径，不创建 JSON",
+        "top_k": 3
+      },
+      {
+        "prompt": "显式使用i3-enterprise-sop执行plan，只规划本项目选定的任务编排主题，完成后交我审阅",
+        "top_k": 3
+      }
+    ],
+    "negative": [
+      {
+        "prompt": "标准流程：编写 SPEC.md，包含目标、命令、工程结构和边界",
+        "owner": "i3-spec-driven-development"
+      },
+      {
+        "prompt": "把已选规格拆成依赖有序、带验收和验证的实施任务",
+        "owner": "i3-planning-and-task-breakdown"
+      }
+    ]
+  },
+  "evals": [
+    {
+      "id": 1001,
+      "prompt": "读取 brief.md，显式使用 i3-enterprise-sop，只做本次准确路径交接。",
+      "files": [
+        "i3-enterprise-sop"
+      ],
+      "expected_output": "仅登记明确选用路径的三字段清单，或零项目写入的手动输入摘要",
+      "expectations": [
+        "Paths resolve against the confirmed project root and actual documents are read",
+        "A newly generated draft is only reported by path; selected changes only for an explicit user choice and business text is unchanged",
+        "Manual handoff does not create a JSON file or project directories",
+        "Original skills, commands, plans and task state are unchanged",
+        "No business approval, next-stage execution or publication is inferred",
+        "Drafting BRD, PRD, AD or TestCase loads original Spec successfully and preserves its save-and-stop gate",
+        "New business documents default to spec/ per capability; existing adopted paths are retained",
+        "Only the selected topic and necessary shared dependencies become original Plan inputs; original Build auto gates are retained",
+        "Short brd, prd, ad, testcase and plan actions ask only missing facts and do not write while awaiting an answer",
+        "Explicit plan successfully loads original planning Skill and preserves original command obligations and outputs, without JSON writes or Build",
+        "Manual and JSON Plan complete the same indexed shared reads and original command before native planning; scripts do not count as model reads; actual relevant dependency/build configuration is read rather than inferred from AD commands",
+        "AD capability/topic identity or direct-upstream path/PRD-version conflicts stop before native planning and any plan/todo or candidate-plan writes; suspected header typos are not self-resolved",
+        "PRD and AD independent version numbers may differ when the AD references the exact selected PRD version; optional TestCase/prototype do not become universal blockers",
+        "SOP preparation uses Read/Glob/Grep for file discovery instead of probing shell permission with ls/find/mkdir",
+        "The native plan retains full actual source paths and document versions for PRD, AD, adopted norms, contracts and engineering adoption; aliases in the plan or paths only in the conversation report are insufficient",
+        "用简体中文说明实际结果、缺口和未执行事项；保留上述全部工程要求，不推定业务批准、计划批准或发布。"
+      ]
+    }
+  ]
+}

package/hooks/PROTOTYPE.md

@@ -12,8 +12,12 @@
 
 安装器在 CodeBuddy/WorkBuddy 项目或全局范围注册 prototype 组。宿主自动触发；不要求原型使用者额外执行 execution-begin 或确认任务绑定。必要 Skill 的真实调用由原生 Pre/Post 回调记录，PTC/REPL 的内部工具分别记录；REPL 脚本文本不能代替调用成功。Bash 不提供 stdout 时由本包第一方入口捕获实际结果；其他只读查询可使用 native-tool-result.cjs 的本地绝对入口，不安装依赖。
 
-检查命令：`npx --yes @givolt/i3-composer-agent hooks check --host codebuddy --scope project --project .`；全局将 scope 改为 global。检查只读，不启用/修复设置。registered 表示已注册；active 表示观察到当前注册的有效运行；failure 显示已触发但处理失败的原因、会话、模式、次数和恢复状态。两次同类恢复未成功后转 blocked，不会因重试旧 begin 清零。只读维护不消耗恢复次数。
+漏调检查由当前操作和固定原型策略决定，不根据最新一句话是否包含“原型”启停采集。缺少 Skill 时拦截并提示通过宿主工具补调，真实成功后重试原操作；普通追问保持同一会话/有效上下文内的调用记录和原型运行。新会话或上下文压缩后重核 Skill，输入、实例或构建变化按原有合同重核业务证据。明确只读、暂停或取消独立限制受管变更，收到 UserPromptSubmit 即生效，不等待日志写盘；普通追问不解除，明确继续实施后解除。这个授权限制不控制回调采集，也不生成新的任务身份。
 
-状态与 PTC 机器回调位于宿主基址的 state/i3-prototype/；它们是诊断/证据记录，不是业务项目的原型目录。项目/全局、宿主/会话和当前用户任务分别隔离。保留上游 Hooks、用户注册、旧 HTML 和已有原型；旧 execution-* 命令仅供兼容，不是新流程的前置。
+Stop 只对本轮实际操作过的原型检查完成声明；无关文件任务不会被历史原型的验收接管。finalize 仍核验当前原型的真实调用、构建和浏览器证据。
+
+检查命令：`npx --yes @givolt/i3-composer-agent hooks check --host codebuddy --scope project --project .`；全局将 scope 改为 global。检查只读，不启用/修复设置。registered 表示已注册；active 表示观察到当前注册的有效运行；failure 显示当前无法核验的操作、会话和原因。次数只限制重复催调/提示，不构成永久操作锁；新的真实成功结果可恢复。普通追问不清零计数，原型会话不承担 Hook 排障。
+
+诊断、补调审计与 PTC 机器回调位于宿主基址的 state/i3-prototype/；项目/全局、宿主/会话/有效上下文和原型实例分别隔离。required、ready-to-retry、recovered、blocked 为兼容的审计显示，放行始终重新核对当前真实结果，不把状态名当额外前置。记录请求、失败或只读 SKILL.md 均不能代替成功调用；recovered 只表示观察到补调及重试，不代表业务验收。保留上游 Hooks、用户注册、旧 HTML 和已有原型；旧 execution-* 命令仅供兼容，不是新流程的前置。
 
 CodeBuddy 项目/全局 × IDE/CLI（CLI direct/PTC）真实注册、触发、必要 Skill 调用、缺失补调和失败展示必须分别验收。自动化回放不能冒充真实宿主；正式发布门禁在仓库维护工具中执行，不放到业务原型 Skill 内。

package/package.json

@@ -42,6 +42,7 @@
     "evals/cases/i3-deprecation-and-migration.json",
     "evals/cases/i3-documentation-and-adrs.json",
     "evals/cases/i3-doubt-driven-development.json",
+    "evals/cases/i3-enterprise-sop.json",
     "evals/cases/i3-frontend-ui-engineering.json",
     "evals/cases/i3-git-workflow-and-versioning.json",
     "evals/cases/i3-idea-refine.json",
@@ -76,6 +77,7 @@
     "evals/fixtures/i3-documentation-and-adrs/prose-review/README.md",
     "evals/fixtures/i3-documentation-and-adrs/prose-review/queue.js",
     "evals/fixtures/i3-doubt-driven-development/migration-plan.md",
+    "evals/fixtures/i3-enterprise-sop/brief.md",
     "evals/fixtures/i3-frontend-ui-engineering/Button.tsx",
     "evals/fixtures/i3-frontend-ui-engineering/design-system.md",
     "evals/fixtures/i3-git-workflow-and-versioning/.eval/working-tree.patch",
@@ -140,6 +142,7 @@
     "evals/zh-CN/cases/i3-deprecation-and-migration.json",
     "evals/zh-CN/cases/i3-documentation-and-adrs.json",
     "evals/zh-CN/cases/i3-doubt-driven-development.json",
+    "evals/zh-CN/cases/i3-enterprise-sop.json",
     "evals/zh-CN/cases/i3-frontend-ui-engineering.json",
     "evals/zh-CN/cases/i3-git-workflow-and-versioning.json",
     "evals/zh-CN/cases/i3-idea-refine.json",
@@ -262,6 +265,7 @@
       "evals/cases/i3-deprecation-and-migration.json",
       "evals/cases/i3-documentation-and-adrs.json",
       "evals/cases/i3-doubt-driven-development.json",
+      "evals/cases/i3-enterprise-sop.json",
       "evals/cases/i3-frontend-ui-engineering.json",
       "evals/cases/i3-git-workflow-and-versioning.json",
       "evals/cases/i3-idea-refine.json",
@@ -296,6 +300,7 @@
       "evals/fixtures/i3-documentation-and-adrs/prose-review/README.md",
       "evals/fixtures/i3-documentation-and-adrs/prose-review/queue.js",
       "evals/fixtures/i3-doubt-driven-development/migration-plan.md",
+      "evals/fixtures/i3-enterprise-sop/brief.md",
       "evals/fixtures/i3-frontend-ui-engineering/Button.tsx",
       "evals/fixtures/i3-frontend-ui-engineering/design-system.md",
       "evals/fixtures/i3-git-workflow-and-versioning/.eval/working-tree.patch",
@@ -360,6 +365,7 @@
       "evals/zh-CN/cases/i3-deprecation-and-migration.json",
       "evals/zh-CN/cases/i3-documentation-and-adrs.json",
       "evals/zh-CN/cases/i3-doubt-driven-development.json",
+      "evals/zh-CN/cases/i3-enterprise-sop.json",
       "evals/zh-CN/cases/i3-frontend-ui-engineering.json",
       "evals/zh-CN/cases/i3-git-workflow-and-versioning.json",
       "evals/zh-CN/cases/i3-idea-refine.json",
@@ -444,7 +450,7 @@
       "scripts/validate-versions.js"
     ]
   },
-  "version": "2.3.6",
+  "version": "3.0.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/49780522/i3-composer-agent.git"

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "i3-composer-agent",
-  "version": "2.3.6",
+  "version": "3.0.0",
   "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
   "homepage": "https://github.com/49780522/i3-composer-agent",
   "repository": "https://github.com/49780522/i3-composer-agent"

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

@@ -0,0 +1,52 @@
+# 工程骨架资源入口
+
+<!-- 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 只引用实际采用文件，不增加更新或迁移状态。
+
+安装文件与项目采用副本需区分：直接改过安装目录的内容先识别并保留为项目资料，不把本说明当作安装器自动保护所有人工修改的证明。已选来源不可读或旧版本已被替换时，展示准确缺项和选择，不静默换源或宣称仍在用旧版。
+
+本版补齐的是采用规则与可复制用法；实际模型读取、选择性更新、迁移、包／安装效果仍按各自证据验收，不以说明存在或版本号提高代替。