@archsight/aios 1.3.1 → 1.4.0

package/.claude-plugin/plugin.json

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

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # 变更记录
 
+## 1.4.0
+
+### 新增
+
+- 新增 `aios-tender-write` 写作型 Skill，用于工程标书、技术标、投标响应章节生成 / 改写和历史标书素材复用；生成后必须交回 `aios-commercial-tender` 做响应性、废标风险、评分点缺口和人工复核门禁。
+- 新增 `aios-scheme-write` 写作型 Skill，用于专项施工方案、施工技术措施和交底材料生成 / 改写和历史方案素材复用；生成后必须交回 `aios-construction-scheme` 做危险源、规范 / 计算书、专家意见和交底要点门禁。
+- 新增 `templates/document-writing/` Markdown 工作母版，覆盖 `source-normalized.md`、`material-index.md`、`writing-brief.md`、`draft.md`、`review-notes.md` 和 `final.md`。
+- 新增 `archsight-aios writing:init`，可在业务项目中一键创建标书 / 方案写作工作台；默认不覆盖已有工作文件。
+- 新增 `archsight-aios writing:validate`，用于检查写作工作台的文件链、来源、历史素材复用、待补占位、审核门禁和人工定稿边界。
+- `writing:init` 支持 `--sample`，可生成技术标和专项施工方案的端到端脱敏样板工作台。
+- 新增 `prompts/evaluations/engineering-document-writing-fixtures.json` 及 `validate:document-writing-run-pack` / `build:document-writing-run-pack`，用于验证写作型 Skill 的脱敏 weak/basic 对照输入。
+- 新增 `engineering-document-writing-scorecard.json`，固定来源链、素材复用、初稿可操作性、边界安全、审核门禁和交接可读性评分维度。
+- 新增 `prompts/evaluations/skill-runtime/` 归档规范和 `validate:skill-runtime-evidence`，用于区分真实 Skill 触发、blocked 状态和 prompt paste 结果。
+- 新增 Codex / WorkBuddy 写作型 Skill raw output 归档和 scorecard 复核记录，覆盖 `aios-tender-write` / `aios-scheme-write` 四个宿主样板 case。
+- 新增 WorkBuddy-first 写作工作流快速使用说明、写作能力边界和 v1.4.0 release readiness 清单。
+
+### 调整
+
+- `aios` / `archsight-aios` 总入口、CLI 自动识别、manifest、Skill 路由和项目接入模板补充写作型 Skill。
+- CLI Skill 自动识别改为对更具体的写作短语加权，减少“技术标生成 / 施工方案生成”误落到审核型 Skill 的概率。
+- v1.4.0 发布门槛明确：Codex / WorkBuddy 写作型 Skill raw output 与 scorecard 复核已具备；版本号已同步，正式发布仍需 tag、push 和 GitHub Release。
+- v1.4.0 路线图明确“工程文档生成、改写与复核闭环”：Markdown 是工作母版，Word / PDF / PPT 是交付格式；现有审核型 Skill 继续作为质量门禁。
+
+## 1.3.2
+
+### 发布说明
+
+本版本修复 v1.3.1 后在不同宿主中出现的 Skill 遵从度不一致问题。重点强化“短指令触发 AIOS”时的默认输出契约：用户只说“用 AIOS 分析该文档”且没有要求摘要时，默认输出标准详版报告，而不是几段概括性摘要。
+
+### 调整
+
+- 版本升级到 `1.3.2`，同步更新 npm package、Gemini extension、Claude plugin、runtime manifest 和 CLI MCP clientInfo。
+- `aios` / `archsight-aios` 总入口明确短指令默认走“标准详版报告”，路由后仍要展开专项 Skill 的主表、清单或台账。
+- 工程业务管理 Skill 增加“标准详版报告与输出自检”约束，覆盖招投标、合同、施工日报、会议纪要、变更签证和专项施工方案。
+- 各工程业务 Skill 的 `openai.yaml` 默认提示补充“不要压缩成摘要”“资料来源”“主分析表或台账”“资料缺口”“人工复核”“AI 不应下结论事项”和“输出自检”。
+- Prompt 评估策略新增“宿主遵从度受控评测”，用于区分 WorkBuddy、Codex、Gemini、Antigravity 等宿主差异和模型能力差异。
+
+### 验证
+
+- `npm run validate:skills`
+- `npm test`
+- `git diff --check`
+- `npm pack --dry-run`
+
 ## 1.3.1
 
 ### 发布说明

