@archsight/aios 1.1.0 → 1.3.0

package/docs/PUBLIC_DISCOVERY.md

@@ -0,0 +1,207 @@
+# 公共发现与上架清单
+
+本文件记录 ArchSight AIOS 要被公共 skill 生态发现时，项目内需要提供的稳定入口。
+
+结论：公共发现不是单一市场自动收录。AIOS 需要同时满足三类机制：
+
+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 和主动提交。
+
+## 项目内入口
+
+| 入口 | 文件 | 目的 |
+| --- | --- | --- |
+| 标准 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 是否一致。 |
+
+## GitHub About 建议
+
+这些内容需要在 GitHub 仓库页面右侧 About 区手动设置，不能只靠代码文件完成。
+
+策略：默认展示中文，紧跟一段英文检索短语。中文用户能直接看懂项目定位，英文用户和索引器也能通过 `building-industry AI agent skills`、`project evidence work`、`BIM`、`IFC`、`GraphRAG`、`code review` 等词命中。
+
+Description：
+
+```text
+面向建筑行业知识工作从业者与 AI 研发团队的 Skills、Workflow 与多 Agent 工具包 / Building-industry AI agent skills for BIM, IFC, RAG, GraphRAG, project evidence work, code review, and runtime governance.
+```
+
+Website：
+
+```text
+https://github.com/ArchSightLabs/archsight-aios
+```
+
+Topics：
+
+```text
+agent-skills
+building-ai
+construction-ai
+aec
+bim
+ifc
+building-code
+graphrag
+mcp
+codex
+claude-code
+gemini-cli-extension
+antigravity
+architecture-review
+code-review
+design-review
+runtime-design
+structural-engineering
+tender-review
+construction-management
+```
+
+Pinned README 搜索摘要可使用：
+
+```text
+默认中文输出，保留英文检索能力：building-industry AI, project evidence work, BIM, IFC, building code, RAG, GraphRAG, MCP, architecture review, code review, runtime governance, structural review, construction management.
+```
+
+## 公共安装命令
+
+`skills.sh` / Vercel skills CLI：
+
+```powershell
+npx skills add ArchSightLabs/archsight-aios --list
+npx skills add ArchSightLabs/archsight-aios --skill aios-arch --global
+```
+
+Codex：
+
+```powershell
+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
+npx @archsight/aios install --target antigravity --scope user
+```
+
+Gemini CLI extension 兼容入口：
+
+```powershell
+gemini extensions install https://github.com/ArchSightLabs/archsight-aios
+```
+
+Gemini 用户级支持资产：
+
+```powershell
+npx @archsight/aios install --target gemini --scope user
+```
+
+WorkBuddy：
+
+```powershell
+npx @archsight/aios install --target workbuddy --scope user
+```
+
+Claude Code marketplace：
+
+```text
+/plugin marketplace add ArchSightLabs/archsight-aios
+/plugin install archsight-aios@archsight
+```
+
+## 对外搜索词
+
+README、release、npm、GitHub topics 和 launch post 应优先覆盖这些关键词：
+
+```text
+agent skills
+AI agent skills
+Codex skills
+Claude Code skills
+OpenCode skills
+Gemini CLI extension
+Antigravity CLI
+construction AI
+building AI
+building-industry AI
+AEC AI
+project evidence work
+BIM
+IFC
+building code
+building code review
+smart drawing review
+architecture review
+technical design review
+code review
+runtime design
+runtime governance
+MCP
+GraphRAG
+RAG
+structural review
+construction daily
+tender review
+contract evidence chain
+```
+
+## find-skills / skills.sh 索引请求模板
+
+如果 `npx skills find` 搜不到本项目，可向对应社区或仓库提交索引请求：
+
+```text
+Repository: https://github.com/ArchSightLabs/archsight-aios
+Package: @archsight/aios
+License: Apache-2.0
+Supported agents: Codex, Claude Code, Antigravity/agy, Gemini CLI, WorkBuddy, OpenCode, Hermes
+Canonical skill path: skills/
+Install command: npx skills add ArchSightLabs/archsight-aios --list
+NPM install command: npx @archsight/aios install --target all --scope user
+Representative skills: aios-arch, aios-design, aios-plan, aios-exec, aios-review, aios-knowledge, aios-structural, aios-runtime, aios-commercial-tender, aios-construction-daily
+Keywords: agent skills, construction AI, BIM, IFC, building code, GraphRAG, architecture review, design review, code review, runtime design, MCP, structural review, tender review, construction management
+```
+
+## 发布前检查
+
+每次发版前至少验证：
+
+```powershell
+npm run validate:skills
+npx skills add . --list
+npm test
+```
+
+如果本机安装了对应 CLI，再验证：
+
+```powershell
+gemini extensions validate .
+claude plugin validate .
+```
+
+## 参考
+
+- Codex Agent Skills: https://developers.openai.com/codex/skills
+- OpenAI skills catalog: https://github.com/openai/skills
+- Claude Code plugin marketplace: https://code.claude.com/docs/en/plugin-marketplaces
+- Claude Code plugin reference: https://code.claude.com/docs/en/plugins-reference
+- Gemini CLI extension releasing: https://github.com/google-gemini/gemini-cli/blob/main/docs/extensions/releasing.md
+- Vercel skills CLI discovery: https://github.com/vercel-labs/skills

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

