@archsight/aios 1.2.0 → 1.3.1

package/docs/PUBLIC_DISCOVERY.md

@@ -4,7 +4,7 @@
 
 结论：公共发现不是单一市场自动收录。AIOS 需要同时满足三类机制：
 
-1. 本地自动发现：宿主扫描 `SKILL.md`、`skills/`、`.agents/skills/`、`.claude/skills/` 或 extension/plugin 目录。
+1. 本地自动发现：宿主扫描 `SKILL.md`、`skills/`、`.agents/skills/`、`.claude/skills/`、`.opencode/skills/` 或 extension/plugin 目录。
 2. 可分发安装：通过 GitHub、npm/npx、Antigravity/agy、Gemini extension 兼容入口、Claude marketplace、WorkBuddy、`skills.sh` / `npx skills` 安装。
 3. 公共检索：依赖 GitHub topics、manifest、标准目录、README 关键词、release、安装量、star 和主动提交。
 
@@ -12,10 +12,11 @@
 
 | 入口 | 文件 | 目的 |
 | --- | --- | --- |
-| 标准 skills 目录 | `skills/` | 让 `skills.sh`、`npx skills`、Antigravity/agy、Gemini extension 和其他标准 skill 索引器直接看到 `aios-*` Skill。 |
+| 标准 skills 目录 | `skills/` | 让 `skills.sh`、`npx skills`、Antigravity/agy、Gemini extension、OpenCode 和其他标准 skill 索引器直接看到 `aios-*` Skill。 |
 | Gemini extension manifest | `gemini-extension.json` | 保留 Gemini CLI extension 兼容入口和 Gallery / 第三方索引 manifest。 |
 | Claude marketplace manifest | `.claude-plugin/marketplace.json` | 允许 Claude Code 用户通过 marketplace 方式发现本项目。 |
 | Claude plugin manifest | `.claude-plugin/plugin.json` | 描述插件元数据，并把插件 skills 指向 `./skills/`。 |
+| OpenCode 项目入口 | `OPENCODE.md` | 让业务项目中的 OpenCode 会话能读取公共规则和 `.ai/` 项目治理目录。 |
 | WorkBuddy adapter | `adapters/workbuddy/README.md` | 说明如何把 `aios-*` Skill 安装到 `~/.workbuddy/skills/`。 |
 | npm metadata | `package.json` | 提供英文检索关键词、分发文件清单和 `validate:skills` 校验入口。 |
 | 发现校验脚本 | `scripts/validate-skills.mjs` | 校验 manifest、skill frontmatter、跨 host manifest 和 npm metadata 是否一致。 |
@@ -84,6 +85,18 @@ Codex：
 npx @archsight/aios install --target codex --scope user
 ```
 
+Claude Code 用户级 skills：
+
+```powershell
+npx @archsight/aios install --target claude-code --scope user
+```
+
+OpenCode 用户级 skills：
+
+```powershell
+npx @archsight/aios install --target opencode --scope user
+```
+
 Antigravity / agy：
 
 ```powershell
@@ -124,6 +137,7 @@ agent skills
 AI agent skills
 Codex skills
 Claude Code skills
+OpenCode skills
 Gemini CLI extension
 Antigravity CLI
 construction AI

package/docs/business-expert-guide.md

@@ -46,7 +46,7 @@ AIOS 不是替代专家判断，而是把专家判断变成可复用、可审查
 1. 选一个具体主题，例如“地下室焊缝检测”“防火分区审查”“IFC 构件分类”。
 2. 准备 5 到 20 个真实样例，包括正确样例和错误样例。
 3. 写清楚术语、判断口径、通过条件和人工复核点。
-4. 让工程团队使用 `archsight-aios init --profile <name>` 接入项目规则。
+4. 让工程团队使用 `archsight-aios init` 接入项目规则，并检查 `.ai/profile-detection.md` 和 `.ai/project-context.md` 的自动识别结果。
 5. 根据 AI 输出的错误和遗漏，补充反例、规则和评估问题。
 
 ## 不应让 AIOS 做什么
