security-audit

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Security Audit

Security Audit

このSkillは、既知advisoryを継続管理する
security-maintenance
とは別に、project sourceから未知の脆弱性を探索・検証するapplication security audit を定義する。
目的は「怪しいコードを列挙する」ことではない。principal、trust boundary、entry surface、security invariant、sink/resultをsourceから追跡し、監査coverageを残し、候補をfresh verifierが反証したうえでのみfindingとして確定する。
本 Skill 与持续管理已知 advisory 的
security-maintenance
分开,定义了从 project source 中探索并验证未知漏洞的 application security audit。
目标不是“列出可疑代码”。而是从 source 中追踪 principal、trust boundary、entry surface、security invariant 以及 sink/result,保留审计 coverage,并且只有在 fresh verifier 反证候选后,才将其确定为 finding。

1. Responsibility boundary

1. Responsibility boundary

このSkillが所有する:
  • source-visible architecture / principal / trust boundaryのreconnaissance
  • entry surfaceからsecurity-relevant sinkまでのtrace
  • projectに適用可能なattack class選定
  • coverage unitの計画・実行・gap管理
  • vulnerability candidateの発見
  • bounded local evidenceによる候補検証
  • hunterと独立したfresh verifierによる反証
  • structured findings / needs-validation / rejected record
  • remediation invariantと最小修正方針の提示
  • confirmed findingのproject delivery workflowへのhandoff
このSkillが所有しない:
  • framework/runtime/dependency advisory intake と継続monitoring
  • target sourceの修正そのもの
  • release priorityの最終決定
  • live/shared/production environmentへの攻撃的probe
  • provider / deployment factの推測
  • security/privacy risk acceptance
接続先:
  • advisory起点のsecurity work ->
    security-maintenance
  • agent/runtime isolation ->
    sandbox-runtime
  • hunter/verifier orchestration ->
    parallel-orchestration
  • invariant / precondition / postcondition reasoning ->
    correctness-assurance
  • remediation後のregression / integration / E2E ->
    quality-gate
  • Issue / branch / PR / target release ->
    github-delivery
  • risk acceptance / irreversible decision ->
    engineering-decisions
本 Skill 负责:
  • 对 source-visible 的安全架构、principal 和 trust boundary 进行 reconnaissance
  • 追踪从 entry surface 到 security-relevant sink 的路径
  • 选定适用于 project 的 attack class
  • 规划、执行 coverage unit 并管理 gap
  • 发现 vulnerability candidate
  • 使用 bounded local evidence 验证候选
  • 由独立于 hunter 的 fresh verifier 对候选进行反证
  • 生成 structured findings、needs-validation 和 rejected record
  • 提出 remediation invariant 和最小修复方案
  • 将 confirmed finding 移交给 project delivery workflow
本 Skill 不负责:
  • 接收 framework/runtime/dependency advisory 并进行持续监控
  • 直接修复 target source
  • 最终决定 release priority
  • 对 live/shared/production environment 发起攻击性 probe
  • 推测 provider 或 deployment fact
  • 接受 security/privacy risk
连接关系:
  • 以 advisory 为起点的 security work ->
    security-maintenance
  • agent/runtime isolation ->
    sandbox-runtime
  • hunter/verifier orchestration ->
    parallel-orchestration
  • invariant / precondition / postcondition reasoning ->
    correctness-assurance
  • remediation 后的 regression / integration / E2E ->
    quality-gate
  • Issue / branch / PR / target release ->
    github-delivery
  • risk acceptance / irreversible decision ->
    engineering-decisions

2. Audit invariants

2. Audit invariants

