audit-container-iac

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

/audit-container-iac

/audit-container-iac

Audit the current working directory for the Container & IaC Security dimension.
Paths in this file are relative to this skill's own directory (the folder that contains this SKILL.md), not to the repository being audited. Run all detection commands in the repository being audited (the current working directory).
审计当前工作目录的容器与 IaC 安全维度。
本文件中的路径相对于此 skill 自身的目录(包含此 SKILL.md 的文件夹),而不是被审计的仓库。在被审计的仓库(当前工作目录)中运行所有检测命令。

Inputs

输入

  • Optional
    discovery_context
    (JSON) injected by the orchestrator.
  • Optional output path (from the orchestrator): write the JSON there instead of printing it.
  • Flags:
    --json
    (emit JSON only, no markdown summary).
  • 可选的
    discovery_context
    (JSON),由 orchestrator 注入。
  • 可选的输出路径(由 orchestrator 提供):将 JSON 写入该路径,而不是直接打印。
  • 标志:
    --json
    (仅输出 JSON,不附加 markdown 摘要)。

Steps

步骤

  1. Discovery: if
    discovery_context
    was NOT injected, follow
    references/discovery.md
    and build it. If injected, use it as-is (do not re-run discovery).
  2. Filter: read
    references/detection/10-container-iac.md
    . Drop any checklist item whose
    applies_to
    shares no archetype with
    discovery_context.archetypes
    → emit it with
    status: "skipped"
    .
  3. Detect (two-stage, spec §5a.2 / §9a.4): a. For each applicable item, run its
    signals
    (ripgrep) to get candidate
    file:line
    . Prefer external-tool output if available. Do NOT read the whole repo. b. Read only candidate snippets; apply each item's
    confirm
    rule. Assign severity honoring any severity floors. Consult
    references/detection/examples/10-container-iac.md
    only when a candidate is ambiguous.
  4. Emit: produce one
    AuditResult
    JSON object conforming to
    references/schema.json
    with
    audit: "container_iac"
    ,
    iso_characteristic: "Portability"
    , the checklist (with statuses), and findings. Leave
    score
    as
    0
    — the engine computes it.
    • If an output path was given: write ONLY the JSON object to it (UTF-8), then reply with one line:
      <audit key>: <n> findings -> <path>
      .
    • With
      --json
      or as a subagent without an output path: output ONLY the JSON.
    • Standalone: also print a short markdown summary (counts + top findings).
When invoked as a subagent, return only valid JSON — or, when an output path was given, only the one-line confirmation.
  1. 发现:如果未注入
    discovery_context
    ,则遵循
    references/discovery.md
    并构建它。如果已注入,则原样使用(不要重新运行发现过程)。
  2. 筛选:读取
    references/detection/10-container-iac.md
    。对于
    applies_to
    与
    discovery_context.archetypes
    不共享任何 archetype 的检查清单项,将其从适用项中移除 → 以
    status: "skipped"
    输出。
  3. 检测(两阶段,spec §5a.2 / §9a.4): a. 对每个适用项,运行其
    signals
    (ripgrep)以获取候选
    file:line
    。如果可以使用外部工具的输出,优先使用该输出。切勿读取整个仓库。 b. 仅读取候选代码片段;应用每个检查项的
    confirm
    规则。确定严重性时,遵循所有 severity 下限。仅当候选项存在歧义时,才查阅
    references/detection/examples/10-container-iac.md
    。
  4. 输出:生成一个符合
    references/schema.json
    的
    AuditResult
    JSON 对象,其中包含
    audit: "container_iac"
    、
    iso_characteristic: "Portability"
    、检查清单(包含各项状态)及 findings。将
    score
    保留为
    0
    ——由 engine 计算。
    • 如果提供了输出路径:将仅包含该 JSON 对象的文件以 UTF-8 写入该路径,然后回复一行:
      <audit key>: <n> findings -> <path>
      。
    • 使用
      --json
      或作为 subagent 且未提供输出路径时:仅输出 JSON。
    • 独立运行时:另打印一份简短的 markdown 摘要(计数 + 主要 findings)。
作为 subagent 调用时,仅返回有效的 JSON;如果提供了输出路径,则仅返回一行确认信息。