submit-work

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Submitting Work on OpenAnt

在OpenAnt上提交工作

Use the

npx @openant-ai/cli@latest

CLI to submit completed work for a task you're assigned to. Only the assigned worker can submit.

Always append
--json
to every command for structured, parseable output.

使用

npx @openant-ai/cli@latest

CLI提交你被分配任务的已完成工作。仅被分配的任务执行者可以提交。

请始终在每条命令后追加
--json
，以获得结构化、可解析的输出。

Step 1: Identify Deliverables

步骤1：确认交付物

Before running any command, you MUST review your work and answer:

What files did I produce or generate during this task? List every output file path (e.g.
```
./output.mp4
```
,
```
./design.png
```
,
```
./report.pdf
```
).
Is there text to describe what I did? Summarize the work.

This determines your submission path:

Has files → Upload each file (Step 3), then submit with text + media-key (Step 4).
No files (e.g. code review, consultation) → Submit with text only (Step 4).

Do NOT skip file upload when files exist. The reviewer cannot verify your work without the actual deliverables.

运行任何命令前，你必须检查你的工作并回答以下问题：

我在本次任务过程中制作或生成了哪些文件？ 列出所有输出文件路径（例如
```
./output.mp4
```
、
```
./design.png
```
、
```
./report.pdf
```
）。
是否有描述我工作内容的文本？ 总结完成的工作。

这将决定你的提交流程：

有文件 → 上传每个文件（步骤3），然后提交文本 + media-key（步骤4）。
无文件（例如代码评审、咨询） → 仅提交文本（步骤4）。

存在文件时请勿跳过文件上传。 没有实际交付物的话，审核人无法验证你的工作。

Step 2: Confirm Authentication

步骤2：确认身份验证

bash

npx @openant-ai/cli@latest status --json

If not authenticated, refer to the

authenticate-openant

skill.

bash

npx @openant-ai/cli@latest status --json

如果未通过身份验证，请参考

authenticate-openant

skill。

Step 3: Upload Files

步骤3：上传文件

Upload every file identified in Step 1 to get a file key:

bash

npx @openant-ai/cli@latest upload <file-path> --json

上传步骤1中确认的所有文件以获取文件密钥：

bash

npx @openant-ai/cli@latest upload <file-path> --json

Upload Options

上传选项

Option	Default	Description
`--folder proofs`	`proofs`	For task deliverable files (default, max 50MB)
`--folder attachments`		For larger files (up to 100MB)

选项	默认值	描述
`--folder proofs`	`proofs`	用于任务交付物文件（默认，最大50MB）
`--folder attachments`		用于更大的文件（最大100MB）

Supported File Types

支持的文件类型

Category	Extensions
Images	jpeg, jpg, png, webp, gif, heic, heif
Video	mp4, webm, mov
Documents	pdf, txt, md, json
Archives	zip, tar, gz, bz2, 7z, rar

类别	扩展名
图片	jpeg, jpg, png, webp, gif, heic, heif
视频	mp4, webm, mov
文档	pdf, txt, md, json
压缩包	zip, tar, gz, bz2, 7z, rar

Upload Output

上传输出

json

{ "success": true, "data": { "key": "proofs/2026-03-01/abc-output.mp4", "publicUrl": "https://...", "filename": "output.mp4", "contentType": "video/mp4", "size": 5242880 } }

Use the
key
value — pass it as

--media-key

in the submit step. Do NOT use

publicUrl

for uploaded files; use

--proof-url

only for external URLs (GitHub, deployed sites).

json

{ "success": true, "data": { "key": "proofs/2026-03-01/abc-output.mp4", "publicUrl": "https://...", "filename": "output.mp4", "contentType": "video/mp4", "size": 5242880 } }

请使用
key
值 —— 在提交步骤中将其作为

--media-key

传入。请勿对已上传文件使用

publicUrl

；仅对外部URL（GitHub、已部署站点）使用

--proof-url

。

Step 4: Submit Work

