verify-implementation

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

구현 검증

实现验证

목적

目的

프로젝트에 등록된 모든
verify-*
스킬을 순차적으로 실행하여 통합 검증을 수행합니다:
  • 각 스킬의 Workflow에 정의된 검사를 실행
  • 각 스킬의 Exceptions를 참조하여 false positive 방지
  • 발견된 이슈에 대해 수정 방법을 제시
  • 사용자 승인 후 수정 적용 및 재검증
依次运行项目中注册的所有
verify-*
技能,执行综合验证:
  • 运行各技能Workflow中定义的检查
  • 参考各技能的Exceptions避免误报
  • 针对发现的问题提出修正方法
  • 获得用户确认后应用修正并重新验证

실행 시점

执行时机

  • 새로운 기능을 구현한 후
  • Pull Request를 생성하기 전
  • 코드 리뷰 중
  • 코드베이스 규칙 준수 여부를 감사할 때
  • 完成新功能实现后
  • 创建Pull Request前
  • 代码评审过程中
  • 审计代码库是否符合规则时

실행 대상 스킬

目标执行技能

이 스킬이 순차 실행하는 검증 스킬 목록입니다.
/manage-skills
가 스킬을 생성/삭제할 때 이 목록을 자동 업데이트합니다.
(아직 등록된 검증 스킬이 없습니다)
<!-- 스킬이 추가되면 아래 형식으로 등록: | # | 스킬 | 설명 | |---|------|------| | 1 | `verify-example` | 예시 검증 설명 | -->
以下是本技能将依次运行的验证技能列表。运行
/manage-skills
创建/删除技能时,此列表会自动更新。
(目前暂无已注册的验证技能)
<!-- 新增技能时请按以下格式注册: | # | 技能 | 说明 | |---|------|------| | 1 | `verify-example` | 示例验证说明 | -->

워크플로우

工作流程

Step 1: 소개

Step 1: 确认技能

위의 실행 대상 스킬 섹션에 나열된 스킬을 확인합니다.
선택적 인수가 제공된 경우, 해당 스킬만 필터링합니다.
등록된 스킬이 0개인 경우:
markdown
undefined
查看上述目标执行技能部分列出的技能。
若提供了可选参数,则仅筛选符合条件的技能。
已注册技能数量为0时:
markdown
undefined

구현 검증

实现验证

검증 스킬이 없습니다.
/manage-skills
를 실행하여 프로젝트에 맞는 검증 스킬을 생성하세요.

이 경우 워크플로우를 종료합니다.

**등록된 스킬이 1개 이상인 경우:**

실행 대상 스킬 테이블의 내용을 표시합니다:

```markdown
没有可用的验证技能。请运行/manage-skills为项目创建合适的验证技能。

此时将终止工作流程。

**已注册技能数量为1个及以上时:**

显示目标执行技能表格内容:

```markdown

구현 검증

实现验证

다음 검증 스킬을 순차 실행합니다:
#스킬설명
1verify-<name1><description1>
2verify-<name2><description2>
검증 시작...
undefined
将依次运行以下验证技能:
#技能说明
1verify-<name1><description1>
2verify-<name2><description2>
开始验证...
undefined

Step 2: 순차 실행

Step 2: 依次执行

실행 대상 스킬 테이블에 나열된 각 스킬에 대해 다음을 수행합니다:
针对目标执行技能表格中列出的每个技能,执行以下操作:

2a. 스킬 SKILL.md 읽기

2a. 读取技能SKILL.md

해당 스킬의
.claude/skills/verify-<name>/SKILL.md
를 읽고 다음 섹션을 파싱합니다:
  • Workflow — 실행할 검사 단계와 탐지 명령어
  • Exceptions — 위반이 아닌 것으로 간주되는 패턴
  • Related Files — 검사 대상 파일 목록
读取对应技能的
.claude/skills/verify-<name>/SKILL.md
,解析以下部分:
  • Workflow — 需执行的检查步骤和检测命令
  • Exceptions — 视为合规的例外模式
  • Related Files — 待检查的文件列表