@@ -58,10 +58,12 @@ AIOS 不是替代专家判断，而是把专家判断变成可复用、可审查
 
 ## 常见项目类型
 
-| 项目 | 推荐 profile |
+默认由 `archsight-aios init` 自动识别。只有自动识别明显不符合项目实际时，再让工程团队显式覆盖 profile。
+
+| 项目 | 自动识别或覆盖 profile |
 | --- | --- |
 | BIM / IFC / Revit / CAD 平台 | `bim-platform` |
 | 施工现场图像、视频、缺陷检测 | `construction-vision` |
 | 建筑规范知识库、RAG、GraphRAG | `rag-knowledge` |
 
-业务专家只需要关注 `.ai/project-context.md`、`.ai/profiles/*.md` 和评估样例是否真实、准确、可复核。工程师负责把这些材料接入代码、脚本、测试和发布流程。
+业务专家只需要关注 `.ai/profile-detection.md`、`.ai/project-context.md`、`.ai/profiles/*.md` 和评估样例是否真实、准确、可复核。工程师负责把这些材料接入代码、脚本、测试和发布流程。

package/docs/glossary.md

@@ -6,7 +6,7 @@ ArchSight AIOS 是一套 AI 规则、Agent、Skill、Workflow 和运行治理工
 
 ## Agent
 
-Agent 是一个内部角色标签，例如建筑数字化专家、代码审查官、AI 研发工程师。Agent 定义职责、边界、输入和输出。普通使用者通常不需要记住 Agent 名字，也不需要手动指定 Agent；AIOS 会根据任务类型、profile、Skill 和 Workflow 做路由。
+Agent 是一个内部角色标签，例如建筑数字化专家、代码审查官、AI 研发工程师。Agent 定义职责、边界、输入和输出。普通使用者通常不需要记住 Agent 名字，也不需要手动指定 Agent；AIOS 会根据任务类型、自动识别 profile、Skill 和 Workflow 做路由。
 
 ## Skill
 
@@ -18,7 +18,7 @@ Workflow 是多步骤工作流，说明一个任务从输入、执行、检查
 
 ## Profile
 
-Profile 是某类业务项目的补充规则。当前包括：
+Profile 是某类业务项目的补充规则。AIOS 默认把 profile 作为包内 registry 提供，`archsight-aios init` 会生成 `.ai/profile-detection.md` 做自动识别；用户通常不需要手动选择。当前包括：
 
 - `bim-platform`
 - `construction-vision`
@@ -26,7 +26,11 @@ Profile 是某类业务项目的补充规则。当前包括：
 
 ## `.ai/`
 
-业务项目中的 AI 规则目录。它保存项目事实、AIOS 补充规则、Agent 路由、Skills、Workflows 和行业 profile。
+业务项目中的 AI 规则目录。它保存项目事实、AIOS 补充规则、自动识别结果、Agent 路由、Skills、Workflows 和行业 profile。
+
+## `.ai/profile-detection.md`
+
+AIOS 初始化时生成的自动识别草稿，记录命中的 profile、Skill 候选、证据关键词和人工复核边界。
 
 ## `AGENTS.md`
 
@@ -40,6 +44,10 @@ Claude Code 读取的项目入口文件。
 
 Gemini 读取的项目入口文件。
 
+## `OPENCODE.md`
+
+OpenCode 读取的项目入口文件。
+
 ## `AI_CODING_RULES.md`
 
 项目通用 AI 编码规则。它是项目自己的规则主体，AIOS 不应该随意覆盖它。

package/docs/quickstart.md