@@ -0,0 +1,6 @@
+{
+  "name": "archsight-aios",
+  "version": "1.3.0",
+  "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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@archsight/aios",
-  "version": "1.1.0",
-  "description": "面向建筑 AI 研发的规则、Skill、Workflow 与多 Agent 项目接入工具包。",
+  "version": "1.3.0",
+  "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",
   "repository": {
@@ -11,34 +11,62 @@
   "bugs": {
     "url": "https://github.com/ArchSightLabs/archsight-aios/issues"
   },
-  "keywords": [
-    "ai",
-    "agents",
-    "architecture",
-    "bim",
-    "ifc",
-    "rag",
-    "graphrag",
-    "construction",
-    "codex",
-    "antigravity",
-    "claude-code"
-  ],
+  "keywords": [
+    "ai",
+    "agents",
+    "architecture",
+    "bim",
+    "ifc",
+    "rag",
+    "graphrag",
+    "construction",
+    "construction-ai",
+    "building-ai",
+    "aec",
+    "building-code",
+    "project-evidence-work",
+    "agent-skills",
+    "ai-agent",
+    "codex",
+    "gemini-cli",
+    "antigravity",
+    "claude-code",
+    "workbuddy",
+    "opencode",
+    "skills-sh",
+    "mcp",
+    "runtime-governance",
+    "architecture-review",
+    "code-review",
+    "design-review"
+  ],
   "bin": {
     "archsight-aios": "./bin/archsight-aios.mjs"
   },
-  "scripts": {
-    "doctor": "node ./bin/archsight-aios.mjs doctor",
-    "install:user": "node ./bin/archsight-aios.mjs install --target all --scope user",
-    "smoke:project": "node ./bin/archsight-aios.mjs validate --temp",
-    "test": "node ./tests/cli.test.mjs"
-  },
+  "scripts": {
+    "doctor": "node ./bin/archsight-aios.mjs doctor",
+    "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": {
     "node": ">=18"
   },
-  "files": [
-    "bin/",
-    "skills/",
+  "files": [
+    "bin/",
+    "scripts/",
+    "adapters/",
+    "skills/",
     "workflows/",
     "templates/",
     "runtime/",
@@ -52,18 +80,22 @@
     "standards/",
     "infra/",
     "prompts/",
-    "vision/",
-    "docs/",
-    "LICENSE",
-    "CHANGELOG.md",
-    "CONTRIBUTING.md",
+    "vision/",
+    "docs/",
+    ".claude-plugin/",
+    "gemini-extension.json",
+    "LICENSE",
+    "CHANGELOG.md",
+    "RELEASE_NOTES.md",
+    "CONTRIBUTING.md",
     "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` 只是输出骨架样例，用于验证格式和检查器本身，不代表真实模型评测结果。

package/prompts/evaluations/engineering-business-basic-advisory-validation-2026-06-16.md

@@ -0,0 +1,87 @@
+# 工程业务基础提示词 advisory 复核说明
+
+> 日期：2026-06-16
+> 范围：6 个工程业务基础提示词与 advisory 工作区中的旧提示词包、普通 / 优化输出对比记录。
+> 边界：本文件只记录脱敏后的案例形态、输出差异和沉淀判断；不复制原始业务资料、联系人、项目名称、金额细节或完整模型输出。
+
+## 复核结论
+
+当前 AIOS 基础提示词比 advisory 旧提示词更适合沉淀为通用 Skill，原因不是“答案更长”，而是把旧提示词中的经验规则收口成了稳定规程：
+
+| 维度 | advisory 旧提示词包 | AIOS 基础提示词 |
+|---|---|---|
+| 使用场景 | 为 PPT 准备和现场分享服务，文件之间相对独立 | 作为 `aios-*` Skill 的可复用基础模式 |
+| 输入判断 | 每个提示词有边界提示，但分散在单文件内 | 每个 Skill 固定先判断资料类型、缺口和可验证程度 |
+| 输出形态 | 已能生成矩阵、清单、台账和回查表 | 进一步统一 Source Map、主表、需确认项、复核岗位和不能下结论事项 |
+| 风险边界 | 依赖提示词文本和人工使用习惯 | 固化禁止结论、人工复核岗位、L0-L1 能力边界和验证脚本 |
+| 资产化程度 | 更像一次项目素材包 | 已进入 registry、manifest、安装分发、fixtures、scorecard 和 CLI 校验 |
+
+因此，“更好”的选择不是直接搬 advisory 旧提示词，而是使用 AIOS 基础提示词作为通用技能包版本；advisory 旧提示词继续作为来源验证和案例启发。
+
+## 只读复核来源
+
+本次只读查看了 advisory 中的以下类型资产：
+
+- `source/prompts/README.md`：旧提示词包的使用方式、输出验证和文件清单。
+- `source/prompts/01-...` 到 `source/prompts/06-...`：6 个工程业务场景提示词。
+- `source/prompts/07-...`：终稿阶段的案例分工、提示词优化方向和边界记录。
+- `source/prompt-runs/2026-06-14-普通与优化提示词输出对比.md`：普通提示词与优化提示词的逐场景对比。
+
+未读取或复制到 AIOS 的内容：
+
+- 原始 docx / pdf 全文。
+- 真实项目名称、联系人、公司内部称呼。
+- 完整模型输出、金额细节、合同完整条款或正式资料编号。
+
+## 场景信号映射
+
+| AIOS caseId | advisory 抽象信号 | AIOS 固化结果 |
+|---|---|---|
+| `commercial-tender-response-matrix` | 技术标工具试用后的人工检查问题 + 评分点结构；不是完整招标原文读标 | 固化为输入类型判断、缺少可验证招标依据、问题回应矩阵、评分点响应矩阵 |
+| `commercial-contract-obligation-nodes` | 工程合同片段有履约节点，也有空白字段和专业复核边界 | 固化为空白字段核对表、关键履约节点、付款结算条件和不能下结论事项 |
+| `construction-daily-issue-tracking` | 日报有施工内容，也有资源、材料、照片等空白字段 | 固化为管理摘要、问题跟踪表、模板质量诊断；空白不等于现场事实 |
+| `construction-meeting-action-closure` | 会议记录有发言人、状态和待办，但责任人 / 期限常不完整 | 固化为待办闭环、责任线索、需确认责任人和需确认期限 |
+| `commercial-variation-evidence-chain` | 公开样表字段可讲资料链方法，但不证明具体项目事实 | 固化为资料链完整度、样表字段结构、过程线索和正式依据缺口 |
+| `construction-scheme-assistive-review` | 施工方案 AI 生成 / 复核反馈涉及参数、图纸、地方标准和计算书边界 | 固化为辅助复核口径、失准复盘、专家修改说明回查和人工复核问题清单 |
+
+## 普通提示词失败模式
+
+advisory 对比记录显示，普通提示词在 6 个场景中有共性问题：
+
+- 容易默认资料完整，跳过输入状态判断。
+- 容易输出段落摘要，而不是可分工的矩阵、台账或回查表。
+- 容易把未提供、未填、未见的内容写成事实判断。
+- 容易把业务风险提示写成法律、造价、质量安全或审批结论。
+- 容易把一次性回答当成工具能力、系统能力或正式交付能力。
+
+AIOS 基础提示词针对这些问题加了统一约束：
+
+- `Source Map` 和资料状态判断。
+- 主输出表格或清单。
+- `需补充确认` / `Need verify`。
+- 人工复核岗位。
+- `不能下结论的事项`。
+- `Claim / Evidence / Tool Result / Decision`。
+
+## 对当前 AIOS 资产的影响
+
+本次复核后，AIOS 保留以下沉淀方式：
+
+- 6 个基础提示词继续放在各自 Skill 的 `prompts/basic-prompt.md`。
+- `engineering-business-basic-fixtures.json` 增加 `sourceSignals` 和 `advisoryComparison`，记录脱敏来源信号。
+- `engineering-business-basic-scorecard.json` 继续作为“哪套更好”的结构化判断。
+- `validate-prompt-fixtures.mjs` 校验来源信号必须是抽象前缀，避免真实资料名回流。
+
+## 仍未完成的验证
+
+当前验证可以证明提示词设计、案例覆盖、边界规则和资产分发链路已经成形，但不能声称已经完成真实外部模型批量评测。
+
+真实批跑需要：
+
+1. 生成 weak/basic run pack。
+2. 用同一模型分别跑 12 条输入。
+3. 把输出填入 run results JSON。
+4. 执行 `validate-prompt-run-results.mjs --file`。
+5. 执行 `analyze-prompt-run-results.mjs --file ... --out ...`。
+
+没有真实模型输出时，scorecard 只能作为设计评审和静态回归门禁，不能当作模型效果保证。