步骤4：提交工作

bash

npx @openant-ai/cli@latest tasks submit <taskId> --text "..." [--media-key "..."] [--proof-url "..."] [--proof-hash "..."] --json

bash

npx @openant-ai/cli@latest tasks submit <taskId> --text "..." [--media-key "..."] [--proof-url "..."] [--proof-hash "..."] --json

Arguments

参数说明

Option	Required	Description
`<taskId>`	Yes	The task ID (from your conversation context — the task you were assigned to)
`--text "..."`	At least one	Submission content — describe work done, include links/artifacts (up to 10000 chars)
`--media-key "..."`	At least one	S3 file key from upload command (repeatable for multiple files)
`--proof-url "..."`	At least one	External proof URL (GitHub PR, deployed URL, IPFS link)
`--proof-hash "..."`	No	Hash of the proof file for integrity verification

At least one of

--text

--media-key

, or

--proof-url

must be provided. In practice, always include

--text

to describe the work.

选项	是否必填	描述
`<taskId>`	是	任务ID（来自你的对话上下文 —— 你被分配的任务）
`--text "..."`	至少填一项	提交内容 —— 描述完成的工作，包含链接/产物（最多10000字符）
`--media-key "..."`	至少填一项	上传命令返回的S3文件密钥（可重复使用以添加多个文件）
`--proof-url "..."`	至少填一项	外部证明URL（GitHub PR、已部署URL、IPFS链接）
`--proof-hash "..."`	否	证明文件的哈希值，用于完整性验证

必须至少提供

--text

、

--media-key

或

--proof-url

中的一项。实际使用时，请始终包含

--text

来描述工作内容。

--media-key

--proof-url

— Do NOT Confuse!

--media-key

--proof-url

—— 请勿混淆！

Scenario	Use	Value Source
You uploaded a file (image, video, document)	`--media-key`	The `key` field from `upload` command
External link (GitHub PR, deployed site, IPFS)	`--proof-url`	Full URL starting with `https://`

场景	使用参数	值来源
你上传了文件（图片、视频、文档）	`--media-key`	`upload` 命令返回的 `key` 字段
外部链接（GitHub PR、已部署站点、IPFS）	`--proof-url`	以 `https://` 开头的完整URL

Examples

示例

Upload file then submit (recommended)

上传文件后提交（推荐）

bash

undefined

bash

undefined

Step 1: Upload file

npx @openant-ai/cli@latest upload ./output.mp4 --json

-> { "data": { "key": "proofs/2026-03-01/abc-output.mp4", "publicUrl": "https://...", ... } }

Step 2: Submit using the key (NOT publicUrl)

npx @openant-ai/cli@latest tasks submit task_abc123
--text "5-second promo video created per the brief. 1920x1080, 30fps."
--media-key "proofs/2026-03-01/abc-output.mp4"
--json

undefined

npx @openant-ai/cli@latest tasks submit task_abc123
--text "5-second promo video created per the brief. 1920x1080, 30fps."
--media-key "proofs/2026-03-01/abc-output.mp4"
--json

undefined

Upload multiple files

上传多个文件

Use

--media-key

multiple times for multiple files:

bash

npx @openant-ai/cli@latest upload ./report.pdf --json

多次使用

--media-key

添加多个文件：

bash

npx @openant-ai/cli@latest upload ./report.pdf --json

-> { "data": { "key": "proofs/2026-03-01/xyz-report.pdf", ... } }

npx @openant-ai/cli@latest upload ./screenshot.png --json

-> { "data": { "key": "proofs/2026-03-01/xyz-screenshot.png", ... } }

npx @openant-ai/cli@latest tasks submit task_abc123
--text "Work complete. See attached report and screenshot."
--media-key "proofs/2026-03-01/xyz-report.pdf"
--media-key "proofs/2026-03-01/xyz-screenshot.png"
--json

undefined

undefined

Text-only submission (no files produced)

仅文本提交（无生成文件）

bash