監査中は次を破らない。
  1. findingには具体的なlower-trust principalまたはuntrusted inputが必要。
  2. findingには守るべきsecurity invariantと、破られたboundary/resultが必要。
  3. best practice不足だけをvulnerabilityとして扱わない。
  4. sourceで確認できないdeployment/provider/browser/IAM/runtime factを推測しない。
  5. source外factが決定的なら
    needs_validation
    とする。
  6. self-impactや同一principalに許可されたauthorityをcross-boundary vulnerabilityへ膨らませない。
  7. severityはconfirmed findingだけに付ける。
  8. observed resultより強いimpactを推測しない。
  9. target-controlled executionはapproved sandboxの内部だけで行う。
  10. production/shared endpoint、他user data、real credential、paid API、live control planeをprobeしない。
  11. audit自身はtarget sourceを変更しない。finding確定後にdelivery workflowへhandoffする。
  12. audit coverageが部分的ならcomplete auditと表現しない。
审计期间不得违反以下规则。
  1. 每个 finding 都必须涉及具体的 lower-trust principal 或 untrusted input。
  2. 每个 finding 都必须包含需要保护的 security invariant,以及被突破的 boundary/result。
  3. 不能仅将 best practice 不足视为 vulnerability。
  4. 不能推测无法从 source 中确认的 deployment/provider/browser/IAM/runtime fact。
  5. 如果 source 外 fact 起决定性作用,则将其标记为
    needs_validation
    。
  6. 不能将 self-impact 或同一 principal 被允许的 authority 夸大或膨胀为 cross-boundary vulnerability。
  7. 仅为 confirmed finding 设置 severity。
  8. 不能推测强于 observed result 的 impact。
  9. target-controlled execution 只能在 approved sandbox 内部执行。
  10. 不能 probe production/shared endpoint、其他用户数据、真实 credential、付费 API 或 live control plane。
  11. 审计本身不得修改 target source;应在确定 finding 后移交给 delivery workflow。
  12. 如果 audit coverage 不完整,不得将其描述为 complete audit。

3. Audit profiles

3. Audit profiles

scopeとstakesに応じてprofileを明示する。
应根据 scope 和 stakes 明确选择 profile。

quick

quick

小規模target、再監査、diff audit、初回screening向け。
  • coarse coverage unit
  • 1 hunting wave
  • 1 independent verifier per candidate
  • uncovered / deferred areaを明示
  • complete coverageを主張しない
适用于小型 target、重新审计、diff audit 和初步 screening。
  • 使用较粗粒度的 coverage unit
  • 1 个 hunting wave
  • 每个 candidate 配置 1 个 independent verifier
  • 明确标注 uncovered / deferred area
  • 不主张 complete coverage

standard

standard

通常のrepository audit。
  • subsystem / boundary単位のcoverage
  • reconnaissance
  • coverage-led hunting
  • gap review
  • independent candidate verification
  • structured reporting
适用于常规 repository audit。
  • 以 subsystem / boundary 为单位进行 coverage
  • reconnaissance
  • coverage-led hunting
  • gap review
  • 独立的 candidate verification
  • structured reporting

deep

deep

高stakes、大規模、security-sensitive target向け。
  • subsystem / lifecycle modeまでcoverageを分割
  • gap reviewをcleanになるまで反復
  • candidate validationとfinal record verificationを別agentへ分離
  • prior covered areaもsource変更やriskに応じて再検証
profileはevidence barを弱めるために使わない。
适用于高 stakes、大规模且 security-sensitive 的 target。
  • 将 coverage 拆分至 subsystem / lifecycle mode 粒度
  • 重复进行 gap review,直至达到 clean 状态
  • 将 candidate validation 与 final record verification 分离给不同 agent
  • 根据 source 变更或风险,对先前 covered area 重新验证
不得使用 profile 来降低 evidence bar。

4. Phase 1 — Reconnaissance

4. Phase 1 — Reconnaissance

実装を探す前にsecurity architectureを作る。
最低限確認:
在寻找实现之前,先建立 security architecture。
至少需要确认:

Product / stack

Product / stack

  • product type / users / operators
  • language / framework / runtime / SDK
  • deploy / package / execution model
  • subsystem / process boundary
  • persistence / queue / cache / filesystem / network
  • locally runnable test/build path
  • 产品类型 / 用户 / 操作者
  • 语言 / framework / runtime / SDK
  • 部署 / 打包 / 执行模型
  • subsystem / process boundary
  • 持久化 / 队列 / 缓存 / 文件系统 / 网络
  • 可在本地运行的 test/build 路径