@@ -8,7 +8,7 @@
 npx @archsight/aios install --target all --scope user
 ```
 
-这一步会把 ArchSight AIOS 的 Skills、Workflows、Runtime 和模板同步到当前用户目录，让 Codex、Gemini、Antigravity 等工具可以读取。
+这一步会把 ArchSight AIOS 的 Skills、Workflows、Runtime 和模板同步到当前用户目录，让 Codex、Claude Code、OpenCode、Gemini、Antigravity、WorkBuddy 等工具可以读取。
 
 ## 2. 检查安装
 
@@ -35,13 +35,18 @@ cd /work/your-project
 npx @archsight/aios init
 ```
 
-`init` 不指定 `--cwd` 时默认使用当前目录。已有 `AGENTS.md`、`CLAUDE.md`、`GEMINI.md` 或 `AI_CODING_RULES.md` 的项目不会被覆盖。
+`init` 不指定 `--cwd` 时默认使用当前目录。已有 `AGENTS.md`、`CLAUDE.md`、`GEMINI.md`、`OPENCODE.md` 或 `AI_CODING_RULES.md` 的项目不会被覆盖。
 
-## 4. 选择行业 profile
+## 4. 查看自动识别结果
 
-如果项目属于特定类型，可以叠加 profile：
+`init` 默认会自动生成 `.ai/profile-detection.md` 和预填 `.ai/project-context.md`。你可以直接打开这两个文件检查 AIOS 是否识别到了合适的 profile、Skill 候选、技术栈和常用命令。
+
+通常不需要手动选择 profile。如果自动识别不符合项目实际，可以用下面的命令覆盖：
 
 ```bash
+npx @archsight/aios init --profile auto
+npx @archsight/aios init --profile none
+npx @archsight/aios init --profile all
 npx @archsight/aios init --profile bim-platform
 npx @archsight/aios init --profile construction-vision
 npx @archsight/aios init --profile rag-knowledge
@@ -55,6 +60,7 @@ npx @archsight/aios init --profile rag-knowledge
 AGENTS.md
 CLAUDE.md
 GEMINI.md
+OPENCODE.md
 AI_CODING_RULES.md
 .ai/
 ```
@@ -84,6 +90,14 @@ npm test
 
 ### 我应该用哪个 profile？
 
+默认不用选。先运行：
+
+```bash
+npx @archsight/aios init
+```
+
+然后看 `.ai/profile-detection.md` 的识别结果。只有自动识别明显不符合项目实际时，再显式覆盖：
+
 - BIM / Revit / CAD / IFC 平台：`bim-platform`
 - 施工视觉 AI、检测、分割、深度估计：`construction-vision`
 - 规范知识库、RAG、GraphRAG：`rag-knowledge`

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "archsight-aios",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "面向建筑行业知识工作从业者与 AI 研发团队的 Skills、Workflow 与多 Agent 工具包 / Building-industry AI agent skills for BIM, IFC, RAG, GraphRAG, project evidence work, code review, and runtime governance.",
   "contextFileName": "GEMINI.md"
 }

package/governance/README.md

@@ -1,18 +1,48 @@
-# Governance
+# 治理规则
 
 `governance/` 保存 AI 工程治理规则。
 
-推荐优先建立：
+## 文件索引
 
