security-audit
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseSecurity Audit
Security Audit
このSkillは、既知advisoryを継続管理する とは別に、project sourceから未知の脆弱性を探索・検証するapplication security audit を定義する。
security-maintenance目的は「怪しいコードを列挙する」ことではない。principal、trust boundary、entry surface、security invariant、sink/resultをsourceから追跡し、監査coverageを残し、候補をfresh verifierが反証したうえでのみfindingとして確定する。
本 Skill 与持续管理已知 advisory 的 分开,定义了从 project source 中探索并验证未知漏洞的 application security audit。
security-maintenance目标不是“列出可疑代码”。而是从 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
監査中は次を破らない。
- findingには具体的なlower-trust principalまたはuntrusted inputが必要。
- findingには守るべきsecurity invariantと、破られたboundary/resultが必要。
- best practice不足だけをvulnerabilityとして扱わない。
- sourceで確認できないdeployment/provider/browser/IAM/runtime factを推測しない。
- source外factが決定的なら とする。
needs_validation - self-impactや同一principalに許可されたauthorityをcross-boundary vulnerabilityへ膨らませない。
- severityはconfirmed findingだけに付ける。
- observed resultより強いimpactを推測しない。
- target-controlled executionはapproved sandboxの内部だけで行う。
- production/shared endpoint、他user data、real credential、paid API、live control planeをprobeしない。
- audit自身はtarget sourceを変更しない。finding確定後にdelivery workflowへhandoffする。
- audit coverageが部分的ならcomplete auditと表現しない。
审计期间不得违反以下规则。
- 每个 finding 都必须涉及具体的 lower-trust principal 或 untrusted input。
- 每个 finding 都必须包含需要保护的 security invariant,以及被突破的 boundary/result。
- 不能仅将 best practice 不足视为 vulnerability。
- 不能推测无法从 source 中确认的 deployment/provider/browser/IAM/runtime fact。
- 如果 source 外 fact 起决定性作用,则将其标记为 。
needs_validation - 不能将 self-impact 或同一 principal 被允许的 authority 夸大或膨胀为 cross-boundary vulnerability。
- 仅为 confirmed finding 设置 severity。
- 不能推测强于 observed result 的 impact。
- target-controlled execution 只能在 approved sandbox 内部执行。
- 不能 probe production/shared endpoint、其他用户数据、真实 credential、付费 API 或 live control plane。
- 审计本身不得修改 target source;应在确定 finding 后移交给 delivery workflow。
- 如果 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 classproject規模に応じて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候補:
plannedin_progresscoveredcandidateblockeddeferredout_of_scope
blockeddeferredout_of_scopecovered同一repositoryのprior auditが存在する場合:
- unchanged confirmed findingはcurrent source traceを再確認する
- changed sourceは再監査対象へ戻す
- prior は未解決のままcoverageを抑制しない
needs_validation - 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:
plannedin_progresscoveredcandidateblockeddeferredout_of_scope
不能将 、 或 计为 。
blockeddeferredout_of_scopecovered如果同一 repository 存在先前的 audit:
- 对未变更的 confirmed finding,重新确认 current source trace
- 将发生变更的 source 重新纳入审计范围
- 先前的 在解决前不得抑制 coverage
needs_validation - 先前的 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:
- lower-trust principal / accepted inputを確定
- 守られるべきsecurity invariantを定義
- invariantをenforceするcontrolを特定
- parsing / normalization / identity / authorization / state transitionを追跡
- derived copy / alternate path / batch / retry / migration / error pathを確認
- security-sensitive sink/resultまでtrace
- sibling pathのcontrol equivalenceを比較
- minimum concrete resultで停止
- 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。
基本方法:
- 确定 lower-trust principal / accepted input
- 定义需要保护的 security invariant
- 识别用于 enforce invariant 的 control
- 追踪 parsing / normalization / identity / authorization / state transition
- 检查 derived copy / alternate path / batch / retry / migration / error path
- 追踪至 security-sensitive sink/result
- 比较 sibling path 之间的 control equivalence
- 在 minimum concrete result 处停止
- 记录 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
詳細な選定観点は をcanonical catalogとして使用する。projectに存在するsurfaceだけを選択する。
ATTACK-CLASSES.md標準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から選ぶ。
详细的选定标准以 作为 canonical catalog。仅选择 project 中实际存在的 surface。
ATTACK-CLASSES.md标准 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は のenforced isolation下でのみ実行する。
sandbox-runtime最低条件:
- 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_validationminimum 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 只能在 强制实施的 isolation 下执行。
sandbox-runtime最低条件:
- 不访问 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を確認することではなく反証すること。
必須確認:
- entrypointが本当にlower-trust surfaceか
- trace中の全source locationがcurrent sourceと一致するか
- stronger validation / authorization / containment controlがないか
- preconditionが実際に成立するか
- bounded local reproductionが再現可能か
- resultがclaimed impactを支えるか
- source外factを推測していないか
- remediationがroot causeを最小範囲で閉じるか
verdict:
不能依靠 hunter 自身的 self-confirmation 来确定 finding。
为每个 unique candidate 分配一个未参与发现的 fresh verifier。
verifier 的目的不是确认 candidate,而是反证 candidate。
必须确认:
- entrypoint 是否确实是 lower-trust surface
- trace 中的所有 source location 是否与 current source 一致
- 是否存在更强的 validation / authorization / containment control
- precondition 是否确实成立
- bounded local reproduction 是否可复现
- result 是否足以支撑所声明的 impact
- 是否推测了 source 外 fact
- 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は のproject-aware prioritizationへhandoffし、external exposure、release timing、fix availability、regression risk等を加えてP0/P1/P2/P3へ変換する。
security-maintenance不能混淆 certainty 与 severity。
仅为 设置 severity。
confirmed评估因素:
- 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 移交给 的 project-aware prioritization,并结合 external exposure、release timing、fix availability、regression risk 等因素,转换为 P0/P1/P2/P3。
security-maintenance12. Phase 4 — Structured output
12. Phase 4 — Structured output
repository/project conventionに合わせてmachine-readable audit artifactsを残す。標準contractは と を使用し、project固有extensionはcore verdict semanticsを弱めない。
coverage-ledger.schema.jsonfindings.schema.json推奨:
text
security-audit/
run-metadata.json
architecture.md
coverage-ledger.json
findings.json
REPORT.md
NEEDS-VALIDATION.mdtarget repository内へ置く必要はない。audit artifactがtarget sourceやrelease artifactへ混入しないようにする。
findings.jsonconfirmedneeds_validationrejected
を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 使用 和 ;project 特有 extension 不得削弱核心 verdict semantics。
coverage-ledger.schema.jsonfindings.schema.json推荐结构:
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.jsonconfirmedneeds_validationrejected
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ごとに:
- root cause / affected boundaryを確定
- duplicate findingをfingerprintで統合
- project priorityを で判定
security-maintenance - meaningful findingをGitHub Issueへ変換
- target release / patch releaseを選択
- remediation branch / PRを通常delivery workflowで実装
- regression test + vulnerable-path verification
- applicable integration / E2E / artifact verification
- fix後にaffected audit coverageを再検証
needs_validationsecurity/privacy risk acceptanceが必要なら に従いuserへescalateする。
engineering-decisionsaudit Skill 本身不修改 source。
对于每个 confirmed finding:
- 确定 root cause / affected boundary
- 根据 fingerprint 合并重复 finding
- 通过 判定 project priority
security-maintenance - 将 meaningful finding 转换为 GitHub Issue
- 选择 target release / patch release
- 通过常规 delivery workflow 实现 remediation branch / PR
- 执行 regression test 和 vulnerable-path verification
- 执行适用的 integration / E2E / artifact verification
- 修复后重新验证受影响的 audit coverage
不要强行将 转化为 Issue,也不要为其设置 severity。如果需要 owner 观察验证,应将其明确列为 fact 确认任务。
needs_validation如果需要接受 security/privacy risk,应遵循 并向 user escalate。
engineering-decisions15. 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の を重要なdesign referenceとしている。
security-audit-skill- https://github.com/cloudflare/security-audit-skill
- upstream license: MIT
project-initではupstream固有のagent runtimeやscratch ownership実装をそのままcanonicalにせず、既存の / / semanticsへtranslateして使用する。
parallel-orchestrationsandbox-runtimegithub-delivery本 Skill 的 coverage-led audit、candidate/verifier separation 和 structured verdict model,将 Cloudflare 的 作为重要的 design reference。
security-audit-skill- https://github.com/cloudflare/security-audit-skill
- upstream license: MIT
在 project-init 中,不应将 upstream 特有的 agent runtime 或 scratch ownership 实现直接设为 canonical,而应将其 translate 为现有的 、 和 semantics 后使用。
parallel-orchestrationsandbox-runtimegithub-delivery