Principal / authority

Principal / authority

  • unauthenticated actor
  • authenticated user
  • tenant / organization member
  • admin/operator
  • browser origin / webview / extension
  • local process / plugin / helper
  • CI actor / release actor
  • model / agent / tool caller
  • external service / webhook sender
  • device / app component
各principalについて通常authorityと禁止されるauthorityを区別する。
  • unauthenticated actor
  • authenticated user
  • tenant / organization member
  • admin/operator
  • browser origin / webview / extension
  • local process / plugin / helper
  • CI actor / release actor
  • model / agent / tool caller
  • external service / webhook sender
  • device / app component
对于每个 principal,应区分通常拥有的 authority 和被禁止的 authority。

Entry surface

Entry surface

projectに存在するものを列挙する:
  • HTTP / browser / WebSocket
  • RPC / GraphQL / messaging / webhook
  • file / archive / parser / document
  • CLI / env / config
  • database / migration / import/export
  • plugin / extension / generated input
  • CI / release / dependency
  • cloud event / IAM selector / IaC
  • LLM context / tool argument / MCP
  • mobile deep link / exported component / webview
  • desktop IPC / socket / helper
枚举 project 中存在的 entry surface:
  • HTTP / browser / WebSocket
  • RPC / GraphQL / messaging / webhook
  • file / archive / parser / document
  • CLI / env / config
  • database / migration / import/export
  • plugin / extension / generated input
  • CI / release / dependency
  • cloud event / IAM selector / IaC
  • LLM context / tool argument / MCP
  • mobile deep link / exported component / webview
  • desktop IPC / socket / helper

Security boundary

Security boundary

特に次をmapする:
  • authentication
  • authorization
  • tenant / owner isolation
  • secret / credential boundary
  • privilege transition
  • trust between process/service
  • browser origin / content boundary
  • filesystem / path boundary
  • code execution boundary
  • release / signing authority
  • data lifecycle / deletion / backup boundary
  • resource / quota / cost boundary
尤其需要映射以下内容:
  • authentication
  • authorization
  • tenant / owner isolation
  • secret / credential boundary
  • privilege transition
  • trust between process/service
  • browser origin / content boundary
  • filesystem / path boundary
  • code execution boundary
  • release / signing authority
  • data lifecycle / deletion / backup boundary
  • resource / quota / cost boundary

Source visibility

Source visibility

各controlを:
  • source-visible
  • locally verifiable
  • deployment/provider fact required
へ分類する。
reconnaissance段階ではtarget-controlled codeを実行しない。
将每个 control 归入以下类别:
  • source-visible
  • locally verifiable
  • deployment/provider fact required
在 reconnaissance 阶段,不执行 target-controlled code。

5. Coverage ledger

5. Coverage ledger

「agentが一通り見た」をcoverageとしない。
coverageは最低限次からstable unitを作る。
text
subsystem × entry surface × trust boundary × attack class
project規模に応じてcoarsen/splitしてよい。
各unitは最低限:
  • coverage_id
  • subsystem
  • entry surface
  • lower-trust principal
  • protected resource / boundary
  • selected attack class
  • starting source paths
  • owner agent
  • status
  • checks / evidence
  • candidate fingerprints
  • uncovered dependency
  • prior-run relation
を持つ。
status候補:
  • planned
  • in_progress
  • covered
  • candidate
  • blocked
  • deferred
  • out_of_scope
blocked
/
deferred
/
out_of_scope
を
covered
と数えない。
同一repositoryのprior auditが存在する場合:
  • unchanged confirmed findingはcurrent source traceを再確認する
  • changed sourceは再監査対象へ戻す
  • prior
    needs_validation
    は未解決のままcoverageを抑制しない
  • prior rejectionは同じfailed claimだけを抑制し、unit全体をcoveredにしない
  • quick/scoped runをfull coverageとして継承しない
