audit-observability
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chinese/audit-observability
/audit-observability
Audit the current working directory for the Observability 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).
审计当前工作目录的可观测性维度。
此文件中的路径相对于此 skill 自身的目录(即包含此 SKILL.md 的文件夹),而不是相对于被审计的仓库。所有检测命令都应在被审计的仓库(当前工作目录)中运行。
Inputs
输入
- Optional (JSON) injected by the orchestrator.
discovery_context - Optional output path (from the orchestrator): write the JSON there instead of printing it.
- Flags: (emit JSON only, no markdown summary).
--json
- 可选的 (JSON),由 orchestrator 注入。
discovery_context - 可选的输出路径(来自 orchestrator):将 JSON 写入该路径,而不是打印出来。
- 标志:(仅输出 JSON,不提供 markdown 摘要)。
--json
Steps
步骤
- Discovery: if was NOT injected, follow
discovery_contextand build it. If injected, use it as-is (do not re-run discovery).references/discovery.md - Filter: read . Drop any checklist item whose
references/detection/11-observability.mdshares no archetype withapplies_to→ emit it withdiscovery_context.archetypes.status: "skipped" - Detect (two-stage, spec §5a.2 / §9a.4):
a. For each applicable item, run its (ripgrep) to get candidate
signals. Prefer external-tool output if available. Do NOT read the whole repo. b. Read only candidate snippets; apply each item'sfile:linerule. Assign severity honoring any severity floors. Consultconfirmonly when a candidate is ambiguous.references/detection/examples/11-observability.md - Emit: produce one JSON object conforming to
AuditResultwithreferences/schema.json,audit: "observability", the checklist (with statuses), and findings. Leaveiso_characteristic: "Operability"asscore— the engine computes it.0- 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 or as a subagent without an output path: output ONLY the JSON.
--json - Standalone: also print a short markdown summary (counts + top findings).
- If an output path was given: write ONLY the JSON object to it (UTF-8), then reply
with one line:
When invoked as a subagent, return only valid JSON — or, when an output path was
given, only the one-line confirmation.
- 发现(Discovery):如果未注入 ,则遵循
discovery_context并构建它。如果已注入,则按原样使用(不要重新运行发现过程)。references/discovery.md - 筛选(Filter):读取 。如果某个检查项的
references/detection/11-observability.md与applies_to没有任何共同的 archetype,则将其丢弃 → 输出该检查项,并设置discovery_context.archetypes。status: "skipped" - 检测(Detect,两阶段,spec §5a.2 / §9a.4):
a. 对于每个适用的检查项,运行其 (ripgrep),以获取候选的
signals。如果可以获得外部工具的输出,则优先使用。不要读取整个仓库。 b. 仅阅读候选代码片段;应用每个检查项的file:line规则。在遵守任何严重性下限(severity floor)的前提下分配严重性。仅当候选项存在歧义时,才查阅confirm。references/detection/examples/11-observability.md - 输出(Emit):生成一个符合 的
references/schema.jsonJSON 对象,其中包含AuditResult、audit: "observability"、检查清单(包含各项状态)以及发现项。将iso_characteristic: "Operability"保留为score——分数由引擎计算。0- 如果提供了输出路径:将仅包含该 JSON 对象的文件以 UTF-8 写入该路径,然后回复一行:。
<audit key>: <n> findings -> <path> - 使用 ,或作为子 Agent 运行且未提供输出路径时:仅输出 JSON。
--json - 独立运行时:另外打印一份简短的 markdown 摘要(计数及主要发现项)。
- 如果提供了输出路径:将仅包含该 JSON 对象的文件以 UTF-8 写入该路径,然后回复一行:
作为子 Agent 调用时,仅返回有效的 JSON——如果提供了输出路径,则仅返回一行确认信息。