-- [AI 编码规范（公共）](coding-rules.md)
-- [AI Review Policy](ai-review-policy.md)
-- [Security Policy](security-policy.md)
-- [Agent Boundary Policy](agent-boundary.md)
-- [Capability-Backed Arbitration Protocol](arbitration-protocol.md)
-- [Delivery Policy](delivery-policy.md)
-- [Context Policy](context-policy.md)
-- [Memory Policy](memory-policy.md)
+| 中文名称 | 文件 | 作用 |
+| --- | --- | --- |
+| AI 编码规范 | [coding-rules.md](coding-rules.md) | 统一代码生成、修改、验证和交付边界。 |
+| AI 评审策略 | [ai-review-policy.md](ai-review-policy.md) | 约束 AI 生成内容、代码审查和风险评审。 |
+| 安全策略 | [security-policy.md](security-policy.md) | 管理权限、密钥、外发、注入和安全敏感操作。 |
+| Agent 边界策略 | [agent-boundary.md](agent-boundary.md) | 区分 Agent、Skill、Workflow 和 Runtime 的职责边界。 |
+| Capability 证据仲裁协议 | [arbitration-protocol.md](arbitration-protocol.md) | 用证据等级、工具结果和人工升级处理多 Agent 冲突。 |
+| 交付策略 | [delivery-policy.md](delivery-policy.md) | 约束发布、回滚、验收和交付声明。 |
+| 上下文策略 | [context-policy.md](context-policy.md) | 控制上下文读取范围、成本、污染和泄露风险。 |
+| 记忆策略 | [memory-policy.md](memory-policy.md) | 管理长期记忆、项目事实和可复用经验的边界。 |
 
 治理目标是防止 agent 乱调用、prompt 泄露、上下文爆炸、AI 瞎改代码、权限失控和未经评审的自动交付。
 
-多 Agent 产生逻辑冲突时，优先按 `arbitration-protocol.md` 的证据等级处理：确定性工具、项目事实和结构化知识优先于 Agent 自然语言判断；涉及生产授权、法规合规最终结论、结构安全结论和商业范围取舍时升级给人类负责人。
+## 统一输出口径
+
+面向用户、客户或业务人员的输出默认使用中文字段，不直接输出英文模板标签。
+
+推荐字段：
+
+```text
+判断事项：
+证据：
+工具结果：
+处理建议：可继续 / 需核验 / 转人工复核
+```
+
+资料整理类输出使用：
+
+```text
+资料来源清单
+证据仲裁
+需核验
+转人工复核
+```
+
+内部 runtime、schema、Capability ID、命令、文件名和代码标识符可以保留英文；但最终说明应优先给出中文解释。
+
+## 仲裁原则
+
+多 Agent 产生逻辑冲突时，优先按 [Capability 证据仲裁协议](arbitration-protocol.md) 的证据等级处理：确定性工具、项目事实和结构化知识优先于 Agent 自然语言判断；涉及生产授权、法规合规最终结论、结构安全结论和商业范围取舍时升级给人类负责人。
+
+证据不足时，不把推断写成结论；应标为 `需核验`，或在责任、金额、质量安全、结构安全、法律合规、审批签审等高风险事项上标为 `转人工复核`。

package/governance/agent-boundary.md

@@ -1,4 +1,4 @@
-# Agent Boundary Policy
+# Agent 边界策略
 
 ## 基本关系
 
@@ -24,4 +24,3 @@
 - 建筑语义升级给 Vitruvius。
 - AI Runtime 升级给 Daedalus。
 - 受控执行交给 Hephaestus。
-

package/governance/ai-review-policy.md

@@ -1,4 +1,4 @@
-# AI Review Policy
+# AI 评审策略
 
 ## 目标
 
@@ -24,4 +24,3 @@ AIOS 的 Review 目标是阻止真实风险进入交付链路，而不是制造
 ## 输出要求
 
 Review 必须先列阻断问题，再列非阻断建议。每个发现都要包含位置、影响、证据和建议处理方式。
-

package/governance/arbitration-protocol.md

@@ -1,4 +1,4 @@
-# Capability-Backed Arbitration Protocol
+# Capability 证据仲裁协议
 
 状态：治理基线草案  
 适用范围：ArchSight AIOS 多 Agent 冲突仲裁、工具证据裁决和人工升级
@@ -11,7 +11,7 @@
 
 核心原则：
 
-> Agent 可以提出 Claim，但不能只凭自然语言推理裁决事实。事实裁决必须回到项目证据、结构化知识、确定性工具或人工授权。
+> Agent 可以提出判断事项，但不能只凭自然语言推理裁决事实。事实裁决必须回到项目证据、结构化知识、确定性工具或人工授权。
 
 适用场景：
 
