From 40cdb9466d56caa7ffbb305c0f760a0fc096db61 Mon Sep 17 00:00:00 2001 From: Codex Date: Mon, 13 Jul 2026 11:01:42 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=94=B6=E6=95=9B=20PaC=20registry=20?= =?UTF-8?q?=E7=8A=B6=E6=80=81=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .agents/skills/unidesk-cicd/SKILL.md | 5 ++++- .agents/skills/unidesk-cicd/references/gitea-pac.md | 9 +++++++++ 2 files changed, 13 insertions(+), 1 deletion(-) diff --git a/.agents/skills/unidesk-cicd/SKILL.md b/.agents/skills/unidesk-cicd/SKILL.md index bd8812fe..a38bd660 100644 --- a/.agents/skills/unidesk-cicd/SKILL.md +++ b/.agents/skills/unidesk-cicd/SKILL.md @@ -40,7 +40,10 @@ bun scripts/cli.ts agentrun control-plane legacy-cicd --help bun scripts/cli.ts hwlab nodes control-plane legacy-cicd --help ``` -节点级只读状态必须优先用 `cicd status --node `。它从 `config/platform-infra/pipelines-as-code.yaml` 找到该 node 的所有当前 PaC consumer，一次性汇总 PipelineRun、Argo/GitOps、runtime readiness 和诊断；不要再靠阅读源码或手动拼三条 consumer 命令来回答 “NC01 的 CI/CD 流水线情况”。text 输出在零 consumer、ready、warning 与失败时均返回非空 typed 摘要和精确下钻命令；GitOps-only consumer 的 registry 显示 `N/A`，只有 owning YAML 为该 consumer 对应 pipeline 声明 image repository 时，registry missing 才是 blocker。`platform-infra pipelines-as-code status --target --consumer ` 只作为单 consumer drill-down。 +- 节点级只读状态： + - 优先用 `cicd status --node `； + - 单 consumer 再用 `platform-infra pipelines-as-code status --target --consumer ` 下钻； + - 状态输出与 registry applicability 的长期判定见 [references/gitea-pac.md](references/gitea-pac.md)。 - 新增 PaC consumer 的首次引导： - 先执行一次 `pipelines-as-code bootstrap --dry-run`； diff --git a/.agents/skills/unidesk-cicd/references/gitea-pac.md b/.agents/skills/unidesk-cicd/references/gitea-pac.md index 5c9488f8..1339e4a6 100644 --- a/.agents/skills/unidesk-cicd/references/gitea-pac.md +++ b/.agents/skills/unidesk-cicd/references/gitea-pac.md @@ -78,6 +78,15 @@ bun scripts/cli.ts platform-infra pipelines-as-code bootstrap --target -- - 只有归属或 TaskRun 断点不清楚时再用 `history --id` 或 `debug-step --id`； - 默认不使用 `--full` 或 `--raw`，避免把大对象带回本机； - consumer 声明 `sourceArtifact` 且需要精确提交验收时，最后执行一次 `source-artifact verify-runtime`。 +- node 状态摘要必须保持可读且可下钻： + - text 输出在零 consumer、ready、warning 与失败时都返回非空 typed 摘要； + - 摘要只给出与当前状态匹配的精确下钻命令； + - 不要求操作者阅读源码或手工拼接多个 consumer 命令。 +- registry applicability 只由 owning YAML 决定： + - consumer 对应 pipeline 声明 image repository 时，registry 状态适用； + - 适用的 registry 缺失是 blocker； + - GitOps-only consumer 未声明 image repository 时，registry 显示 `N/A`； + - 不得因 registry 不适用而把 GitOps-only consumer 判为失败。 ## PaC 源码侧制品同步