2b. 검사 실행

2b. 执行检查

Workflow 섹션에 정의된 각 검사를 순서대로 실행합니다:
  1. 검사에 명시된 도구(Grep, Glob, Read, Bash)를 사용하여 패턴 탐지
  2. 탐지된 결과를 해당 스킬의 PASS/FAIL 기준에 대조
  3. Exceptions 섹션에 해당하는 패턴은 면제 처리
  4. FAIL인 경우 이슈를 기록:
    • 파일 경로 및 라인 번호
    • 문제 설명
    • 수정 권장 사항 (코드 예시 포함)
按顺序运行Workflow部分定义的各项检查:
  1. 使用检查中指定的工具(Grep、Glob、Read、Bash)检测模式
  2. 将检测结果与该技能的PASS/FAIL标准对比
  3. 符合Exceptions部分的模式予以豁免
  4. 若为FAIL则记录问题:
    • 文件路径及行号
    • 问题描述
    • 修正建议(含代码示例)

2c. 스킬별 결과 기록

2c. 记录各技能结果

각 스킬 실행 완료 후 진행 상황을 표시합니다:
markdown
undefined
每个技能执行完成后,显示进度:
markdown
undefined

verify-<name> 검증 완료

verify-<name> 验证完成

  • 검사 항목: N개
  • 통과: X개
  • 이슈: Y개
  • 면제: Z개
[다음 스킬로 이동...]
undefined
  • 检查项:N项
  • 通过:X项
  • 问题:Y项
  • 豁免:Z项
[切换至下一个技能...]
undefined

Step 3: 통합 보고서

Step 3: 综合报告

모든 스킬 실행 완료 후, 결과를 하나의 보고서로 통합합니다:
markdown
undefined
所有技能执行完成后,将结果整合为一份报告:
markdown
undefined

구현 검증 보고서

实现验证报告

요약

摘要

검증 스킬상태이슈 수상세
verify-<name1>PASS / X개 이슈N상세...
verify-<name2>PASS / X개 이슈N상세...
발견된 총 이슈: X개

**모든 검증 통과 시:**

```markdown
모든 검증을 통과했습니다!

구현이 프로젝트의 모든 규칙을 준수합니다:

- verify-<name1>: <통과 내용 요약>
- verify-<name2>: <통과 내용 요약>

코드 리뷰 준비가 완료되었습니다.
이슈 발견 시:
각 이슈를 파일 경로, 문제 설명, 수정 권장 사항과 함께 나열합니다:
markdown
undefined
验证技能状态问题数详情
verify-<name1>PASS / X个问题N详情...
verify-<name2>PASS / X个问题N详情...
发现的总问题数:X个

**所有验证通过时:**

```markdown
所有验证已通过!

实现内容符合项目所有规则:

- verify-<name1>: <通过内容摘要>
- verify-<name2>: <通过内容摘要>

已准备好进入代码评审环节。
发现问题时:
列出每个问题的文件路径、问题描述及修正建议:
markdown
undefined

발견된 이슈

发现的问题

#스킬파일문제수정 방법
1verify-<name1>
path/to/file.ts:42
문제 설명수정 코드 예시
2verify-<name2>
path/to/file.tsx:15
문제 설명수정 코드 예시
undefined
#技能文件问题修正方法
1verify-<name1>
path/to/file.ts:42
问题描述修正代码示例
2verify-<name2>
path/to/file.tsx:15
问题描述修正代码示例
undefined

Step 4: 사용자 액션 확인

Step 4: 确认用户操作

이슈가 발견된 경우
AskUserQuestion
을 사용하여 사용자에게 확인합니다:
markdown
---
若发现问题,使用
AskUserQuestion
向用户确认:
markdown
---

수정 옵션

修正选项

X개 이슈가 발견되었습니다. 어떻게 진행할까요?
  1. 전체 수정 - 모든 권장 수정사항을 자동으로 적용
  2. 개별 수정 - 각 수정사항을 하나씩 검토 후 적용
  3. 건너뛰기 - 변경 없이 종료