@@ -34,30 +34,30 @@
 | L4 | 专项 Agent 判断 | Atlas 的架构判断、Mason 的交付判断、Vitruvius 的领域判断、Euclid 的建模判断。 |
 | L5 | LLM 自然语言推理 | 只能作为假设、解释或建议，不能单独作为阻断或放行依据。 |
 
-工具结果优先，但不得盲信工具结果。L1/L3 证据必须带有输入、版本、适用条件和执行状态；缺失时只能进入 `Need verify`。
+工具结果优先，但不得盲信工具结果。L1/L3 证据必须带有输入、版本、适用条件和执行状态；缺失时只能进入 `需核验`。
 
 ---
 
-## 三、Claim 契约
+## 三、判断事项契约
 
-Agent 之间发生冲突时，不能只输出“我不同意”。每个参与方必须把意见转成 Claim：
+Agent 之间发生冲突时，不能只输出“我不同意”。每个参与方必须把意见转成判断事项：
 
 ```text
-Claim:
-  id:
-  owner_agent:
-  type: architecture | delivery | domain_semantics | structural | security | runtime | business
-  statement:
-  evidence_level: L0 | L1 | L2 | L3 | L4 | L5
-  evidence:
-  assumptions:
-  need_verify:
-  blocking: true | false
-  severity: P0 | P1 | P2
-  requested_action: proceed | revise | reduce | stop | human_escalation
+判断事项：
+  编号：
+  负责 Agent：
+  类型：架构 / 交付 / 行业语义 / 结构 / 安全 / runtime / 商业
+  表述：
+  证据等级：L0 / L1 / L2 / L3 / L4 / L5
+  证据：
+  假设：
+  需核验：
+  是否阻断：是 / 否
+  严重级别：P0 / P1 / P2
+  请求动作：继续 / 修订 / 收缩 / 停止 / 人工升级
 ```
 
-Claim 必须明确区分事实、判断、假设和待验证项。没有证据的 Claim 默认不具备阻断权。
+判断事项必须明确区分事实、判断、假设和待验证项。没有证据的判断事项默认不具备阻断权。
 
 ---
 
@@ -122,32 +122,32 @@ any -> human_escalation
 
 ---
 
-## 七、Decision Ledger
+## 七、决策记录
 
 每次仲裁必须沉淀为可复核记录。最小字段：
 
 ```text
-Decision:
-  id:
-  date:
-  conflict:
-  claims:
-  evidence:
-  tool_results:
-  decision: proceed | revise | reduce | stop | escalate
-  rejected:
-  owner:
-  follow_up:
+决策记录：
+  编号：
+  日期：
+  冲突：
+  判断事项：
+  证据：
+  工具结果：
+  决策：继续 / 修订 / 收缩 / 停止 / 升级人工
+  已拒绝方案：
+  负责人：
+  后续动作：
 ```
 
-Decision Ledger 可以写入 ADR、memory、PR 描述、issue 或项目 `.ai/` 目录，具体位置由项目接入规则决定。
+决策记录可以写入 ADR、memory、PR 描述、issue 或项目 `.ai/` 目录，具体位置由项目接入规则决定。
 
 ---
 
 ## 八、落地要求
 
-- Workflow 输出必须包含 `Claim / Evidence / Tool Result / Decision`。
+- Workflow 面向用户的输出必须包含中文化的 `判断事项 / 证据 / 工具结果 / 处理建议`。
 - Skill 需要声明可用 Capability、权限边界和证据契约。
 - Runtime Adapter 只负责调用工具和回传证据，不替代 Agent 判断。
 - 工具调用失败时必须暴露失败原因、输入摘要和可恢复路径。
-- 没有 Capability 实现时，必须标为 `declared-interface` 或 `Need verify`，不得伪造工具结果。
+- 没有 Capability 实现时，必须标为 `已声明接口` 或 `需核验`，不得伪造工具结果。

package/governance/context-policy.md

