harbor-bootstrap-and-claim

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Use this skill when the agent needs to connect to Harbor for the first time, restore an existing identity, or confirm that Harbor is reachable before using capabilities.

当Agent需要首次连接Harbor、恢复现有身份，或在使用功能前确认Harbor可访问时，使用本技能。

Rules

Use Harbor CLI or API only.
Never read Harbor's database directly.
Treat published capabilities as the only executable source of truth.
If Harbor returns a pending approval, report the approval step and wait.
After an approval is granted, rerun the same claim command so Harbor can auto-restore the approved agent session.

仅允许使用Harbor CLI或API。
严禁直接读取Harbor的数据库。
将已发布的功能视为唯一可执行的可信来源。
如果Harbor返回待审批状态，请上报审批步骤并等待。
审批通过后，重新运行相同的申领命令，以便Harbor可以自动恢复已审批的Agent会话。

Operator loop

If the target profile is not installed yet, run
```
bash scripts/install-profile.sh <api-url> --profile <profile>
```
from the Harbor repo.

Confirm or switch profiles with

harbor profile ls --plain

harbor profile current --plain

, and

harbor profile use <profile>

Check Harbor reachability with
```
harbor status --plain
```
.
If owner bootstrap has not happened yet for the selected profile, direct the operator to the Harbor dashboard to sign in and bootstrap owner access.

Claim or restore the agent with

harbor auth claim --display-name '<name>' --plain

If the claim returns
```
status=approval_required
```
, report
```
approval_id
```
and
```
approval_url
```
, wait for the owner to approve in the dashboard, then rerun
```
harbor auth claim --display-name '<name>' --plain
```
to auto-restore the approved agent.
After claim or restore succeeds, verify identity with
```
harbor auth whoami --plain
```
or
```
harbor auth whoami --json
```
.
Run
```
harbor ls --plain
```
and summarize available published capabilities using capability-first language.

harbor auth claim --plain

returns

status

agent_id

profile

owner

approval_id

, and

approval_url

harbor auth whoami --plain

returns

profile

owner_scope_id

owner

agent_id

, and

agent_name

See

references/claim-flow.md

如果目标配置文件尚未安装，请在Harbor代码仓库中运行
```
bash scripts/install-profile.sh <api-url> --profile <profile>
```
命令。

使用

harbor profile ls --plain

、

harbor profile current --plain

和

harbor profile use <profile>

命令确认或切换配置文件。

使用
```
harbor status --plain
```
命令检查Harbor的可访问性。
如果所选配置文件尚未完成所有者初始化，请引导操作员前往Harbor仪表盘登录并初始化所有者权限。

使用

harbor auth claim --display-name '<name>' --plain

命令申领或恢复Agent身份。

如果申领返回
```
status=approval_required
```
，请上报
```
approval_id
```
和
```
approval_url
```
，等待所有者在仪表盘中完成审批，之后重新运行
```
harbor auth claim --display-name '<name>' --plain
```
命令自动恢复已审批的Agent。
申领或恢复成功后，使用
```
harbor auth whoami --plain
```
或
```
harbor auth whoami --json
```
命令验证身份。
运行
```
harbor ls --plain
```
命令，以功能优先的表述方式总结可用的已发布功能。

harbor auth claim --plain

status

、

agent_id

、

profile

、

owner

、

approval_id

和

approval_url

字段。

harbor auth whoami --plain

profile

、

owner_scope_id

、

owner

、

agent_id

和

agent_name

字段。

请参考

references/claim-flow.md

文档。