不能将“agent 大致看了一遍”视为 coverage。
coverage 至少应基于以下维度建立 stable unit:
text
subsystem × entry surface × trust boundary × attack class
可以根据 project 规模对这些维度进行 coarsen/split。
每个 unit 至少包含:
  • coverage_id
  • subsystem
  • entry surface
  • lower-trust principal
  • protected resource / boundary
  • selected attack class
  • starting source paths
  • owner agent
  • status
  • checks / evidence
  • candidate fingerprints
  • uncovered dependency
  • prior-run relation
可选 status:
  • planned
  • in_progress
  • covered
  • candidate
  • blocked
  • deferred
  • out_of_scope
不能将
blocked
、
deferred
或
out_of_scope
计为
covered
。
如果同一 repository 存在先前的 audit:
  • 对未变更的 confirmed finding,重新确认 current source trace
  • 将发生变更的 source 重新纳入审计范围
  • 先前的
    needs_validation
    在解决前不得抑制 coverage
  • 先前的 rejection 只能抑制同一个失败 claim,不能将整个 unit 标记为 covered
  • 不得将 quick/scoped run 作为 full coverage 继承

6. Phase 2 — Coverage-led hunting

6. Phase 2 — Coverage-led hunting

hunterはcoverage unitを所有し、そのboundaryに関係するsourceを深く追う。
基本method:
  1. lower-trust principal / accepted inputを確定
  2. 守られるべきsecurity invariantを定義
  3. invariantをenforceするcontrolを特定
  4. parsing / normalization / identity / authorization / state transitionを追跡
  5. derived copy / alternate path / batch / retry / migration / error pathを確認
  6. security-sensitive sink/resultまでtrace
  7. sibling pathのcontrol equivalenceを比較
  8. minimum concrete resultで停止
  9. root causeと最小source fix invariantを記録
重点的に見るsad path:
  • absent / empty / zero / negative
  • duplicate / replay
  • stale / revoked
  • mixed encoding / canonicalization disagreement
  • over-limit / maximum
  • reordered / concurrent
  • partial failure / rollback
  • migration old/new path
  • dependency failure / fallback
  • batch / import / export
  • alternate endpoint / legacy path
hunterはpeer-owned coverageへ無秩序に広がらない。別boundaryを発見した場合はnew coverage unit候補として返す。
hunter 负责一个 coverage unit,并深入追踪与该 boundary 相关的 source。
基本方法:
  1. 确定 lower-trust principal / accepted input
  2. 定义需要保护的 security invariant
  3. 识别用于 enforce invariant 的 control
  4. 追踪 parsing / normalization / identity / authorization / state transition
  5. 检查 derived copy / alternate path / batch / retry / migration / error path
  6. 追踪至 security-sensitive sink/result
  7. 比较 sibling path 之间的 control equivalence
  8. 在 minimum concrete result 处停止
  9. 记录 root cause 和最小 source fix invariant
重点检查以下 sad path:
  • absent / empty / zero / negative
  • duplicate / replay
  • stale / revoked
  • mixed encoding / canonicalization disagreement
  • over-limit / maximum
  • reordered / concurrent
  • partial failure / rollback
  • migration old/new path
  • dependency failure / fallback
  • batch / import / export
  • alternate endpoint / legacy path
hunter 不得无序扩展到其他 agent 负责的 coverage。发现不同 boundary 时,应将其作为新的 coverage unit candidate 返回。

7. Attack classes

7. Attack classes