@@ -1,4 +1,4 @@
-# Context Policy
+# 上下文策略
 
 ## 目标
 
@@ -20,5 +20,4 @@
 
 ## 输出要求
 
-当判断依赖假设时，必须标注 `Assumption`；当事实未核验时，必须标注 `Need verify`。
-
+当判断依赖假设时，必须标注 `假设`；当事实未核验时，必须标注 `需核验`。

package/governance/delivery-policy.md

@@ -1,4 +1,4 @@
-# Delivery Policy
+# 交付策略
 
 ## 目标
 
@@ -18,4 +18,3 @@ AIOS 交付必须可验证、可回滚、可解释。任何“完成”声明都
 - 不把计划、建议或草稿包装成已完成。
 - 不关闭 PR、issue 或任务状态，除非对应验证已经完成。
 - 不发布不可回滚的高风险变更。
-

package/governance/memory-policy.md

@@ -1,4 +1,4 @@
-# Memory Policy
+# 记忆策略
 
 ## 目标
 
@@ -22,4 +22,3 @@ Memory 用于保存稳定、可复用、可审计的组织知识，不保存临
 ## 清理规则
 
 Memory 必须能追溯来源文件或决策记录。相关文件删除、架构改变或验证失效时，应标记过期或删除。
-

package/governance/security-policy.md

@@ -1,4 +1,4 @@
-# Security Policy
+# 安全策略
 
 ## 目标
 
@@ -22,4 +22,3 @@ AIOS 默认按最小权限运行。任何 Agent、Skill、Runtime 或模板不
 ## 审计要求
 
 安全相关变更必须记录：目的、权限范围、验证命令、回滚方式和剩余风险。
-

package/memory/decision-records.md

@@ -7,14 +7,14 @@
 ## 格式
 
 ```text
-Title:
-Date:
-Context:
-Decision:
-Rejected:
-Consequences:
-Verification:
-Owner:
+标题：
+日期：
+背景：
+决策：
+已拒绝方案：
+影响：
+验证：
+负责人：
 ```
 
 ## 写入条件
@@ -23,4 +23,3 @@ Owner:
 - 拒绝了一个未来可能反复被提出的方案。
 - 改变了 Agent、Skill、Workflow 或 Runtime 边界。
 - 发布、权限或数据策略发生变化。
-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archsight/aios",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "面向建筑行业知识工作从业者与 AI 研发团队的 Skills、Workflow 与多 Agent 工具包 / Building-industry AI agent skills for BIM, IFC, RAG, GraphRAG, project evidence work, code review, and runtime governance.",
   "type": "module",
   "homepage": "https://github.com/ArchSightLabs/archsight-aios#readme",
@@ -32,6 +32,7 @@
     "antigravity",
     "claude-code",
     "workbuddy",
+    "opencode",
     "skills-sh",
     "mcp",
     "runtime-governance",
@@ -47,6 +48,15 @@
     "install:user": "node ./bin/archsight-aios.mjs install --target all --scope user",
     "smoke:project": "node ./bin/archsight-aios.mjs validate --temp",
     "validate:skills": "node ./scripts/validate-skills.mjs",
