PHITE 任务执行与汇报标准 V1.0

标准版本：1.0。状态：已实施，是未来 PHITE 重大任务汇报的规范性默认标准。

目的与适用范围

本标准把 Owner 需要阅读的项目沟通与 Agent / 技术评审者需要阅读的执行证据分开。它适用于 PHITE EPC Operating System、Foundation、Handbook、Workflow Architecture、Design System、ERP / NocoBase，以及研究、架构、实施、验证等重大任务。

Owner 负责业务方向、产品决策、验收、优先级和重大架构决策。Owner 无需理解 repository 结构、developer log、schema、test command 或实现术语，也应能判断任务结果与下一步。

强制语言规则

Agent instructions、technical specifications、code、identifiers、schemas、filenames、commands、implementation details 与 technical evidence 可保留英文。

所有面向 Owner 的总结、进度、完成报告、阻塞说明、决策请求、风险说明和建议下一步必须使用简体中文。OS-DES-014、OD-COST-002、project_id、procurement_requests、work-registry.yaml、Astro、Starlight、NocoBase 等技术标识在翻译会降低精度时保持原样。

两层沟通契约

层级	读者	强制特征
OWNER SUMMARY	PHITE Owner	简体中文、简洁、业务可读、结果导向、决策导向
TECHNICAL REPORT	Agent 与技术评审者	按需提供实现、文件、schema、command、test、commit、log、architecture 与 evidence

Owner 忽略 TECHNICAL REPORT 后，仍必须能理解结果、剩余工作、主要风险、需要决定的事项和建议下一步。

强制最终报告模板

每个已完成或已准备评审的重大任务，其第一份可见最终报告必须以以下结构开头。一句话结果 约两到三句，建议下一步不超过三项。

# OWNER SUMMARY

任务结果：通过（PASS）

## 一句话结果

[这次到底做成了什么？]

## 现在能做什么

[从 Owner 或使用者视角说明现在已有的能力、可见性、流程或业务价值。]

## 已完成

- ✅ 已完成：[主要成果]
- 🟡 部分完成：[如适用]
- ⛔ 被阻塞：[如适用]
- ⚪ 尚未开始：[如适用]

## 预览环境

✅ 已部署到：
http://43.155.249.215:4321/
远程验证：通过
当前状态：等待 Owner Review

## 还差什么

[区分有意排除、尚未实现、被阻塞和尚未验证。]

## 风险 / 问题

目前没有发现需要 Owner 立即处理的重大风险。

## 需要 Owner 决定

无需 Owner 决定。

## 建议下一步

1. [做什么；为什么现在做；是否存在依赖。]

---

# TECHNICAL REPORT

## A. RESULT

[PASS / PARTIAL / FAIL / BLOCKED]

## B. IMPLEMENTED

[Technical implementation details.]

## C. ARCHITECTURE / CHANGES

[Architecture and change details.]

## D. FILES / COMPONENTS

[Relevant files and components.]

## E. VERIFICATION

[Checks and outcomes.]

## F. EVIDENCE

[Evidence and traceable references.]

## G. KNOWN GAPS

[Known limitations and exclusions.]

只使用能表达真实状态的标记。缺少要求的验证时，不得使用 ✅ 已完成。

结果词汇

Owner 结果	Technical result	含义
通过（PASS）	PASS	Expected Output、Acceptance Criteria、Required Evidence 与 Verification 均满足。
部分完成（PARTIAL）	PARTIAL	已有有用成果，但至少一项要求未完成或未验证。
未通过（FAIL）	FAIL	任务结果或验收标准未达到。
被阻塞（BLOCKED）	BLOCKED	缺少已明确的决策、依赖、授权、访问或外部状态变化，无法继续。

Owner Summary 内容规则

一句话结果

用直白中文说明达成了什么，报告 outcome，不报告 implementation activity。

现在能做什么

说明 Owner 或使用者现在获得的能力、可见性、流程或业务价值。优先使用“现在打开 Handbook，就可以直接看到……”而不是内部渲染或数据聚合描述。

已完成

只列主要成果，不列琐碎文件修改、内部函数名、package version 或原始 command output。

还差什么

明确区分有意排除、尚未实现、被阻塞和尚未验证。

风险 / 问题

用中文说明会影响决策或使用的风险。没有重大风险时写：目前没有发现需要 Owner 立即处理的重大风险。

需要 Owner 决定

本节必须存在。无需决定时写：无需 Owner 决定。

需要决定时，说明现在必须决定什么、原因、可选方案、Agent 建议以及不决定会继续阻塞什么。Agent 不得默默选择 Owner-dependent business rule。

建议下一步

最多建议三项；每项说明做什么、为什么现在做、是否存在依赖。除非当前任务明确授权，不得自动执行这些建议。

长任务进度报告

进度报告必须让 Owner 可直接阅读，并使用以下中文字段：

当前目标：
正在做什么：
已经完成：
还在处理：
是否被阻塞：
是否需要 Owner：
下一检查点：

只列技术活动不构成进度报告。

阻塞报告

阻塞报告必须解释业务问题，不能要求 Owner 先打开 Decision 文件：

⛔ 当前阻塞
[用简体中文说明业务问题。]