package/README.md

@@ -109,6 +109,8 @@ AIOS 的多 Agent 协作不应停留在 Prompt 角色扮演。Agent 提出架构
 | `install` | 安装 ArchSight AIOS 用户级资产到 Codex、Claude Code、OpenCode、Antigravity 2.0、Gemini、WorkBuddy 和共享目录。 |
 | `doctor` | 检查仓库资产、manifest、用户级安装、Skill 和 Workflow 是否一致。 |
 | `init` | 给具体业务项目接入 AI 规则、`.ai/` 治理目录、自动 profile 识别和项目上下文草稿。 |
+| `writing:init` | 在业务项目中创建标书 / 方案写作 Markdown 工作台，用于写作型 Skill 生成和审核门禁交接。 |
+| `writing:validate` | 检查写作工作台的文件链、来源、复用、待补、审核门禁和人工定稿边界。 |
 | `validate` | 验证项目接入模板能否生成并引用当前登记的 Skills / Workflows。 |
 | `validate:skills` | 校验公共 skill 发现入口、frontmatter、跨 host manifest 和 npm metadata 是否一致。 |
 | `capability:call` | 按 Capability Registry 权限边界调用本地 MCP Adapter，并输出 Tool Result 与仲裁 Decision。 |
@@ -123,6 +125,40 @@ npx @archsight/aios capability:call --capability solver.beam_deflection_servicea
 
 如果 `archsight-aios` 和 `archsight-solver` 是同级目录，CLI 会默认尝试使用相邻的 `../archsight-solver`，通常无需设置 `ARCHSIGHT_SOLVER_HOME`。
 
+## 工程文档写作工作台
+
+v1.4.0 开始，AIOS 提供写作型 Skill 和 Markdown 工作母版，用于标书、技术标、专项施工方案和交底材料的生成 / 改写。Markdown 是 AIOS 工作母版，Word / PDF / PPT 只作为后续交付格式。
+
+在项目目录创建工作台：
+
+```bash
+npx @archsight/aios writing:init --type tender
+npx @archsight/aios writing:init --type scheme --name scheme-workbench
+npx @archsight/aios writing:init --type tender --sample --name tender-sample
+```
+
+生成目录默认包含：
+
+- `source-normalized.md`：归一化输入资料和来源链。
+- `material-index.md`：历史素材、复用级别和不可套用原因。
+- `writing-brief.md`：写作任务、目标章节、禁止结论和人工复核岗位。
+- `draft.md`：AI 生成或改写的章节草稿。
+- `review-notes.md`：交给审核 Skill 后的复核记录。
+- `final.md`：人工确认后的最终 Markdown 母版。
+
+检查工作台完整性：
+
+```bash
+npx @archsight/aios writing:validate --name document-writing
+```
+
+推荐路由：
+
+- 标书 / 技术标写作：先用 `aios-tender-write`，再交给 `aios-commercial-tender` 审核门禁。
+- 专项施工方案写作：先用 `aios-scheme-write`，再交给 `aios-construction-scheme` 审核门禁。
+
+`writing:init` 只创建缺失文件，重复执行不会覆盖已有工作台内容。
+
 ## 安装位置
 
 `install --target all --scope user` 会写入当前用户目录：
@@ -223,6 +259,8 @@ npm test
 - [Templates](templates/README.md)
 - [Runtime 路由](runtime/agent-routing.md)
 - [WorkBuddy 适配说明](adapters/workbuddy/README.md)
+- [v1.4.0 写作工作流快速使用](docs/v1.4.0-writing-workflow-quickstart.md)
+- [v1.4.0 写作能力边界](docs/v1.4.0-writing-boundary.md)
 - [公共发现与上架清单](docs/PUBLIC_DISCOVERY.md)
 
 ## 开源协作

package/RELEASE_NOTES.md

@@ -1,5 +1,54 @@
 # Release Notes
 