+    "validate:prompts": "node ./scripts/validate-prompt-fixtures.mjs",
+    "validate:prompt-run-pack": "node ./scripts/build-prompt-run-pack.mjs --check",
+    "validate:public-advisory-run-pack": "node ./scripts/build-prompt-run-pack.mjs --fixture prompts/evaluations/engineering-business-public-advisory-fixtures.json --check",
+    "validate:prompt-run-results": "node ./scripts/validate-prompt-run-results.mjs --check-template",
+    "validate:prompt-outputs": "node ./scripts/validate-prompt-model-outputs.mjs",
+    "validate:prompt-scorecard": "node ./scripts/validate-prompt-scorecard.mjs",
+    "build:prompt-run-pack": "node ./scripts/build-prompt-run-pack.mjs --out prompts/evaluations/engineering-business-basic-run-pack.generated.json",
+    "build:public-advisory-run-pack": "node ./scripts/build-prompt-run-pack.mjs --fixture prompts/evaluations/engineering-business-public-advisory-fixtures.json --out prompts/evaluations/engineering-business-public-advisory-run-pack.generated.json",
+    "analyze:prompt-run-results": "node ./scripts/analyze-prompt-run-results.mjs",
     "test": "node ./tests/cli.test.mjs"
   },
   "engines": {
@@ -81,10 +91,11 @@
     "SECURITY.md",
     "CODE_OF_CONDUCT.md",
     "README.md",
-    "AI_CODING_RULES.md",
-    "AGENTS.md",
-    "CLAUDE.md",
-    "GEMINI.md"
-  ],
+    "AI_CODING_RULES.md",
+    "AGENTS.md",
+    "CLAUDE.md",
+    "GEMINI.md",
+    "OPENCODE.md"
+  ],
   "license": "Apache-2.0"
 }

package/prompts/README.md

@@ -11,3 +11,15 @@ Prompt 会腐化，因此不能只保存文本本身，必须保存评估和维
 - [Prompt Registry](prompt-registry.md)
 - [Prompt Evaluation Policy](evaluation-policy.md)
 - [Prompt Failure Cases](failure-cases.md)
+
+工程业务管理基础提示词随对应 `aios-*` Skill 分发，入口见 [Prompt Registry](prompt-registry.md) 和 [工程业务管理基础技能包](../skills/engineering-business-starter-kit.md)。
+对比验证记录见 [工程业务管理基础提示词对比验证](evaluations/engineering-business-basic-prompts-2026-06-16.md)。
+advisory 来源信号复核见 [工程业务基础提示词 advisory 复核说明](evaluations/engineering-business-basic-advisory-validation-2026-06-16.md)。
+结构化评分卡见 [工程业务管理基础提示词评分卡](evaluations/engineering-business-basic-scorecard.json)，可用 `npm run validate:prompt-scorecard` 校验。
+weak/basic 运行包可用 `npm run build:prompt-run-pack` 生成，生成前可用 `npm run validate:prompt-run-pack` 校验。
+weak/basic 运行结果模板可用 `node ./scripts/validate-prompt-run-results.mjs --init <file>` 生成，模板和真实结果可用 `npm run validate:prompt-run-results` 或 `--file` 校验。
+weak/basic 运行结果报告可用 `npm run analyze:prompt-run-results -- --file <results> --out <report>` 生成。
+输出结构样例见 [工程业务管理基础模型输出样例](evaluations/engineering-business-basic-model-output.example.json)，可用 `npm run validate:prompt-outputs` 校验。
+公开 advisory 验证案例见 [公开 advisory fixture](evaluations/engineering-business-public-advisory-fixtures.json) 和 [Markdown 归一化输入](evaluations/public-advisory-md/)。这些 Markdown 文件保留虚构客户、项目、人员、地点、日期、金额和编号，用于验证抽取效果；原始 PDF / DOCX / 图片解析另行测试。
+
+需要比较弱提示词、便携强提示词和真实 Skill 触发结果时，使用 `aios-prompt-compare`。其中真实 Skill 结果必须来自宿主工具实际触发对应 `$aios-*` Skill 后的输出，不把 `SKILL.md` 当普通 prompt 粘贴运行的结果视为正式 Skill 结果。

package/prompts/evaluation-policy.md

@@ -16,3 +16,73 @@
 3. 比较输出质量、风险和遵循度。
 4. 记录失效案例。
 
