@archsight/aios 1.3.1 → 1.4.0

package/vision/v1.4.0-engineering-document-workflow.md

@@ -0,0 +1,205 @@
+# v1.4.0 工程文档生成、改写与复核闭环
+
+## 版本定位
+
+v1.4.0 的主线是把 AIOS 从“审核型 Skill”升级为“工程文档生成、改写与复核闭环”。
+
+这不是替换 v1.3.x 已有能力，而是在现有招投标、专项施工方案等审核型 Skill 之上增加写作型能力：
+
+- v1.3.x：读资料 -> 抽取问题 -> 输出矩阵 / 清单 / 台账 -> 人工复核。
+- v1.4.0：读资料 / 历史素材 -> 生成或改写初稿 -> 响应性检查 -> 风险复核 -> 人工定稿。
+
+现有审核型 Skill 继续作为质量门禁；新增写作型 Skill 负责初稿生成、历史素材复用和章节优化。
+
+## 目标用户与场景
+
+优先服务施工企业、咨询团队和工程资料团队的两类高频写作场景：
+
+1. 标书编写与优化：用户提供招标文件、评分办法、企业历史标书素材、类似项目案例或技术标初稿，AIOS 辅助生成目录、响应矩阵、章节初稿和优化建议。
+2. 专项施工方案编写与优化：用户提供方案初稿、历史方案素材、工程概况、专家意见或用户指定模板，AIOS 辅助生成或改写方案章节、工艺流程、危险源控制措施和交底要点。
+
+本版本不承诺替代投标负责人、技术负责人、总工、专家、法务、造价或审批主体。
+
+## 工作母版
+
+Markdown 是 v1.4.0 的 AIOS 工作母版；Word、PDF、PPT 是交付格式，不是主要编辑格式。
+
+推荐文档链路：
+
+```text
+原始资料
+-> source-normalized.md
+-> material-index.md
+-> writing-brief.md
+-> draft.md
+-> review-notes.md
+-> final.md
+```
+
+各文件职责：
+
+| 文件 | 作用 |
+|---|---|
+| `source-normalized.md` | 把招标文件、方案初稿、历史素材、专家意见等归一化为 Markdown。 |
+| `material-index.md` | 建立历史素材索引，区分可复用、仅参考、不可套用和需核验内容。 |
+| `writing-brief.md` | 记录本次写作目标、输出格式、资料边界、人工复核人和禁止承诺。 |
+| `draft.md` | AI 生成或改写的章节初稿，保留来源标记和待补占位。 |
+| `review-notes.md` | 由审核型 Skill 输出响应性、证据链、风险、缺口和人工复核意见。 |
+| `final.md` | 人工定稿前的 Markdown 版本，用于导出 Word / PDF / PPT。 |
+
+## 新增 Skill 分层
+
+### `aios-tender-write`
+
+用途：工程标书、技术标和评分点响应材料的生成与优化。
+
+输入：
+
+- 招标文件、评分办法、答疑澄清和技术标准。
+- 企业历史标书素材、业绩材料、人员证书、设备材料和类似项目案例。
+- 用户提供的技术标初稿、目录或章节片段。
+- 本次写作要求、章节模板和提交格式。
+
+输出：
+
+- 技术标目录建议。
+- 评分点逐项响应矩阵。
+- 章节初稿或改写稿。
+- 历史素材匹配表。
+- 缺资料清单和人工复核清单。
+
+边界：
+
+- 不编造企业资质、业绩、人员证书、设备、奖项、工期、金额或承诺。
+- 不输出中标概率、评标结论、最终投标决策或规避监管建议。
+- 缺少招标依据、企业证据或澄清版本时标为 `需补充资料` 或 `需人工复核`。
+
+审核门禁：
+
+- 生成后必须交给 `aios-commercial-tender` 做响应性、废标风险、评分点和资料缺口复核。
+
+### `aios-scheme-write`
+
+用途：专项施工方案、施工技术措施和交底材料的生成与优化。
+
+输入：
+
+- 方案初稿、工程概况、施工工艺、图纸说明、专家意见和审批意见。
+- 历史专项方案、企业工法、标准化章节和用户指定模板。
+- 本次项目条件、危险性较大分部分项工程属性和地方要求。
+
+输出：
+
+- 方案章节结构。
+- 章节初稿或改写稿。
+- 工艺流程和质量安全控制点。
+- 危险源与控制措施表。
+- 专家意见回查表、计算书缺口和交底要点。
+
+边界：
+
+- 不输出“方案合格 / 不合格 / 已通过审查”。
+- 不替代总工、专家论证、危大工程审批、结构计算或安全验收。
+- 不用 LLM 口算承载力、稳定、变形、荷载、设备能力或安全系数。
+- 计算和规范结论缺少项目计算书、确定性工具或正式依据时标为 `需核验`。
+
+审核门禁：
+
+- 生成后必须交给 `aios-construction-scheme` 做危险源、规范 / 计算书、专家复核和交底要点复核。
+
+## 素材复用工作流
+
+写作型 Skill 必须先做素材治理，再生成正文：
+
+1. 建立素材清单：记录历史方案 / 标书来源、项目类型、专业、章节、日期、适用条件和脱敏状态。
+2. 做复用判断：把素材分为 `可复用改写`、`仅参考`、`不可套用`、`需人工确认`。
+3. 建立写作 brief：确认本次工程事实、招标要求、输出用途、格式、外发边界和人工复核岗位。
+4. 生成或改写初稿：使用 Markdown，保留来源标记和待补占位，不把历史项目事实写成本项目事实。
+5. 执行审核门禁：用现有审核型 Skill 检查响应性、证据链、越权结论、缺资料和人工复核事项。
+6. 人工定稿：由投标负责人、技术负责人、总工、法务、造价或资料负责人确认后导出交付格式。
+
+## P0 / P1 / P2 开发路径
+
+当前已落地的基础件：
+
+- `aios-tender-write` 和 `aios-scheme-write` 写作型 Skill。
+- `templates/document-writing/` Markdown 工作母版。
+- `archsight-aios writing:init` 写作工作台初始化命令。
+- `engineering-document-writing-fixtures.json` 写作型脱敏 fixture 和 weak/basic run-pack 校验入口。
+
+仍需在发布前补齐：真实宿主触发证据、试点样本归档和跨宿主输出质量复核。
+
+### P0：写作闭环规格和评测门禁
+
+范围：
+
+- 新增工程文档写作工作流规格。
+- 定义 Markdown 工作母版文件链。
+- 定义 `aios-tender-write` 和 `aios-scheme-write` 的输入、输出、边界和审核门禁。
+- 扩展评测 fixtures，使其覆盖“初稿 + 历史素材 + 写作 brief + 审核门禁”。
+- 通过 `validate:document-writing-run-pack` 固化写作型 weak/basic 对照输入。
+
+验收：
+
+- 规划文档说明写作型 Skill 与审核型 Skill 不冲突。
+- 每个写作场景都有至少 1 个脱敏 fixture。
+- 评测能检查禁止编造资质、业绩、人员、工期、金额、方案合格和结构安全结论。
+
+### P1：新增写作型 Skill 基础版
+
+范围：
+
+- 新增 `aios-tender-write`。
+- 新增 `aios-scheme-write`。
+- 为两类 Skill 增加 `agents/openai.yaml`。
+- 更新 `skills/README.md`、`runtime/archsight-aios.manifest.json` 和路由说明。
+- 补充 basic prompt 和公开脱敏样例。
+
+验收：
+
+- `npm run validate:skills` 通过。
+- `npm run validate:prompts` 通过。
+- 生成型输出必须包含素材来源、复用判断、待补占位、人工复核岗位和审核门禁说明。
+
+### P1：Markdown 文档工作区模板
+
+范围：
+
+- 新增写作项目目录模板，例如 `templates/document-writing/`。
+- 新增 `archsight-aios writing:init`，把模板非覆盖式落到业务项目工作台。
+- 提供 `source-normalized.md`、`material-index.md`、`writing-brief.md`、`draft.md`、`review-notes.md`、`final.md` 的字段模板。
+- 说明如何从 Word / PDF / Excel / 历史素材归一化到 Markdown。
+
+验收：
+
+- 模板能支持标书和方案两类场景。
+- 每个模板文件都包含资料来源、适用条件、复用边界和人工复核字段。
+- 不把交付格式误当作编辑母版。
+
+### P2：真实宿主与试点证据
+
+范围：
+
+- 建立 `skill-runtime` 运行结果归档规范。
+- 至少覆盖 Codex 和 WorkBuddy 两个宿主。
+- 对同一脱敏输入保存原始输出全文，再做 scorecard 分析。
+
+验收：
+
+- 每个写作 Skill 至少有 1 组真实宿主触发输出。
+- 输出能通过结构完整度、证据追溯、边界安全、可执行性和人工复核分流检查。
+- 结论只写到当前样本和当前宿主版本，不上升为长期模型优劣判断。
+
+## 禁止事项
+
+- 不把历史方案或历史标书中的旧项目名称、地点、参数、工期、金额、业绩和人员自动套入新项目。
+- 不在缺少招标文件、评分办法、工程概况、图纸或计算书时假装已完成专业编写。
+- 不输出最终投标决策、方案审批结论、结构安全结论、合规结论、法律意见或结算金额。
+- 不把 AI 生成稿直接作为正式交付件；必须保留人工定稿环节。
+- 不以新增写作型 Skill 为由削弱现有审核型 Skill 的证据链和人工复核要求。
+
+## 下一实施小步
+
+进入 P2 前，先选择 1 个标书写作样本和 1 个方案写作样本做真实宿主验证：同一脱敏输入分别在 Codex 和 WorkBuddy 触发写作型 Skill，归档原始输出全文，再交给对应审核型 Skill 做门禁复核。
+
+这一步优先，因为当前仓库验证已经能证明资产、路由、模板和脱敏 run-pack 可用；下一阶段需要证明真实宿主能稳定触发正确 Skill，并输出可被工程人员复核的 Markdown 工作母版。