詳細な選定観点は
ATTACK-CLASSES.md
をcanonical catalogとして使用する。projectに存在するsurfaceだけを選択する。
標準class:
  • injection / unsafe sink
  • authentication / session / account recovery
  • authorization / object ownership / tenant isolation
  • business logic / state machine / replay
  • resource / file / path / archive handling
  • SSRF / outbound request trust
  • cryptography / secret handling
  • parser / deserialization / protocol disagreement
  • browser / DOM / origin / postMessage / storage
  • native memory / unsafe / FFI / ABI / integer
  • concurrency / TOCTOU
  • dependency / generated input / plugin / extension
  • CI / artifact / release / signing / update
  • IAM / IaC / container / serverless / runtime config
  • RPC / queue / broker / webhook
  • resource exhaustion / quota / operator spend
  • cache / search / export / backup / deletion / restore
  • desktop / mobile / deep link / webview / local IPC
  • AI / LLM context / prompt boundary / tool binding / MCP identity / output handling
generic scanner checklistとして機械的に全classを適用しない。reconnaissance evidenceから選ぶ。
详细的选定标准以
ATTACK-CLASSES.md
作为 canonical catalog。仅选择 project 中实际存在的 surface。
标准 class:
  • injection / unsafe sink
  • authentication / session / account recovery
  • authorization / object ownership / tenant isolation
  • business logic / state machine / replay
  • resource / file / path / archive handling
  • SSRF / outbound request trust
  • cryptography / secret handling
  • parser / deserialization / protocol disagreement
  • browser / DOM / origin / postMessage / storage
  • native memory / unsafe / FFI / ABI / integer
  • concurrency / TOCTOU
  • dependency / generated input / plugin / extension
  • CI / artifact / release / signing / update
  • IAM / IaC / container / serverless / runtime config
  • RPC / queue / broker / webhook
  • resource exhaustion / quota / operator spend
  • cache / search / export / backup / deletion / restore
  • desktop / mobile / deep link / webview / local IPC
  • AI / LLM context / prompt boundary / tool binding / MCP identity / output handling
不要将 generic scanner checklist 机械地应用于所有 class。应根据 reconnaissance evidence 进行选择。

8. Bounded local validation

8. Bounded local validation

static traceでcandidateが成立した後、必要なら最小local evidenceを取る。
許可される例:
  • existing unit/integration test
  • minimal function harness
  • dummy tenant / dummy principal fixture
  • malformed local parser fixture
  • deterministic local race schedule
  • isolated loopback onlyのlocal client/server
  • rendered policy/config comparison
target-controlled build/test/process/browser/emulator/fuzzerは
sandbox-runtime
のenforced isolation下でのみ実行する。
最低条件:
  • external networkなし
  • explicit allowlistから作るsafe environment
  • target/toolchainはread-onlyを基本とする
  • writeはagent固有scratchだけ
  • CPU / memory / process / disk / file size / wall clock bound
  • credential / host secret / shared socketを渡さない
  • dependency/toolをaudit中に勝手にfetch/installしない
必要controlをenforceできない場合、実行せず
needs_validation
にする。
minimum effectを確認したら停止する。exploit chain、persistence、stealth、availability damageへ拡張しない。
如果 static trace 已使 candidate 成立,必要时可以获取最小 local evidence。
允许的示例:
  • existing unit/integration test
  • minimal function harness
  • dummy tenant / dummy principal fixture
  • malformed local parser fixture
  • deterministic local race schedule
  • 仅使用 isolated loopback 的 local client/server
  • rendered policy/config comparison
target-controlled build/test/process/browser/emulator/fuzzer 只能在
sandbox-runtime
强制实施的 isolation 下执行。
最低条件:
  • 不访问 external network
  • 使用由 explicit allowlist 构建的 safe environment
  • target/toolchain 原则上设为 read-only
  • write 仅限 agent 专属 scratch
  • 对 CPU / memory / process / disk / file size / wall clock 设置上限
  • 不传入 credential / host secret / shared socket
  • 审计期间不得擅自 fetch/install dependency/tool
如果无法 enforce 必要 control,则不得执行,并将其标记为
needs_validation
。
确认 minimum effect 后立即停止。不得将验证扩展为 exploit chain、persistence、stealth 或 availability damage。

9. Candidate contract

9. Candidate contract