+## 工程业务基础提示词回归
+
+工程业务管理基础提示词使用 `prompts/evaluations/engineering-business-basic-fixtures.json` 作为脱敏回归基线。
+
+公开 advisory 验证案例使用 `prompts/evaluations/engineering-business-public-advisory-fixtures.json`，具体输入统一放在 `prompts/evaluations/public-advisory-md/*.md`。这些公开案例只使用 Markdown 归一化输入：客户、项目、人员、地点、日期、金额和编号都是虚构值；它们用于验证提示词、agent 路由、字段抽取和输出边界，不验证 PDF / DOCX / 图片解析链路。
+
+修改 `skills/aios-*/prompts/basic-prompt.md` 后，运行：
+
+```bash
+npm run validate:prompts
+```
+
+该检查不替代真实模型输出评估，但能保证 6 类基础场景、抽象来源信号、必备输出结构、禁止结论和敏感信息边界没有被破坏。
+
+普通提示词与基础提示词的结构化比较保存在 `prompts/evaluations/engineering-business-basic-scorecard.json`。修改 fixture、基础提示词或评分维度后，运行：
+
+```bash
+npm run validate:prompt-scorecard
+```
+
+评分卡用于固定比较维度、权重、普通提示词失败模式和基础提示词改进点；它是脱敏 fixture 级别的设计评估，不替代真实模型批量输出评测。
+
+若需要批量运行 weak/basic 对照输入，先生成运行包：
+
+```bash
+npm run validate:prompt-run-pack
+npm run build:prompt-run-pack
+npm run validate:public-advisory-run-pack
+npm run build:public-advisory-run-pack
+```
+
+基础运行包包含 6 个 case 的普通提示词和基础提示词两组输入，共 12 条 run item。公开 advisory 运行包同样生成 12 条 run item，但 `sampleInput` 来自 Markdown 归一化输入正文。该步骤只组织脱敏 / 虚构输入和 prompt 文本，不调用模型。
+
+若要评估“普通提示词、便携强提示词、真实 Skill 结果”三类差异，使用 `aios-prompt-compare`。其中 weak/basic 可以沿用 run pack；`skill-runtime` 需要由宿主工具真实触发对应 `$aios-*` Skill 后归档，再按同一 scorecard 做三栏比较。不要把 `SKILL.md` 直接作为普通 prompt 粘贴运行的输出称为真实 Skill 结果。
+
+weak/basic 成对运行后，用 run results 文件归档 12 条结果：
+
+```bash
+npm run validate:prompt-run-results
+node ./scripts/validate-prompt-run-results.mjs --init prompts/evaluations/<your-run-results-file>.json
+node ./scripts/validate-prompt-run-results.mjs --file prompts/evaluations/<your-run-results-file>.json
+```
+
+run results 校验会要求基础提示词输出包含必备章节且不出现禁止结论；普通提示词输出允许暴露缺陷，并输出 weak diagnostics 供对比复盘。
+
+校验通过后，生成运行结果分析报告：
+
+```bash
+npm run analyze:prompt-run-results -- --file prompts/evaluations/<your-run-results-file>.json --out prompts/evaluations/<your-analysis-report>.md
+```
+
+分析报告汇总基础提示词通过门禁数量、普通提示词诊断数量、scorecard 判定和逐 case 差异，供后续决定是否调整基础提示词或 fixture。
+
+若已经有模型输出文件，使用同一 fixture 校验输出结构：
+
+```bash
+npm run validate:prompt-outputs
+node ./scripts/validate-prompt-model-outputs.mjs --file prompts/evaluations/<your-output-file>.json
+```
+
+若需要归档一次真实输出，先生成待填写模板：
+
+```bash
+node ./scripts/validate-prompt-model-outputs.mjs --init prompts/evaluations/<your-output-file>.json
+```
+
+模板中的 `output` 默认为空，不会通过校验；填入脱敏后的真实模型输出后，再用 `--file` 检查。
+真实输出文件需要填写可追溯的 `model`、可解析的 `ranAt`，且 `promptVersion` 必须匹配当前 fixture 版本。
+
+默认文件 `engineering-business-basic-model-output.example.json` 只是输出骨架样例，用于验证格式和检查器本身，不代表真实模型评测结果。