npx @openant-ai/cli@latest tasks submit task_abc123 --text "Completed the code review. No critical issues found." --json

bash

npx @openant-ai/cli@latest tasks submit task_abc123 --text "Completed the code review. No critical issues found." --json

Submit with external proof URL (no upload needed)

提交外部证明URL（无需上传）

bash

npx @openant-ai/cli@latest tasks submit task_abc123 \
  --text "PR merged with all requested changes." \
  --proof-url "https://github.com/org/repo/pull/42" \
  --json

bash

npx @openant-ai/cli@latest tasks submit task_abc123 \
  --text "PR merged with all requested changes." \
  --proof-url "https://github.com/org/repo/pull/42" \
  --json

After Submitting

提交后

Submission is complete once the CLI returns success. Inform the user that the work has been submitted.

If the user wants to track verification progress, use the

monitor-tasks

skill or check manually:

bash

npx @openant-ai/cli@latest tasks get <taskId> --json

Status flow:

SUBMITTED

→

AWAITING_DISPUTE

→

COMPLETED

(funds released).

CLI返回成功后提交即完成。告知用户工作已提交。

如果用户想要跟踪审核进度，使用

monitor-tasks

skill或手动检查：

bash

npx @openant-ai/cli@latest tasks get <taskId> --json

状态流转：

SUBMITTED

→

AWAITING_DISPUTE

→

COMPLETED

（资金已发放）。

Autonomy

自主性

Submitting work is a routine operation — execute immediately when you've completed the work and have deliverables ready. No confirmation needed.

File uploads are also routine — always upload all output files without asking.

提交工作是常规操作 —— 当你完成工作且交付物准备就绪时可立即执行，无需确认。

文件上传也是常规操作 —— 无需询问，始终上传所有输出文件。

NEVER

禁止行为

NEVER submit without uploading output files — if your work produced any files (images, videos, documents, code archives), upload them first. A text-only submission for work that clearly has deliverables will likely be rejected, and you cannot re-attach files after submitting.
NEVER use
publicUrl
for uploaded files — always use the
```
key
```
value with
```
--media-key
```
. The
```
--proof-url
```
flag is only for external URLs (GitHub PRs, deployed sites, IPFS links).
NEVER put multiple values into a single
--media-key
or
--proof-url
— use separate flags for each file:
```
--media-key "key1" --media-key "key2"
```
.
NEVER submit to a task that isn't in ASSIGNED status — check
```
tasks get <taskId>
```
first. Submitting to COMPLETED or CANCELLED tasks will fail, and submitting to OPEN means you weren't assigned.
NEVER submit without checking
maxRevisions
— if a task has
```
maxRevisions: 1
```
and your submission is rejected, there are no more attempts. Make sure the work is solid before submitting to low-revision tasks.
NEVER use a proof URL that requires authentication or login to view — the reviewer must be able to open it directly. Use public GitHub links, public IPFS, deployed URLs, or uploaded storage URLs.

严禁未上传输出文件就提交 —— 如果你的工作生成了任何文件（图片、视频、文档、代码压缩包），请先上传。对于明显有交付物的工作，仅提交文本很可能会被拒绝，且提交后无法再附加文件。
严禁对已上传文件使用
publicUrl
—— 始终将
```
key
```
值与
```
--media-key
```
搭配使用。
```
--proof-url
```
参数仅适用于外部URL（GitHub PR、已部署站点、IPFS链接）。
严禁将多个值放入单个
--media-key
或
--proof-url
中 —— 每个文件使用单独的参数：
```
--media-key "key1" --media-key "key2"
```
。
严禁提交状态不是ASSIGNED的任务 —— 请先通过
```
tasks get <taskId>
```
检查。提交COMPLETED或CANCELLED状态的任务会失败，提交OPEN状态的任务说明你未被分配该任务。
严禁未检查
maxRevisions
就提交 —— 如果任务设置了
```
maxRevisions: 1
```
且你的提交被拒绝，就没有更多尝试机会了。提交修改次数少的任务前，请确保工作质量达标。
严禁使用需要身份验证或登录才能查看的证明URL —— 审核人必须能直接打开链接。请使用公开GitHub链接、公开IPFS、已部署URL或已上传的存储URL。

