tk-audit

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Audit

审计

Use only when

$tk-audit

/tk-audit

is explicitly selected. This is read-only codebase advising and does not modify source, tests, configuration, or history. 소유하는 유일한 산출물은 저장소 로컬의

.tigerkit/audit.md

입니다.

仅在明确选择

$tk-audit

或

/tk-audit

时使用。这是只读的代码库咨询操作，不会修改源代码、测试用例、配置或历史记录。唯一产出物是存储库本地的

.tigerkit/audit.md

文件。

Invocation

调用方式

```
bare
```
: Audit all categories at standard depth.
```
quick | standard | deep
```
: Change the depth and bounded coverage.
```
security | perf | tests | architecture
```
: Focus on one category.
```
branch
```
: Inspect merge-base changes and direct consumers, and mark
```
introduced | pre-existing
```
.
```
next
```
: Separate evidence-backed direction candidates from defect findings.

Modifiers may be combined. Do not implement, write Seeds, publish issues, or create worktrees. 사용자 소유의 clarification이 필요하면 host별 native structured question surface를 우선 사용합니다 (Claude Code: AskUserQuestion; Codex: request_user_input; Hermes: clarify). unavailable하면 한 번의 clarification을 plain chat으로 fallback하고 read-only boundary를 유지합니다.

```
bare
```
: 以标准深度审核所有类别。
```
quick | standard | deep
```
: 调整审核深度和覆盖范围。
```
security | perf | tests | architecture
```
: 聚焦单个类别进行审核。
```
branch
```
: 检查合并基准变更和直接依赖项，并标记
```
introduced（新增）| pre-existing（已存在）
```
。
```
next
```
: 将基于证据的方向候选项与缺陷发现项区分开。

可组合使用修饰符。请勿执行代码实现、编写Seed、发布问题或创建工作树。若需要用户澄清，优先使用对应宿主的原生结构化提问方式（Claude Code：AskUserQuestion；Codex：request_user_input；Hermes：clarify）。若该方式不可用，则退回到普通聊天进行一次澄清，并保持只读边界。

Workflow

工作流程

Read repository instructions, root configuration, verification commands, structure, and relevant Git history.
Check the selected categories using audit-playbook.md.
Reopen cited evidence to remove duplicates, intended behavior, and incorrect attribution.

Sort

finding

s by impact ÷

effort

, then

confidence

fix risk

, and

dependency

```
.tigerkit/audit.md
```
를 원자적으로 갱신하고 안정적인
```
AUD-*
```
ID와 상태를 보존합니다.

读取存储库说明、根配置、验证命令、结构以及相关Git历史记录。
使用audit-playbook.md检查选定的类别。
重新核查引用的证据，移除重复项、预期行为项和错误归因项。
按照
```
影响÷修复成本
```
的优先级对
```
finding
```
（发现项）进行排序，其次按
```
置信度
```
、
```
修复风险
```
和
```
依赖关系
```
排序。
原子化更新
```
.tigerkit/audit.md
```
文件，并保留稳定的
```
AUD-*
```
ID和状态。

Failure Paths

异常处理路径

If repository instructions, the selected reference, or required evidence is unavailable, stop that scope and record it as unaudited; do not infer coverage.
If cited evidence cannot be reproduced at the audited
```
HEAD
```
, mark the finding unverifiable or stale and do not claim verification.
If the scope or modifier is invalid, ask one clarifying question before reading beyond the minimum needed to identify the problem.
If the atomic
```
.tigerkit/audit.md
```
update fails, preserve the existing ledger, report the write failure, and do not fall back to an untracked or global copy.

若存储库说明、选定的参考文件或所需证据不可用，则停止该范围的审核并记录为未审核；请勿推断覆盖范围。
若引用的证据无法在审核的
```
HEAD
```
节点复现，则标记该发现项为无法验证或已过时，且不得声称已验证。
若范围或修饰符无效，在读取超出识别问题所需的最小内容之前，先提出一次澄清问题。
若原子化更新
```
.tigerkit/audit.md
```
失败，则保留现有记录，报告写入失败，且不得退回到未跟踪或全局副本。