hunter resultはprose-onlyにしない。
candidateは最低限:
  • stable
    fingerprint
  • title
  • proposed verdict
  • lower-trust principal
  • intended security invariant
  • root cause
  • source trace: entrypoint -> propagation -> sink/result
  • evidence
  • required conditions
  • observed local result if any
  • missing decisive fact if any
  • remediation invariant
  • proposed regression case
を持つ。
同じsource-derived root causeは同じfingerprintへ統合する。
hunter result 不能只有 prose。
candidate 至少包含:
  • 稳定的
    fingerprint
  • title
  • proposed verdict
  • lower-trust principal
  • intended security invariant
  • root cause
  • source trace: entrypoint -> propagation -> sink/result
  • evidence
  • required conditions
  • observed local result(如有)
  • missing decisive fact(如有)
  • remediation invariant
  • proposed regression case
将基于同一 source 推导出的 root cause 合并到同一个 fingerprint。

10. Phase 3 — Independent verification

10. Phase 3 — Independent verification

hunter自身のself-confirmationでfindingを確定しない。
unique candidateごとに、発見へ参加していないfresh verifierを割り当てる。
verifierの目的はcandidateを確認することではなく反証すること。
必須確認:
  1. entrypointが本当にlower-trust surfaceか
  2. trace中の全source locationがcurrent sourceと一致するか
  3. stronger validation / authorization / containment controlがないか
  4. preconditionが実際に成立するか
  5. bounded local reproductionが再現可能か
  6. resultがclaimed impactを支えるか
  7. source外factを推測していないか
  8. remediationがroot causeを最小範囲で閉じるか
verdict:
不能依靠 hunter 自身的 self-confirmation 来确定 finding。
为每个 unique candidate 分配一个未参与发现的 fresh verifier。
verifier 的目的不是确认 candidate,而是反证 candidate。
必须确认:
  1. entrypoint 是否确实是 lower-trust surface
  2. trace 中的所有 source location 是否与 current source 一致
  3. 是否存在更强的 validation / authorization / containment control
  4. precondition 是否确实成立
  5. bounded local reproduction 是否可复现
  6. result 是否足以支撑所声明的 impact
  7. 是否推测了 source 外 fact
  8. remediation 是否能在最小范围内关闭 root cause
verdict:

confirmed

confirmed

source traceと必要条件が成立し、meaningful boundary/resultがbounded evidenceで確認されている。
source trace 和必要条件成立,并且 meaningful boundary/result 已由 bounded evidence 确认。

needs_validation

needs_validation

specificなsource-grounded hypothesisはあるが、deployment/provider/runtime/identity等の決定的factがsource/local環境から確認できない。
必要:
  • missing fact
  • なぜ決定的か
  • safe local validation plan
  • owner-observed deployment validation plan
severityは付けない。
存在具体的 source-grounded hypothesis,但无法从 source/local 环境确认 deployment/provider/runtime/identity 等 decisive fact。
必须提供:
  • missing fact
  • 该 fact 为何具有决定性
  • safe local validation plan
  • 由 owner 观察的 deployment validation plan
不得设置 severity。

rejected

rejected

source/control/local behaviorによってcandidateが反証された、meaningful impactがない、または前提が成立しない。
rejectedもaudit evidenceとして残し、同じ誤検出を繰り返さない。
candidate 被 source/control/local behavior 反证、没有 meaningful impact,或前提不成立。
rejected 也应作为 audit evidence 保留,以避免重复相同的误检测。

11. Severity and priority

11. Severity and priority

certaintyとseverityを混同しない。
severityは
confirmed
だけへ付ける。
評価:
  • exploitability / required capability
  • authentication / privilege
  • user interaction
  • blast radius
  • confidentiality
  • integrity
  • availability
  • tenant/account scope
  • persistence
  • prerequisite complexity
