huawu矿业项目评估原型：agent任务拆分与集成计划
版本：v1.1 / 待执行任务书
日期：2026年10月6日
依据：需求基线、SPEC、交互设计、架构与共享契约v1.1 ；新增Z.ai整合说明v1.1及Astra方案v2.0
状态：仅规划，未创建产品代码、未派发开发agent
v1.1修订说明：原章节仍定义首期模拟范围；末章补充后续Z.ai模型及专项训练设计。没有新增首期真实服务，也没有实施或验收后续能力。
1. 执行顺序与完成标准
共享契约与4个种子案例准备完成后，Agent A、B、C并行开发，集成负责人管理入口、样式和验收。并行不意味着所有工作都无依赖，先完成依赖再派发。
| 阶段 | 责任 | 开始条件 | 完成标准 |
|---|---|---|---|
| L0 契约与种子冻结 | 集成负责人 | 文档阶段结束并进入开发 | 目录、种子、公共导出名、状态、命令、算例、检查入口已建立；文档差异已处理 |
| L1 核心与页面并行 | A／B／C | L0完成 | 各自所有权内实现、按SPEC交付、定向检查通过、列明限制 |
| L2 集成 | 集成负责人 | 公共interfaces和视图可导入 | 全应用可运行，无重复公式、无项目串写，保存与报告链路完成 |
| L3 文档验收 | 集成负责人 | 集成检查通过 | T-01至T-18结果逐项有证据；未测项明确记录 |
| L4 业务演示回看 | 业务方与集成负责人 | 有可操作演示及验收报告 | 对流程与输出进行讨论；变更反馈关联文档和任务，不直接宣称真实投资有效 |
正式部署或公开分享不是开发任务的默认步骤。手机真机测试访问方式另行选择，网络暴露需按实际环境处理。
2. 所有agent共用的工作规则
- 开始时读取功能SPEC中本人涉及章节、架构的字段和interfaces及对应任务书；以独立算例锁定预期，不以自己的输出改预期。
- 只修改分配文件。大家共享工作区，不是独自在代码库工作；保留他人改动，适配共享契约。发现无关变化先核实，不覆盖或回退。
- 依赖变更通过集成负责人统一处理。需要改公共导出、命令、种子、全局样式或新增依赖时，提交变更理由和调用方影响，不自行修改。
- 采用标准库和平台能力。只有与首期功能直接相关的实现；正式AI、后台、销售、审批和生产地学分析不纳入任务。
- 完成后交付改动文件、已执行检查及结果、未覆盖事项、所需集成动作。不能以截图或“可以运行”代替固定用例检查。
字段和公式的权威来源是架构与SPEC；本任务书只指向它们，不另建一套规则。
3. L0：集成负责人先行任务
J-00 共享基础
所有权：prototype/index.html、app.js、styles.css、data/seed.js、package.json（仅type=module及本地检查脚本，无应用依赖）、README.md，以及需要时的ui.js。
步骤：
- 按架构建立计划目录，采用同源静态访问，固定路由和context结构。
- 依据SPEC第4节生成4个种子聚合，模拟资料完整、页码与引用实际存在；每个项目满足文档、证据、风险和行动数量要求。
- 将4个基准、延期、重建和失败的预期结果列为测试数据，参考独立手算，禁止从未验证实现反推。
- 提供页面挂载位置、导航、全局保存状态和基础样式；共享函数若确有复用，确定其导出与单一所有权。
- 记录准确字段、命令payload、接口导出及版本；将任务状态改为可派发。
完成标准：A可以独立导入种子开展计算检查，B/C可依据context编写页面，所有引用归属明确，无相互矛盾的字段名。
L0可只有契约与静态骨架，业务能力由后续任务实现，不能把骨架标为原型已完成。
4. Agent A：计算、领域状态与保存
J-01 范围与所有权
拥有prototype/core/finance.js、core/domain.js、core/storage.js、tests/core.test.mjs。负责所有公共金额计算、命令规则、版本及本地保存行为。
必读：SPEC第3、4、6—9、11—12节；架构第3、5—9节；验收计划的核心及保存用例。
J-02 有序工作
- 实现统一计算和输入验证，先通过4个基准及铜／金单位算例。
- 实现领域命令、项目隔离、证据更正、任务依赖和费用唯一关联。
- 实现造假重评分支所需状态变化与费用计入，输出固定新方案结果。
- 实现报告快照与revision关系，旧输入／旧结果不被原地修改。
- 实现读取、校验、保存、损坏保护和标签页冲突辅助，返回可读状态，不接管界面提示。
- 在Node原生assert检查中覆盖金额、null、无效比例、任务依赖、历史快照、重置及存储失败。
完成标准：公共导出与架构一致；T-05、T-09、T-10、T-11的核心算例通过；T-03、T-08、T-15至T-17的领域及存储行为有可运行检查。集成浏览器检查由负责人最终执行。
J-03 交付与约束
交付函数与错误码清单、检查结果、浏览器集成需注册的storage事件说明。UI、种子和styles.css归其他负责人，不在本任务修改。计算只返回结果，不能写DOM、localStorage或项目推荐。
5. Agent B：项目、证据与尽调增值页面
J-04 范围与所有权
拥有prototype/views/projects.js与views/diligence.js。覆盖项目池、总览、资料、风险、增值行动及造假重建引导。
必读：SPEC第4—7节、S-15项目选择规则、第13节；设计D-01—D-11、D-16—D-20；架构页面context与命令。
J-05 有序工作
- 实现项目池筛选、2—4项目选择和总览，未知不标低风险，不作综合排名。
- 实现模拟资料目录、按页阅读与引用定位，证据修正及模拟核验表单。
- 实现风险专业意见、依据、残余问题和阻断建议，不添加审批动作。
- 实现四类任务、费用显示、成果核验与依赖提示；状态变化通过dispatch提交。
- 实现SJ-B造假重建分步界面，保留原记录、展示新成本和新方案，使用共同命令，不自行改经济公式。
- 按设计提供电脑和手机布局、空状态与错误提示；向负责人提交CSS类名和样式需求。
完成标准：T-01、T-02、T-04的页面操作有完整入口与反馈；T-03、T-08、T-09的专业操作链可通过公共命令驱动；证据引用可定位，没有“核验即批准”，360px宽基本路径完整。
J-06 交付与约束
交付路由支持清单、操作到命令映射、页面类名和运行限制。styles.css、app.js、core和seed归其他负责人；不得直接写本地存储或用独立变量保存第二份项目状态。
6. Agent C：估值、比较与报告页面
J-07 范围与所有权
拥有prototype/views/economics.js与views/reports.js。负责退出输入、开发参照、跨项目比较、报告版本与自包含HTML导出。
必读：SPEC第8—11、13节；设计D-06、D-12—D-20；架构计算结果、页面context、命令及报告契约。
J-08 有序工作
- 实现矿业权和股权的输入分区、币种单位、字段错误与缺项状态。
- 用统一计算模块展示现金流、收益、倍数、时间及可选NPV；无IRR伪值或权威报价上限。
- 实现6情景及自定义修改，关键输入有来源和覆盖说明。
- 待建开发参照独立展示，不把NPV写入退出价；勘探项目显示不适用。
- 实现2—4项目对比，突出不同口径、待定与不适用，修改单项目只反映该项目变化。
- 实现版本阅读、差异和HTML导出；报告中嵌入所引用的模拟原文，所有用户文本转义，脱离工作台仍可定位。
完成标准：T-05、T-06、T-10至T-13有完整页面；金额与core结果一致；旧快照导出不重算；长表手机可读；不显示投资批准。
J-09 交付与约束
交付报告字段清单、导出HTML示例、类名及浏览器差异说明。计算、存储、种子、全局入口和styles.css归其他负责人，不自行补另一个计算引擎或CSV替代HTML报告。
7. 集成负责人：连接、样式和验收
J-10 集成顺序
- 校验所有模块导出及context，先让4个案例可打开。
- 接入唯一dispatch：核心更新 → 结果更新 → 保存 → 提示与页面渲染。
- 接入路由、证据阅读、报告导出及比较选择，不遗留重复监听。
- 统一中文文案、颜色、桌面／手机布局、打印及焦点行为。
- 校验保存失败、损坏数据、多标签页冲突、无效草稿和重置，确保失败时数据可保留。
- 执行Node及浏览器检查，记录具体环境；真机缺失列为未验证，不伪造完成。
- 生成HTML验收记录与可访问演示说明，注明模拟能力和本地保存限制。
J-11 集成所有权
拥有入口、全局样式、种子、启动说明、浏览器检查和交付文档。集成前agent-owned文件有未完成改动时先协调；不要同时直接修改正在由该agent编辑的文件。
若测试指出核心错误，回交A；页面错误回交B/C；契约变化由负责人发布版本并通知所有调用方。修复后只重跑受影响及必要全链路检查，避免重复无关检查。
8. 依赖与并行计划
| 任务 | 依赖 | 可并行内容 |
|---|---|---|
| J-00 | 文档进入开发阶段 | 无，先行 |
| J-01—03 | J-00字段与种子冻结 | 与B/C页面可并行 |
| J-04—06 | J-00 context与命令冻结 | 页面结构、表单和资料展示不依赖核心完成 |
| J-07—09 | J-00数据和计算interface冻结 | 估值页面、报告模板与比较布局可先编写 |
| J-10—11 | 公共核心及页面可用 | 顺序集成，避免多人改入口 |
页面agent在核心尚未完成时可编写代码与静态视图，不向产品目录添加另一套临时核心函数。需要局部自查时用临时测试数据，经负责人确认后删除，不能将mock计算当成最终实现。
9. 可直接派发的任务摘要
以下为开发阶段使用的任务文本，本轮尚未发送。
Agent A任务
你负责core/finance.js、core/domain.js、core/storage.js和tests/core.test.mjs。按架构契约与SPEC实现统一计算、状态命令、快照和本地保存，执行固定算例与规则检查。你不是独自在代码库中工作；保留他人的改动，只修改归属文件，共享契约和种子变更先交集成负责人。完成后报告文件、已执行检查、接口限制及集成动作。
Agent B任务
你负责views/projects.js和views/diligence.js。实现项目池、总览、模拟资料阅读、核验、风险、增值及造假重建页面，所有业务变化通过公共dispatch。你不是独自在代码库中工作；保留他人改动，不修改core、入口、种子或全局样式。完成后提交操作映射、类名、检查结果与未覆盖事项。
Agent C任务
你负责views/economics.js和views/reports.js。实现退出估值、独立开发参照、跨项目比较、报告历史及HTML导出，统一复用finance结果。你不是独自在代码库中工作；保留他人改动，不另写公式或本地存储，不修改core、入口、种子或全局样式。完成后提交报告示例、检查结果及集成限制。
10. 任务状态与输出约定
任务状态为待派发、进行中、待集成、检查未通过、已验收。当前所有开发任务为待派发，架构文档与任务书完成不等于编码完成。
每项完成报告含：任务ID、归属文件、实现条目、执行的检查、结果、未验证项、所需集成动作。只有有执行记录的检查可以标通过。
文档变更、契约补丁及用例变化关联任务，不用口头描述取代可追溯依据。最终以验收计划记录实际状态。
11. v1.1：真实模型与专项训练的后续任务
本节为待执行的后续任务，现有J-00至J-11首期任务不增加真实模型依赖。本次只编写设计，不派发开发agent。所有worker不独占工作区，不撤销他人修改；文件所有权和共享契约变更先同步。
| 任务 | 所有权/交付 | 依赖与完成条件 |
|---|---|---|
| J-AI-00 集成负责人 | 冻结契约、资料授权/环境配置、ModelRelease台账和接入测试；维护入口和共享规范 | 用户进入真实试点后执行；确定部署路径、密钥处理、版本和负载 |
| J-AI-01 Agent A | 后续资料原件、解析、项目过滤检索及SourceRef；不修改finance或页面 | J-AI-00；原件可定位、跨项目隔离及失败范围检查AT-01/03/09 |
| J-AI-02 Agent B | 后续模型任务Module、所选路径Adapter、草稿结构校验、运行与错误处理 | J-AI-00可先用固定证据包并行；J-AI-01完成后联调；AT-02/04/05/12/13 |
| J-AI-03 Agent C | 原件/草稿复核、任务建议、报告与运行信息页面；调用既有领域/finance接口 | 契约冻结后先用明确标注的假任务联调，不宣称真实AI；AT-06/07/08/11 |
| J-AI-04 训练负责人 | 获授权纠错样本、隔离清单、基线评测、一个专项训练任务与产物加载 | 无训练基线与六门槛先通过；优先复用空闲Agent A/B，避免超过4席；AT-09/10/11/14 |
后续实际目录和文件名在J-AI-00依所选环境冻结；上述所有权先按职责划分，不提前搭空后台或依赖。共享finance与领域命令由集成负责人维护；各worker提交必要契约变更，不另建计算副本。
并行顺序：J-AI-00 → J-AI-01/02/03最多三人并行 → 集成与无训练评测 → 判断是否需要J-AI-04 → 产物加载与有限使用验收。专家标注由矿业、采选和法务人员承担；agent不能自行认证标签真实性。
每项交付附版本、来源、执行过的检查、失败项和未完成限制；AT测试记录不写“计划运行”当作通过。API路径无法加载专项权重时，J-AI-04不得交付一个名称别名冒充接入完成。