Finding Contract

发现项规范

각 열린 finding에는 최소한 다음이 있어야 합니다.

안정적인
```
AUD-*
```
ID와 제목
범주와 정확한
```
path/line
```
또는
```
symbol
```
근거
영향,
```
effort
```
,
```
fix risk
```
,
```
confidence
```
관련 진입점과 저장소 관례
검증
```
baseline
```
짧은
```
fix sketch
```
```
dependency/order hint
```
다음 경로 추천:
```
prep | investigate | no-action
```

finding

은 후보일 뿐

Seed

, 티켓, 구현 계획, 승인 자체가 아닙니다.

secret

값은 복사하지 않고 위치와 자격 증명 유형만 기록합니다.

每个已记录的

finding

（发现项）至少应包含以下内容：

稳定的
```
AUD-*
```
ID和标题
类别以及准确的
```
path/line
```
（路径/行号）或
```
symbol
```
（符号）证据
影响程度、
```
effort
```
（修复成本）、
```
fix risk
```
（修复风险）、
```
confidence
```
（置信度）
相关入口点和存储库惯例
验证
```
baseline
```
（基准）
简短的
```
fix sketch
```
（修复方案梗概）
```
dependency/order hint
```
（依赖/顺序提示）
后续路径建议：
```
prep | investigate | no-action
```
（准备|调查|不处理）

finding

仅为候选项，并非

Seed

、工单、实施计划或批准本身。请勿复制

secret

（密钥）值，仅记录其位置和凭证类型。

Next-Executor Handoff

执行者交接规范

모든 finding에는 executor-handoff.md를 적용합니다. 다음 실행자가

audit

대화 없이 이해할 수 있도록

audited HEAD

, 정확한 경로/

symbol

, 현재 근거, 저장소 규칙,

in/out

경계, 가정, 검증 명령과

drift handling

을 포함합니다.

plan-template.md의 품질 기준은 이 계약을 보완하지만,

tk-audit

자체가 별도 plan lifecycle을 만들지는 않습니다.

작업을 실제로 준비하려면 사용자가

$tk-prep AUD-003

처럼 현재

finding

을 출처로 줄 수 있습니다.

tk-prep

은

finding

을 현재 저장소 증거와 다시 대조해 실행 가능한

Seed

로 준비합니다.

Audit finding

만으로 제품 변경이나 원격 권한이 생기지 않습니다.

所有

finding

（发现项）均需遵循executor-handoff.md的要求。需包含

audited HEAD

（已审核的HEAD节点）、准确的路径/

symbol

（符号）、当前证据、存储库规则、

in/out

（输入/输出）边界、假设条件、验证命令以及

drift handling

（漂移处理），以便后续执行者无需查看审核对话即可理解。

plan-template.md的质量标准是对本规范的补充，但

tk-audit

本身不会创建独立的计划生命周期。

若要实际准备工作，用户可指定当前

finding

作为来源，例如

$tk-prep AUD-003

。

tk-prep

会将

finding

与当前存储库证据再次比对，将其转换为可执行的

Seed

。仅凭借

Audit finding

（审计发现项）不会产生产品变更或远程权限。

Safety

安全规范

During a partial audit, do not delete existing findings; mark unaudited scope. Do not claim verification when the evidence cannot be reproduced at the current HEAD.

.tigerkit/

은 로컬 scratch이며 전역 archive나 current pointer를 만들지 않습니다.

완료 시 핵심

finding

과 감사하지 못한 범위를 간결하게 요약합니다.

在部分审核过程中，请勿删除现有发现项；需标记未审核的范围。若证据无法在当前HEAD节点复现，不得声称已验证。

.tigerkit/

是本地临时目录，不会创建全局归档或当前指针。

审核完成时，需简要总结核心

finding

（发现项）和未审核的范围。