+## 1.4.0
+
+本版本主线是把 AIOS 从“审核型 Skill”推进到“工程文档生成、改写与复核闭环”。新增写作型 Skill 负责初稿生成、历史素材复用和 Markdown 工作母版；现有审核型 Skill 继续负责响应性、证据链、风险和人工复核门禁。
+
+核心变化：
+
+- 新增 `aios-tender-write`：基于招标文件、评分办法、企业历史标书素材、类似项目案例和用户初稿生成 / 改写技术标章节。
+- 新增 `aios-scheme-write`：基于方案初稿、历史方案素材、工程概况、专家意见和用户模板生成 / 改写专项施工方案章节。
+- 新增 `templates/document-writing/`：提供 `source-normalized.md`、`material-index.md`、`writing-brief.md`、`draft.md`、`review-notes.md` 和 `final.md` 工作母版。
+- 新增 `archsight-aios writing:init`：在业务项目中创建标书 / 方案 Markdown 写作工作台，已有文件不覆盖。
+- 新增 `archsight-aios writing:validate`：检查写作工作台结构和关键边界。
+- `writing:init --sample` 可生成技术标 / 专项施工方案端到端脱敏样板。
+- 新增写作型脱敏评测 fixture 和 run-pack 命令：`validate:document-writing-run-pack`、`build:document-writing-run-pack`。
+- 新增写作型 scorecard 和 skill-runtime 证据归档校验：`validate:document-writing-scorecard`、`validate:skill-runtime-evidence`。
+- 新增 Codex / WorkBuddy 写作型 Skill raw output 归档和 scorecard 复核记录，覆盖 `aios-tender-write` / `aios-scheme-write` 四个宿主样板 case。
+- 新增 WorkBuddy-first 快速使用说明、写作能力边界和 v1.4.0 release readiness 清单。
+- 写作型 Skill 必须保留资料来源、素材复用判断、待补占位、人工复核岗位和审核门禁，不得把历史项目事实直接套入当前项目。
+- CLI 自动识别对更具体的生成 / 改写短语加权，降低写作请求误入审核型 Skill 的概率。
+- 当前 skill-runtime 归档已记录 Codex / WorkBuddy 真实触发 raw output，并按写作型 scorecard 复核通过；版本号已同步到 `1.4.0`，正式发布仍需 tag、push 和 GitHub Release。
+
+发布前验证建议：
+
+- `npm run validate:skills`
+- `npm run validate:prompts`
+- `npm run validate:document-writing-run-pack`
+- `npm run validate:document-writing-scorecard`
+- `npm run validate:skill-runtime-evidence`
+- `npm test`
+- `git diff --check`
+- `npm pack --dry-run`
+
+## 1.3.2
+
+本版本修复 v1.3.1 后在不同宿主中出现的 Skill 遵从度不一致问题。用户只说“用 AIOS 分析该文档”且没有要求摘要时，AIOS 默认应输出标准详版报告，而不是短摘要。
+
+核心变化：
+
+- `aios` / `archsight-aios` 总入口明确短指令默认走“标准详版报告”。
+- 招投标、合同、施工日报、会议纪要、变更签证和专项施工方案 Skill 增加“标准详版报告与输出自检”约束。
+- 各工程业务 Skill 的轻量 `openai.yaml` 默认提示同步补充详版报告、自检、资料来源、主表 / 台账、资料缺口、人工复核和 AI 不应下结论事项。
+- Prompt 评估策略增加宿主遵从度受控评测口径，避免把 WorkBuddy / Codex / Gemini / Antigravity 的整体效果差异直接归因到单一模型。
+
+发布前验证建议：
+
+- `npm run validate:skills`
+- `npm test`
+- `git diff --check`
+- `npm pack --dry-run`
+
 ## 1.3.1
 
 本版本聚焦“让使用者感觉简单”：新增 `aios` / `archsight-aios` 总入口，用户可以用短句调用 AIOS，由技能包根据资料类型自动路由；同时新增用户侧 `aios-compare`，并把内部 `aios-prompt-compare` 收紧为开发者显式调用的 Prompt 测试工具。

package/bin/archsight-aios.mjs

@@ -56,11 +56,13 @@ const skillAliases = {
   ],
   "aios-exec": ["aios-controlled-execution", "archsight-controlled-execution"],
   "aios-commercial-tender": ["aios-tender", "archsight-tender"],
+  "aios-tender-write": ["aios-bid-write", "archsight-bid-write", "aios-technical-bid-write"],
   "aios-commercial-contract": ["aios-contract", "archsight-contract"],
   "aios-commercial-variation": ["aios-variation", "archsight-variation"],
   "aios-construction-daily": ["aios-daily", "archsight-daily"],
   "aios-construction-meeting": ["aios-meeting", "archsight-meeting"],