关联决策：
[Decision ID]

为什么会阻塞：
[说明为什么缺少该决定就不能继续。]

需要你决定：
[具体问题]

Agent 不会自行假设这个业务规则。

不得只报告 Blocked by OD-DES-004 等 identifier。

决策请求

需要 Owner input 时使用：

需要你决定：
问题：
[plain Chinese]
背景：
[why this matters]
方案 A：
[...]
方案 B：
[...]
方案 C：
[...]
Agent 建议：
[recommendation and reason]
影响：
[what becomes possible after the decision]

普通决策不得要求 Owner 先解读原始 architecture documents。

基于结果的完成规则

任务只有在以下四项全部满足时才算完成：

Expected Output
        +
Acceptance Criteria
        +
Required Evidence
        +
Verification

仅有代码、Markdown、文件、成功 build 或 Agent 正常返回都不充分。实现存在但验证缺失时，报告 🟡 部分完成 / 待验证，不得报告 ✅ 已完成。

Source of truth 边界

Multica 是 assignment、execution status、agent activity 与 execution history 的 execution console；它不是 PHITE Operating System project state 的 canonical source。

Handbook 与 repository 是 project and knowledge control console。Canonical project state 应逐步进入 Handbook Work Management Layer，并遵循：

PHITE HANDBOOK / REPOSITORY
        ↓
WORK ITEM
        ↓
MULTICA
        ↓
EXECUTION ACTOR
        ↓
RESULT + EVIDENCE
        ↓
WORK ITEM UPDATE
        ↓
HANDBOOK PROJECT STATE

Owner 应从 Handbook 了解当前位置、active work、gaps、blockers、pending decisions、verified outcomes 与 reasonable next work。Multica 保持为 execution management surface。

汇报克制

除非细节会实质影响决策，否则 package version、line count、command、逐文件 diff、内部 function name、minor warning、Git internals 与 raw test log 不进入 OWNER SUMMARY；有用的技术证据放入 TECHNICAL REPORT。

Handbook 持续预览部署

所有改变可见或功能性 Handbook 内容的任务必须使用一个固定 Owner Review 环境：http://43.155.249.215:4321/。该地址是 canonical Handbook Preview Environment，不自动等于 Production。

强制执行顺序为：

Implement
    ↓
Local Verification
    ↓
Persistent Commit / Checkpoint
    ↓
Preview Deployment
    ↓
Remote Verification
    ↓
Owner Review
    ↓
Done

Review 只表示本地验证通过、已提交 GitHub、已部署固定预览地址且 remote verification 通过，正在等待 Owner 检查。Done 只可在 Owner acceptance 后使用；deployment 不等于 Owner acceptance。

适用范围与不过度部署

Foundation、Work Management、Decision / Maturity UI、Workflow 文档、Handbook navigation、Design System、Astro / Starlight components、search、localization 与其他用户可见 Handbook 变更均适用。纯研究、ERP investigation、外部研究或不修改 canonical Handbook 的讨论不自动触发部署；一旦任务写入可见 Handbook，部署 gate 立即适用。

远程验证

成功 build 不是远程证据。至少验证：固定 URL 可达、首页与本次变更页面成功加载、navigation 正常、无明显 rendering failure、相关中文正确、受影响时 light/dark 正常、受影响时 mobile 无实质破坏。部署成功但远程验证失败时，结果只能是 PARTIAL 或 FAIL，状态保持 Review 或 Blocked，且不得报告 PASS。

跨节点、idempotent 与 fail-closed

部署配置和接管 runbook 必须保存在 repository。Mac、Seoul、Relay 或未来授权节点均应能从 persistent checkpoint 继续。部署必须 idempotent：同一 revision 重跑不得创建重复 service、重复实例或端口冲突。

部署必须 fail-closed。Required validation 失败时不得替换 last-known-good Preview；上传、配置或 remote verification 失败时保持或恢复上一已验证 release。任何 secret、private key 或 workstation-only credential path 不得进入 Git。

版本可见性与 Work Item evidence

Preview 必须通过 /deployment.json 暴露 exact Git revision、deployment time 与 environment: preview，且不干扰主 UI。Handbook Work Item 使用现有 Work Registry deployment 字段链接该 metadata endpoint，不复制会漂移的 runtime truth。

最终报告的 TECHNICAL REPORT 应记录实际值：

deployment:
  environment: preview
  url: http://43.155.249.215:4321/
  metadata_url: http://43.155.249.215:4321/deployment.json
  revision: <git commit from deployment.json>
  deployed_at: <timestamp from deployment.json>
  remote_verification: passed

每个 Handbook-changing task 的中文 OWNER SUMMARY 必须包含 ## 预览环境。失败时使用 ⛔，说明本次版本未成功部署、当前在线仍为上一已验证版本及原因，并明确 Owner 当前无需检查本次页面。

应用与历史

本标准默认适用于未来所有 PHITE 重大任务。Repository agent instructions 应链接到本页，不得复制完整规则。不得批量改写历史报告。

该规则立即适用于 PHI-42 Visual Skin、PHI-43 OS-DES-014 与后续 Handbook-changing tasks。不得仅为补写历史 deployment record 而批量重启无关的已完成任务。