severityはobserved/demonstrated impactを超えない。
audit severityはdelivery priorityそのものではない。
confirmed findingは
security-maintenance
のproject-aware prioritizationへhandoffし、external exposure、release timing、fix availability、regression risk等を加えてP0/P1/P2/P3へ変換する。
不能混淆 certainty 与 severity。
仅为
confirmed
设置 severity。
评估因素:
  • exploitability / required capability
  • authentication / privilege
  • user interaction
  • blast radius
  • confidentiality
  • integrity
  • availability
  • tenant/account 范围
  • persistence
  • prerequisite complexity
severity 不得超出 observed/demonstrated impact。
audit severity 不等同于 delivery priority。
将 confirmed finding 移交给
security-maintenance
的 project-aware prioritization,并结合 external exposure、release timing、fix availability、regression risk 等因素,转换为 P0/P1/P2/P3。

12. Phase 4 — Structured output

12. Phase 4 — Structured output

repository/project conventionに合わせてmachine-readable audit artifactsを残す。標準contractは
coverage-ledger.schema.json
と
findings.schema.json
を使用し、project固有extensionはcore verdict semanticsを弱めない。
推奨:
text
security-audit/
  run-metadata.json
  architecture.md
  coverage-ledger.json
  findings.json
  REPORT.md
  NEEDS-VALIDATION.md
target repository内へ置く必要はない。audit artifactがtarget sourceやrelease artifactへ混入しないようにする。
findings.json
は少なくとも:
  • confirmed
  • needs_validation
  • rejected
をschemaで区別し、prose reportはstructured recordからderiveする。
run metadata:
  • source ref / dirty state
  • profile
  • scope
  • audit timestamp
  • selected attack classes
  • prior-run inputs
  • execution restrictions
  • incomplete reason if any
を追跡する。
按照 repository/project convention 留存 machine-readable audit artifacts。标准 contract 使用
coverage-ledger.schema.json
和
findings.schema.json
;project 特有 extension 不得削弱核心 verdict semantics。
推荐结构:
text
security-audit/
  run-metadata.json
  architecture.md
  coverage-ledger.json
  findings.json
  REPORT.md
  NEEDS-VALIDATION.md
无需将其放入 target repository 内。应防止 audit artifact 混入 target source 或 release artifact。
findings.json
至少应通过 schema 区分:
  • confirmed
  • needs_validation
  • rejected
prose report 应从 structured record 派生。
run metadata 应追踪:
  • source ref / dirty state
  • profile
  • scope
  • audit timestamp
  • selected attack classes
  • prior-run inputs
  • execution restrictions
  • incomplete reason(如有)

13. Phase 5 — Final record verification

13. Phase 5 — Final record verification

standard/deep auditではfinal report前に、confirmed recordのsource claimをfresh reviewerが再確認する。
material correctionでroot cause / condition / impact / severityが変わる場合は、修正recordを別fresh verifierへ通す。
report textとstructured findingを別々の事実源にしない。
在 standard/deep audit 中,生成 final report 之前,应由 fresh reviewer 再次确认 confirmed record 的 source claim。
如果 material correction 会改变 root cause、condition、impact 或 severity,则应将修正后的 record 交给另一个 fresh verifier。
不要将 report text 和 structured finding 分别作为独立的事实源。

14. Phase 6 — Delivery handoff

14. Phase 6 — Delivery handoff

audit Skill自身はsource修正を行わない。
confirmed findingごとに:
  1. root cause / affected boundaryを確定
  2. duplicate findingをfingerprintで統合
  3. project priorityを
    security-maintenance
    で判定
  4. meaningful findingをGitHub Issueへ変換
  5. target release / patch releaseを選択
  6. remediation branch / PRを通常delivery workflowで実装
  7. regression test + vulnerable-path verification
  8. applicable integration / E2E / artifact verification
  9. fix後にaffected audit coverageを再検証