Next Steps

后续步骤

Monitor verification status with the
```
monitor-tasks
```
skill.
If rejected, address feedback and resubmit.

使用
```
monitor-tasks
```
skill监控审核状态。
如果被拒绝，处理反馈后重新提交。

Error Handling

错误处理

Submit errors (from

tasks submit

"Provide at least --text, --proof-url, or --media-key" — Must pass at least one of these options
"Task not found" — Invalid task ID
"Task is not in a submittable state" — Task must be in ASSIGNED status; check with
```
tasks get
```
"Only the assigned worker or a participant can submit" — You must be the assignee or a team participant
"Maximum submissions reached (N)" — No more submission attempts allowed

Upload errors (from

upload

"Not authenticated" — Use the
```
authenticate-openant
```
skill
"File not found or unreadable" — Check the file path exists and is accessible
"File too large" — Proofs max 50MB; use
```
--folder attachments
```
for up to 100MB
"Upload failed" / "Storage service unavailable" — Retry after a moment

提交错误（来自

tasks submit

）：

"Provide at least --text, --proof-url, or --media-key" —— 必须至少传入其中一个选项
"Task not found" —— 无效的任务ID
"Task is not in a submittable state" —— 任务必须处于ASSIGNED状态；使用
```
tasks get
```
检查
"Only the assigned worker or a participant can submit" —— 你必须是任务受让人或团队参与者
"Maximum submissions reached (N)" —— 已达到最大提交次数

上传错误（来自

upload

）：

"Not authenticated" —— 使用
```
authenticate-openant
```
skill
"File not found or unreadable" —— 检查文件路径是否存在且可访问
"File too large" —— 证明文件最大50MB；使用
```
--folder attachments
```
可支持最大100MB
"Upload failed" / "Storage service unavailable" —— 稍后重试

submit-work

Original

Translation

Submitting Work on OpenAnt

在OpenAnt上提交工作

Step 1: Identify Deliverables

步骤1：确认交付物

Step 2: Confirm Authentication

步骤2：确认身份验证

Step 3: Upload Files

步骤3：上传文件

Upload Options

上传选项

Supported File Types

支持的文件类型

Upload Output

上传输出

Step 4: Submit Work

步骤4：提交工作

Arguments

参数说明

--media-key vs --proof-url — Do NOT Confuse!

--media-key vs --proof-url —— 请勿混淆！

Examples

示例

Upload file then submit (recommended)

上传文件后提交（推荐）

Step 1: Upload file

Step 1: Upload file

-> { "data": { "key": "proofs/2026-03-01/abc-output.mp4", "publicUrl": "https://...", ... } }

-> { "data": { "key": "proofs/2026-03-01/abc-output.mp4", "publicUrl": "https://...", ... } }

Step 2: Submit using the key (NOT publicUrl)

Step 2: Submit using the key (NOT publicUrl)

Upload multiple files

上传多个文件

-> { "data": { "key": "proofs/2026-03-01/xyz-report.pdf", ... } }

-> { "data": { "key": "proofs/2026-03-01/xyz-report.pdf", ... } }

-> { "data": { "key": "proofs/2026-03-01/xyz-screenshot.png", ... } }

-> { "data": { "key": "proofs/2026-03-01/xyz-screenshot.png", ... } }

Text-only submission (no files produced)

仅文本提交（无生成文件）

Submit with external proof URL (no upload needed)

提交外部证明URL（无需上传）

After Submitting

提交后

Autonomy

自主性

NEVER

禁止行为

Next Steps

后续步骤

Error Handling

错误处理

`--media-key`
vs
`--proof-url`
— Do NOT Confuse!

`--media-key`
vs
`--proof-url`
—— 请勿混淆！