undefined
发现X个问题。请选择后续操作:
  1. 全部修正 - 自动应用所有建议的修正内容
  2. 逐个修正 - 逐一检查并确认每个修正内容后应用
  3. 跳过 - 不做任何更改直接结束
undefined

Step 5: 수정 적용

Step 5: 应用修正

사용자 선택에 따라 수정을 적용합니다.
"전체 수정" 선택 시:
모든 수정을 순서대로 적용하며 진행 상황을 표시합니다:
markdown
undefined
根据用户选择应用修正。
选择"全部修正"时:
依次应用所有修正并显示进度:
markdown
undefined

수정 적용 중...

正在应用修正...

  • [1/X] verify-<name1>:
    path/to/file.ts
    수정 완료
  • [2/X] verify-<name2>:
    path/to/file.tsx
    수정 완료
X개 수정 완료.

**"개별 수정" 선택 시:**

각 이슈마다 수정 내용을 보여주고 `AskUserQuestion`으로 승인 여부를 확인합니다.
  • [1/X] verify-<name1>:
    path/to/file.ts
    修正完成
  • [2/X] verify-<name2>:
    path/to/file.tsx
    修正完成
已完成X项修正。

**选择"逐个修正"时:**

针对每个问题显示修正内容,通过`AskUserQuestion`确认是否应用。

Step 6: 수정 후 재검증

Step 6: 修正后重新验证

수정이 적용된 경우, 이슈가 있었던 스킬만 다시 실행하여 Before/After를 비교합니다:
markdown
undefined
若已应用修正,仅重新运行存在问题的技能,对比修正前后的结果:
markdown
undefined

수정 후 재검증

修正后重新验证

이슈가 있었던 스킬을 다시 실행합니다...
검증 스킬수정 전수정 후
verify-<name1>X개 이슈PASS
verify-<name2>Y개 이슈PASS
모든 검증을 통과했습니다!

**여전히 이슈가 남은 경우:**

```markdown
重新运行存在问题的技能...
验证技能修正前修正后
verify-<name1>X个问题PASS
verify-<name2>Y个问题PASS
所有验证已通过!

**仍存在问题时:**

```markdown

잔여 이슈

剩余问题

#스킬파일문제
1verify-<name>
path/to/file.ts:42
자동 수정 불가 — 수동 확인 필요
수동으로 해결한 후
/verify-implementation
을 다시 실행하세요.

---
#技能文件问题
1verify-<name>
path/to/file.ts:42
无法自动修正 — 需手动检查
请手动解决后重新运行
/verify-implementation

---

예외사항

例外情况

다음은 문제가 아닙니다:
  1. 등록된 스킬이 없는 프로젝트 — 오류가 아닌 안내 메시지를 표시하고 종료
  2. 스킬의 자체적 예외 — 각 verify 스킬의 Exceptions 섹션에 정의된 패턴은 이슈로 보고하지 않음
  3. verify-implementation 자체 — 실행 대상 스킬 목록에 자기 자신을 포함하지 않음
  4. manage-skills
    verify-
    로 시작하지 않으므로 실행 대상에 포함되지 않음
以下情况不属于问题:
  1. 无已注册技能的项目 — 显示提示信息而非错误,随后结束
  2. 技能自身的例外规则 — 各verify技能Exceptions部分定义的模式不会被报告为问题
  3. verify-implementation自身 — 不会将自身纳入目标执行技能列表
  4. manage-skills — 因不以
    verify-
    开头,不会被纳入目标执行技能

Related Files

相关文件

FilePurpose
.claude/skills/manage-skills/SKILL.md
스킬 유지보수 (이 파일의 실행 대상 스킬 목록을 관리)
CLAUDE.md
프로젝트 지침
文件用途
.claude/skills/manage-skills/SKILL.md
技能维护(管理本文件的目标执行技能列表)
CLAUDE.md
项目指南