-  "aios-construction-scheme": ["aios-scheme", "archsight-scheme"]
+  "aios-construction-scheme": ["aios-scheme", "archsight-scheme"],
+  "aios-scheme-write": ["aios-construction-scheme-write", "archsight-scheme-write"]
 };
 
 const profileDetectionRules = {
@@ -132,11 +134,13 @@ const skillDetectionRules = {
   "aios-compare": ["aios-compare"],
   "aios-prompt-compare": ["aios-prompt-compare"],
   "aios-commercial-tender": ["招标", "投标", "技术标", "商务标", "评分", "废标", "招采", "资格"],
+  "aios-tender-write": ["标书编写", "技术标编写", "技术标生成", "技术标改写", "投标文件生成", "投标响应生成", "标书优化", "标书改写", "历史标书", "评分点响应"],
   "aios-commercial-contract": ["合同", "协议", "付款", "履约", "违约", "分包", "采购", "结算条款"],
   "aios-construction-daily": ["日报", "周报", "现场记录", "施工日志", "进度", "材料进场", "机械", "劳务"],
   "aios-construction-meeting": ["会议纪要", "例会", "协调会", "专题会", "待办", "责任人"],
   "aios-commercial-variation": ["变更", "签证", "联系单", "索赔", "洽商", "工程量"],
-  "aios-construction-scheme": ["施工方案", "专项方案", "危大", "交底", "危险源", "专家论证"]
+  "aios-construction-scheme": ["施工方案", "专项方案", "危大", "交底", "危险源", "专家论证"],
+  "aios-scheme-write": ["方案编写", "方案生成", "施工方案生成", "专项施工方案生成", "方案改写", "施工方案改写", "方案优化", "历史方案", "专家意见回写", "施工方案初稿"]
 };
 
 const ignoredDetectionDirs = new Set([
@@ -164,6 +168,8 @@ function usage() {
     "  archsight-aios install --target <codex|agents|gemini|antigravity|workbuddy|opencode|claude-code|all> --scope user",
     "  archsight-aios doctor",
     "  archsight-aios init [--cwd <path>] [--mode <auto|full|linked|ai-only>] [--profile <auto|none|all|name>]",
+    "  archsight-aios writing:init [--cwd <path>] [--type <tender|scheme|general>] [--name <folder>] [--sample]",
+    "  archsight-aios writing:validate [--cwd <path>] [--name <folder>]",
     "  archsight-aios validate [--cwd <path>] [--profile <auto|none|all|name>] [--temp]",
     "  archsight-aios capability:call --capability <id> --agent <id> --skill <id> --input <json-file>",
     "  archsight-aios hermes:validate",
@@ -175,6 +181,8 @@ function usage() {
     "  install               Install AIOS assets into user-level assistant locations.",
     "  doctor                Check repository assets and user-level installation.",
     "  init                  Add AI rules and .ai governance files to a project.",
+    "  writing:init          Create a Markdown document-writing workbench.",
+    "  writing:validate      Check a Markdown document-writing workbench.",
     "  validate              Validate the project AI template output.",
     "  capability:call       Authorize and call a registered local Capability adapter.",
     "  hermes:*              Validate or dry-run Hermes runtime prompt sync.",
@@ -186,6 +194,9 @@ function usage() {
     "  npx @archsight/aios install --target opencode --scope user",
     "  npx @archsight/aios install --target claude-code --scope user",
     "  npx @archsight/aios init",
+    "  npx @archsight/aios writing:init --type tender",
+    "  npx @archsight/aios writing:init --type scheme --sample --name scheme-sample",
+    "  npx @archsight/aios writing:validate --name document-writing",
     "  npx @archsight/aios validate --temp",
     "  npx @archsight/aios doctor"
   ].join("\n");
@@ -206,6 +217,9 @@ function parseArgs(argv) {
     capability: undefined,
     agent: undefined,
     skill: undefined,
+    documentType: "general",
+    workspaceName: "document-writing",
+    sample: false,
     input: undefined,
     mcpCwd: undefined,
     mcpCommand: undefined,
@@ -233,6 +247,12 @@ function parseArgs(argv) {
       options.agent = rest[++i];
     } else if (arg === "--skill") {
       options.skill = rest[++i];
+    } else if (arg === "--type") {
+      options.documentType = rest[++i];
+    } else if (arg === "--name") {
+      options.workspaceName = rest[++i];
+    } else if (arg === "--sample") {
+      options.sample = true;
     } else if (arg === "--input") {
       options.input = path.resolve(rest[++i]);
     } else if (arg === "--mcp-cwd") {
@@ -625,7 +645,7 @@ function callMcpStdio({ command, args, cwd, toolName, input, timeoutMs }) {
       params: {
         protocolVersion: "2025-06-18",
         capabilities: {},
-        clientInfo: { name: "archsight-aios", version: "1.3.1" }
+        clientInfo: { name: "archsight-aios", version: "1.4.0" }
       }
     };
     const callTool = {
@@ -971,15 +991,32 @@ function confidenceFromScore(score) {
   return "low";
 }
 
-function scoreDetectionRules(ruleMap, signalText) {
+function detectionKeywordWeight(keyword, weighted) {
+  if (!weighted) {
+    return 1;
+  }
+
+  const length = normalizeSignal(keyword).trim().length;
+  if (length >= 8) {
+    return 4;
+  }
+  if (length >= 5) {
+    return 3;
+  }
+  return 1;
+}
+
+function scoreDetectionRules(ruleMap, signalText, options = {}) {
   const normalized = normalizeSignal(signalText);
   return Object.entries(ruleMap)
     .map(([id, keywords]) => {
       const matches = keywords.filter((keyword) => normalized.includes(normalizeSignal(keyword)));
+      const score = matches.reduce((sum, keyword) => sum + detectionKeywordWeight(keyword, options.weighted), 0);
       return {
         id,
-        score: matches.length,
-        confidence: matches.length > 0 ? confidenceFromScore(matches.length) : "none",
+        score,
+        matchCount: matches.length,
+        confidence: score > 0 ? confidenceFromScore(score) : "none",
         matches
       };
     })
@@ -1077,7 +1114,7 @@ async function collectProjectDiscovery(targetRoot) {
 
 function detectProjectContext(manifest, discovery) {
   const profileScores = scoreDetectionRules(profileDetectionRules, discovery.signalText);
-  const skillScores = scoreDetectionRules(skillDetectionRules, discovery.signalText);
+  const skillScores = scoreDetectionRules(skillDetectionRules, discovery.signalText, { weighted: true });
   const profileDescriptions = new Map((manifest.projectProfiles ?? []).map((profile) => [profile.id, profile.description]));
   const skillMetadata = new Map((manifest.skills ?? []).map((skill) => [skill.id, skill]));
 
@@ -1129,7 +1166,10 @@ function renderMatchList(scores, emptyText) {
 
   return scores.map((item) => {
     const matches = item.matches.slice(0, 8).join("、");
-    return `- \`${item.id}\`：${item.confidence}，命中 ${item.score} 项（${matches}）`;
+    const scoreText = item.matchCount && item.matchCount !== item.score
+      ? `命中 ${item.matchCount} 项，权重 ${item.score}`
+      : `命中 ${item.score} 项`;
+    return `- \`${item.id}\`：${item.confidence}，${scoreText}（${matches}）`;
   });
 }
 
@@ -1755,6 +1795,207 @@ async function initProject(options) {
   }
 }
 
+function resolveDocumentWritingType(value) {
+  const normalized = normalizeSignal(value ?? "general").replaceAll("_", "-");
+  const aliases = new Map([
+    ["general", "general"],
+    ["all", "general"],
+    ["通用", "general"],
+    ["tender", "tender"],
+    ["bid", "tender"],
+    ["technical-bid", "tender"],
+    ["标书", "tender"],
+    ["技术标", "tender"],
+    ["投标", "tender"],
+    ["scheme", "scheme"],
+    ["construction-scheme", "scheme"],
+    ["方案", "scheme"],
+    ["施工方案", "scheme"],
+    ["专项施工方案", "scheme"]
+  ]);
+
+  const type = aliases.get(normalized);
+  if (!type) {
+    throw new Error(`Unsupported writing workspace type: ${value}`);
+  }
+  return type;
+}
+
+function documentWritingTypeConfig(type) {
+  const configs = {
+    general: {
+      label: "工程文档写作",
+      skill: "aios-tender-write / aios-scheme-write",
+      gate: "aios-commercial-tender / aios-construction-scheme",
+      firstStep: "先在 writing-brief.md 明确是标书、技术标、专项施工方案还是交底材料。"
+    },
+    tender: {
+      label: "标书 / 技术标写作",
+      skill: "aios-tender-write",
+      gate: "aios-commercial-tender",
+      firstStep: "先把招标文件、评分办法、技术要求、用户初稿和历史标书索引写入工作母版。"
+    },
+    scheme: {
+      label: "专项施工方案写作",
+      skill: "aios-scheme-write",
+      gate: "aios-construction-scheme",
+      firstStep: "先把工程概况、方案初稿、历史方案、专家意见和计算书目录写入工作母版。"
+    }
+  };
+  return configs[type];
+}
+
+function renderDocumentWritingReadme(type) {
+  const config = documentWritingTypeConfig(type);
+  return [
+    "# AIOS Document Writing Workbench",
+    "",
+    `> 类型：${config.label}`,
+    "",
+    "## 使用顺序",
+    "",
+    "1. 在 `source-normalized.md` 中归一化输入资料，只写来源明确的事实。",
+    "2. 在 `material-index.md` 中登记历史素材、复用级别和不可复用原因。",
+    "3. 在 `writing-brief.md` 中明确写作任务、目标章节、人工复核岗位和禁止结论。",
+    "4. 使用对应写作 Skill 生成或改写 `draft.md`。",
+    "5. 把草稿交给审核门禁 Skill，审核结论写入 `review-notes.md`。",
+    "6. 人工确认后再整理 `final.md`，Word / PDF / PPT 只作为交付格式。",
+    "",
+    "## 推荐 Skill",
+    "",
+    `- 写作入口：\`${config.skill}\``,
+    `- 审核门禁：\`${config.gate}\``,
+    "",
+    "## 首步动作",
+    "",
+    config.firstStep,
+    "",
+    "## 边界",
+    "",
+    "- 不编造资质、业绩、人员、设备、工期、金额、奖项或项目事实。",
+    "- 缺少依据时写 `待补`、`需核验` 或 `转人工复核`。",
+    "- AI 输出是 Markdown 工作母版，不是正式交付定稿。",
+    ""
+  ].join("\n");
+}
+
+async function initDocumentWritingWorkspace(options) {
+  const targetRoot = path.resolve(options.cwd);
+  const workspaceName = options.workspaceName ?? "document-writing";
+  if (!workspaceName || path.isAbsolute(workspaceName)) {
+    throw new Error("--name must be a relative folder name");
+  }
+
+  const requestedType = resolveDocumentWritingType(options.documentType);
+  const type = options.sample && requestedType === "general" ? "tender" : requestedType;
+  const templateRoot = options.sample
+    ? path.join(repoRoot, "templates", "document-writing-samples", type)
+    : path.join(repoRoot, "templates", "document-writing");
+  const workspaceRoot = path.resolve(targetRoot, workspaceName);
+  assertInside(workspaceRoot, targetRoot);
+
+  await ensureDir(targetRoot);
+  await copyTreeMissing(templateRoot, workspaceRoot);
+
+  const readmePath = path.join(workspaceRoot, "README.md");
+  assertInside(readmePath, workspaceRoot);
+  if (await exists(readmePath)) {
+    console.log(`SKIP existing ${readmePath}`);
+  } else {
+    await fs.writeFile(readmePath, renderDocumentWritingReadme(type), "utf8");
+    console.log(`CREATE ${readmePath}`);
+  }
+
+  console.log(`WRITING ${type}: ${workspaceRoot}`);
+}
+
+const documentWritingFiles = [
+  "source-normalized.md",
+  "material-index.md",
+  "writing-brief.md",
+  "draft.md",
+  "review-notes.md",
+  "final.md"
+];
+
+async function resolveDocumentWritingWorkspaceRoot(options) {
+  const targetRoot = path.resolve(options.cwd);
+  const workspaceName = options.workspaceName ?? "document-writing";
+  if (!workspaceName || path.isAbsolute(workspaceName)) {
+    throw new Error("--name must be a relative folder name");
+  }
+
+  const namedRoot = path.resolve(targetRoot, workspaceName);
+  assertInside(namedRoot, targetRoot);
+  if (await exists(namedRoot)) {
+    return namedRoot;
+  }
+
+  let targetRootHasWorkbench = true;
+  for (const fileName of documentWritingFiles) {
+    if (!(await exists(path.join(targetRoot, fileName)))) {
+      targetRootHasWorkbench = false;
+      break;
+    }
+  }
+  if (targetRootHasWorkbench) {
+    return targetRoot;
+  }
+
+  return namedRoot;
+}
+
+async function validateDocumentWritingWorkspace(options) {
+  const workspaceRoot = await resolveDocumentWritingWorkspaceRoot(options);
+  const checks = [];
+
+  async function check(label, ok, detail = "") {
+    checks.push({ label, ok, detail });
+  }
+
+  await check("workspace directory", await exists(workspaceRoot), workspaceRoot);
+  for (const fileName of documentWritingFiles) {
+    const filePath = path.join(workspaceRoot, fileName);
+    const ok = await exists(filePath);
+    await check(`${fileName} exists`, ok, filePath);
+    if (!ok) {
+      continue;
+    }
+    const content = await fs.readFile(filePath, "utf8");
+    await check(`${fileName} is non-empty`, content.trim().length > 0, filePath);
+  }
+
+  const source = await readTextIfExists(path.join(workspaceRoot, "source-normalized.md"));
+  const materials = await readTextIfExists(path.join(workspaceRoot, "material-index.md"));
+  const brief = await readTextIfExists(path.join(workspaceRoot, "writing-brief.md"));
+  const draft = await readTextIfExists(path.join(workspaceRoot, "draft.md"));
+  const review = await readTextIfExists(path.join(workspaceRoot, "review-notes.md"));
+  const final = await readTextIfExists(path.join(workspaceRoot, "final.md"));
+
+  await check("source-normalized keeps source list", source.includes("资料来源清单"));
+  await check("material-index keeps reuse levels", materials.includes("复用级别"));
+  await check("writing-brief keeps banned claims", brief.includes("禁止承诺") || brief.includes("禁止结论"));
+  await check("draft keeps provenance placeholders", draft.includes("来源") && draft.includes("待补"));
+  await check(
+    "review-notes keeps audit gate",
+    review.includes("aios-commercial-tender") || review.includes("aios-construction-scheme")
+  );
+  await check("final keeps manual confirmation", final.includes("人工") && final.includes("定稿"));
+
+  const failed = checks.filter((item) => !item.ok);
+  for (const item of checks) {
+    console.log(`${item.ok ? "OK " : "MISS"} ${item.label}${item.detail ? `: ${item.detail}` : ""}`);
+  }
+
+  if (failed.length > 0) {
+    process.exitCode = 1;
+    console.error(`Writing workbench validation failed: ${failed.length} issue(s).`);
+    return;
+  }
+
+  console.log(`Writing workbench validation passed: ${workspaceRoot}`);
+}
+
 async function validateProjectTemplate(options) {
   const manifest = await readManifest();
   const createdTemp = options.temp;
@@ -1949,6 +2190,10 @@ async function main() {
     await doctor();
   } else if (options.command === "init") {
     await initProject(options);
+  } else if (options.command === "writing:init") {
+    await initDocumentWritingWorkspace(options);
+  } else if (options.command === "writing:validate") {
+    await validateDocumentWritingWorkspace(options);
   } else if (options.command === "validate") {
     await validateProjectTemplate(options);
   } else if (options.command === "capability:call") {

package/delivery/README.md

@@ -5,6 +5,7 @@
 推荐内容：
 
 - [发布清单](release-checklist.md)
+- [v1.4.0 发布就绪清单](v1.4.0-release-readiness.md)
 - [AI 生成代码检查](ai-generated-code-checklist.md)
 - [回滚策略](rollback-policy.md)
 - 自动测试

package/delivery/v1.4.0-release-readiness.md

@@ -0,0 +1,64 @@
+# v1.4.0 Release Readiness
+
+本清单用于 v1.4.0 正式发布前收口。当前版本元数据已同步到 `1.4.0`；不得仅因版本同步就视为 GitHub Release 已发布。
+
+## 发布硬门槛
+
+- [x] `aios-tender-write` 和 `aios-scheme-write` 的写作样板已通过 `writing:validate`。
+- [x] `engineering-document-writing-scorecard.json` 已通过校验。
+- [x] Codex 真实触发 `aios-tender-write` 原始输出已归档。
+- [x] Codex 真实触发 `aios-scheme-write` 原始输出已归档。
+- [x] WorkBuddy 真实触发 `aios-tender-write` 原始输出已归档。
+- [x] WorkBuddy 真实触发 `aios-scheme-write` 原始输出已归档。
+- [x] 所有真实输出已按写作型 scorecard 复核，不把 prompt paste 结果冒充为 skill-runtime。
+- [x] 外部使用说明已更新，并优先展示 WorkBuddy-first 最短路径。
+
+## 发布级验证命令
+
+```bash
+npm run validate:skills
+npm run validate:prompts
+npm run validate:prompt-run-pack
+npm run validate:public-advisory-run-pack
+npm run validate:document-writing-run-pack
+npm run validate:prompt-run-results
+npm run validate:prompt-outputs
+npm run validate:prompt-scorecard
+npm run validate:skill-runtime-evidence
+npm run doctor
+npm run smoke:project
+npm test
+npx skills add . --list
+npm pack --dry-run
+claude plugin validate .
+git diff --check
+```
+
+如果某个宿主 CLI 不支持对应命令，应记录为宿主工具能力限制，不得写成仓库验证失败或通过。
+
+## 版本同步点
+
+正式 bump 到 `1.4.0` 时必须同步：
+
+- `package.json`
+- `gemini-extension.json`
+- `.claude-plugin/plugin.json`
+- `runtime/archsight-aios.manifest.json`
+- `bin/archsight-aios.mjs` 中 MCP `clientInfo.version`
+- `CHANGELOG.md`
+- `RELEASE_NOTES.md`
+
+## 发布步骤
+
+1. 冻结发布范围。
+2. 更新版本同步点。
+3. 跑完整发布级验证命令。
+4. 提交 release metadata。
+5. 创建 `v1.4.0` tag。
+6. 推送 commit 和 tag。
+7. 检查同名 GitHub Release 是否已存在。
+8. 从 `RELEASE_NOTES.md` 提取 `## 1.4.0` 小节创建 GitHub Release。
+
+## 当前阻断
+
+截至本清单更新时，Codex / WorkBuddy 写作型 Skill 的 raw output 已归档并通过 scorecard 复核，版本元数据已同步到 `1.4.0`。正式发布前剩余工作是最终发布 commit 验证、`v1.4.0` tag、push 和 GitHub Release。

package/docs/quickstart.md

@@ -10,6 +10,14 @@ npx @archsight/aios install --target all --scope user
 
 这一步会把 ArchSight AIOS 的 Skills、Workflows、Runtime 和模板同步到当前用户目录，让 Codex、Claude Code、OpenCode、Gemini、Antigravity、WorkBuddy 等工具可以读取。
 
+如果只是想先在 WorkBuddy 中试用标书 / 方案写作能力，可以先走最短路径：
+
+```bash
+npx @archsight/aios install --target workbuddy --scope user
+```
+
+写作型工作流见 [v1.4.0 写作工作流快速使用](v1.4.0-writing-workflow-quickstart.md)。
+
 ## 2. 检查安装
 
 ```bash

package/docs/v1.4.0-writing-boundary.md

@@ -0,0 +1,42 @@
+# v1.4.0 写作能力边界
+
+v1.4.0 的目标是让 AIOS 从“可用 Skill”进入“可试点落地的工程业务工作流包”。边界必须清楚，否则写作型能力会把初稿生成误包装成专业结论。
+
+## 能做
+
+- 基于用户提供的脱敏资料生成或改写 Markdown 初稿。
+- 整理资料来源、历史素材复用判断和待补资料。
+- 生成技术标、投标响应章节、专项施工方案章节和交底材料初稿。
+- 把生成稿交给审核型 Skill 做响应性、风险、资料缺口和人工复核分流。
+- 为后续 Word / PDF / PPT 定稿提供 Markdown 工作母版。
+
+## 不能做
+
+- 不替代投标负责人做最终投标决策。
+- 不判断中标概率、评标结论、废标最终结论或采购承诺。
+- 不替代总工、专家论证、危大工程审批、结构计算、监理、安全负责人或审批主体。
+- 不确认方案合格、计算正确、专家论证通过、审批通过或现场安全满足。
+- 不把历史项目事实、人员、设备、工期、金额、参数、图号和奖项自动套入当前项目。
+
+## 优秀输出的最低标准
+
+- 有资料来源清单。
+- 有写作 brief。
+- 有历史素材匹配表和复用级别。
+- 有章节初稿或改写稿。
+- 有待补资料和人工复核岗位。
+- 有审核门禁交接。
+- 有明确禁止结论和输出自检。
+
+## 停止条件
+
+遇到以下情况，应停止生成定稿式正文，只输出待补清单和复核建议：
+
+- 缺少招标文件原文、评分办法、技术要求或投标格式要求。
+- 缺少工程概况、图纸、计算书、设备资料或专家意见。
+- 用户要求输出中标概率、审批通过、计算正确、合规结论或法律意见。
+- 历史素材含大量旧项目事实且无法确认当前项目依据。
+
+## 发布前事实边界
+
+仓库级测试能验证资产、路由、模板和脱敏 run-pack；不能替代真实宿主输出评估。v1.4.0 正式发布前，必须归档 Codex 和 WorkBuddy 的真实 Skill 触发输出，并按写作型 scorecard 复核。