needs_validation
は無理にIssue化・severity付けしない。owner-observed validationが必要な場合はそのfact確認taskとして明示する。
security/privacy risk acceptanceが必要なら
engineering-decisions
に従いuserへescalateする。
audit Skill 本身不修改 source。
对于每个 confirmed finding:
  1. 确定 root cause / affected boundary
  2. 根据 fingerprint 合并重复 finding
  3. 通过
    security-maintenance
    判定 project priority
  4. 将 meaningful finding 转换为 GitHub Issue
  5. 选择 target release / patch release
  6. 通过常规 delivery workflow 实现 remediation branch / PR
  7. 执行 regression test 和 vulnerable-path verification
  8. 执行适用的 integration / E2E / artifact verification
  9. 修复后重新验证受影响的 audit coverage
不要强行将
needs_validation
转化为 Issue,也不要为其设置 severity。如果需要 owner 观察验证,应将其明确列为 fact 确认任务。
如果需要接受 security/privacy risk,应遵循
engineering-decisions
并向 user escalate。

15. Completion criteria

15. Completion criteria

audit完了時に最低限報告:
  • source ref / scope / profile
  • mapped principals / trust boundaries
  • selected attack classes
  • coverage summary
  • confirmed count
  • needs-validation count
  • rejected count
  • deferred / blocked / out-of-scope units
  • prior-run relation
  • incomplete reason if any
  • delivery handoff state
coverage gapが残る場合、「脆弱性なし」ではなく「このscopeではconfirmed findingなし」と表現する。
审计完成时,至少应报告:
  • source ref / scope / profile
  • 已映射的 principals / trust boundaries
  • selected attack classes
  • coverage summary
  • confirmed 数量
  • needs-validation 数量
  • rejected 数量
  • deferred / blocked / out-of-scope units
  • prior-run relation
  • incomplete reason(如有)
  • delivery handoff state
如果仍存在 coverage gap,应表述为“在此 scope 中没有 confirmed finding”,而不是“没有 vulnerability”。

16. Anti-patterns

16. Anti-patterns

禁止:
  • security checklist逸脱をそのままfinding化
  • scanner warningをsource traceなしでfinding化
  • CVSS/severityだけでcandidateを確定
  • provider/deployment controlの存在/不在を推測
  • authenticated self-impactをcross-tenant issueへ誇張
  • parser crashからRCE等を推測
  • hunterとverifierを同一agentで済ませる
  • rejected candidateを捨てて同じ誤検出を再発
  • uncovered areaをsilentに省略
  • quick/scoped auditをfull auditとして報告
  • audit中にtarget sourceを直接修正
  • production/shared environmentでexploit validation
禁止:
  • 将单纯偏离 security checklist 的情况直接认定为 finding
  • 在没有 source trace 的情况下将 scanner warning 认定为 finding
  • 仅凭 CVSS/severity 确定 candidate
  • 推测 provider/deployment control 的存在或缺失
  • 将 authenticated self-impact 夸大为 cross-tenant issue
  • 从 parser crash 推测 RCE 等结果
  • 使用同一个 agent 同时完成 hunter 和 verifier
  • 丢弃 rejected candidate,导致重复出现相同误检测
  • 静默省略 uncovered area
  • 将 quick/scoped audit 报告为 full audit
  • 在审计期间直接修改 target source
  • 在 production/shared environment 中进行 exploit validation

17. Upstream design reference

17. Upstream design reference

このSkillのcoverage-led audit、candidate/verifier separation、structured verdict modelはCloudflareの
security-audit-skill
を重要なdesign referenceとしている。
project-initではupstream固有のagent runtimeやscratch ownership実装をそのままcanonicalにせず、既存の
parallel-orchestration
/
sandbox-runtime
/
github-delivery
semanticsへtranslateして使用する。
本 Skill 的 coverage-led audit、candidate/verifier separation 和 structured verdict model,将 Cloudflare 的
security-audit-skill
作为重要的 design reference。
在 project-init 中,不应将 upstream 特有的 agent runtime 或 scratch ownership 实现直接设为 canonical,而应将其 translate 为现有的
parallel-orchestration
、
sandbox-runtime
和
github-delivery
semantics 后使用。