技能 kaizen
📦

kaizen

安全

코드 품질 개선을 위한 카이젠 방법론 적용

소프트웨어 팀은 일관성 없는 코드 품질과 사후적 오류 처리로 어려움을 겪습니다. 이 스킬은 지속적 개선, 오류 방지 설계, 표준화된 패턴 추종을 위한 구조화된 카이젠 방법론을 제공합니다.

支持: Claude Codex Code(CC)
🥉 74 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“kaizen”。 주문 합계를 계산하는 이 함수를 개선하기 위해 카이젠 적용

预期结果:

  • 반복 1 - 입력 검증 추가: 계산 전 null/빈 items 배열 및 음수 가격 확인. 런타임 오류를 방지합니다.
  • 반복 2 - 가독성 개선: 더 명확한 의도를 위해 for-loop 를 reduce() 로 교체. 타입 서명는 명시적으로 number 를 반환합니다.
  • 반복 3 - 오류 메시지 추가: 실패를 무시하는 대신 유효하지 않은 입력에 대해 설명적인 오류를 발생시킵니다. 각 반복은 테스트되었고 작동합니다.

正在使用“kaizen”。 포카요케를 사용하여 오류 방지 Order 타입 설계

预期结果:

  • 간단한 객체와 문자열 상태 대신, 각 주문 상태가 필요한 데이터를 가진 식별된 유니온 타입을 사용합니다.
  • 보류 중인 주문은 createdAt 타임스탬프가 필요합니다. 발송된 주문은 trackingNumber 가 필요합니다. 배달된 주문은 서명이 필요합니다.
  • 타입 시스템은 추적 정보 없이 발송된 주문을 가질 수 없게 만듭니다. 컴파일 오류는 버그의 전체 클래스를 방지합니다.

安全审计

安全
v1 • 2/25/2026

This skill is a documentation-only guide for Kaizen software development methodology. Static analysis flagged 73 patterns in code examples within markdown documentation, but all findings are false positives. The backtick operators are TypeScript template literals (not shell commands), fetch calls are educational examples (not actual network requests), and environment variable references teach secure validation practices. No executable code exists in this skill.

1
已扫描文件
733
分析行数
3
发现项
1
审计总数
低风险问题 (3)
External Command Pattern (False Positive)
Static analyzer detected 44 instances of backtick operators. These are TypeScript template literals used for string interpolation in code examples (e.g., `/users/${id}`), not Ruby/shell command execution. The skill contains documentation only with no executable code.
Network Pattern (False Positive)
Static analyzer detected fetch API calls and hardcoded URLs. These are educational code examples demonstrating proper API client patterns. The URLs are example placeholders (api.example.com), not actual external endpoints.
Environment Access Pattern (False Positive)
Static analyzer detected environment variable access and potential secret exposure. Line 304-306 shows educational content teaching secure config validation - specifically demonstrating how to throw errors when API_KEY is missing.
审计者: claude

质量评分

38
架构
100
可维护性
87
内容
50
社区
99
安全
91
规范符合性

你能构建什么

코드 리뷰 개선

코드 리뷰 중 카이젠 원칙을 적용하여 완전한 재작성을 요구하기보다 작고 점진적인 개선을 제안합니다. 각 제안은 다음으로 넘어가기 전에 검증되고 테스트됩니다.

오류 방지 API 설계

포카요케 기법을 사용하여 컴파일 시간에 유효하지 않은 상태를 표현할 수 없도록 TypeScript API 를 설계합니다. 타입 시스템이 런타임 전에 오류를 감지합니다.

레거시 코드 리팩토링

반복적 개선 접근 방식을 적용합니다: 작동하게 만들기, 명확하게 만들기, 효율적으로 만들기. 각 반복은 다음 단계로 진행하기 전에 완료되고 테스트됩니다.

试试这些提示

기본 코드 개선
이 함수를 검토하고 카이젠 원칙에 따라 하나의 작은 개선을 제안하세요. 이 변경이 품질을 어떻게 개선하는지 설명하고 다른 것을 제안하기 전에 작동하는지 검증하세요.
오류 방지 설계
포카요케 원칙을 사용하여 이 API 인터페이스를 분석하세요. TypeScript 타입을 사용하여 유효하지 않은 상태를 표현할 수 없도록 하는 방법을 보여주세요. 타입 정의와 함께 전후 예시를 제공하세요.
패턴 표준화
이 코드베이스에 새 기능을 추가하고 있습니다. [기능 유형] 에 대한 기존 코드 패턴을 분석하고 동일한 표준화된 접근 방식을 따라 새 기능을 구현하는 방법을 보여주세요. 코드베이스의 구체적인 예시를 가리켜주세요.
YAGNI 리팩토링
이 코드를 YAGNI 위반 사항에 대해 검토하세요. '만약을 대비한' 기능, 시기상조의 추상화, 사용되지 않는 복잡성을 식별하세요. 각 문제에 대해 현재 요구사항을 충족하는 가장 단순한 버전을 보여주고 무엇을 삭제해야 하는지 설명하세요.

最佳实践

  • 품질을 개선하는 가장 작은 실행 가능한 변경을 수행하고 작동하는지 검증한 후 다음 개선으로 진행
  • 시스템 경계에서 입력과 구성을 검증하고 명확한 오류 메시지와 함께 빠르게 실패
  • 일관성을 위해 기존 코드베이스 패턴을 따름. 팀이 동의하고 상당히 더 나은 경우에만 새 패턴 도입

避免

  • 점진적 개선 대신 대규모 리팩토링 프로젝트 시도
  • 여러 검증된 사용 사례가 있기 전에 제너릭 프레임워크나 추상화 구축
  • 실제 성능 문제를 측정하지 않고 '만약을 대비한' 기능 추가 또는 최적화

常见问题

완전한 재작성 대신 카이젠을 언제 사용해야 하나요?
카이젠은 대부분의 개선에 적합합니다. 재작성은 거의 정답이 아닙니다. 큰 문제를 작고 테스트 가능한 개선으로 나누세요. 각 반복은 코드를 이전보다 작동하고 더 좋은 상태로 만들어야 합니다.
동적 타입 언어에서 포카요케를 어떻게 적용하나요?
경계에서 런타임 검증, 어설션 함수, 브랜디드 타입을 사용하세요. 컴파일 타임 확인만큼 강력하지는 않지만 명확한 오류를 통한 조기 검증은 여전히 많은 프로덕션 문제를 방지합니다.
우리 팀에 확립된 패턴이 없다면 어떻게 하나요?
작동하는 코드에서 관찰한 패턴을 문서화하는 것부터 시작하세요. 기존 성공 패턴을 기반으로 표준을 제안하세요. 동의가 되면 린터와 타입 체크를 사용하여 자동화된 강제 실행을 구현하세요.
추상화가 시기상조인지 어떻게 알 수 있나요?
3 의 법칙을 기다리세요: 세 다른 곳에서 동일한 패턴을 세 번 구현한 후 추상화하세요. 중복은 잘못된 추상화보다 저렴합니다. 추상화는 검증된 패턴에서 나와야 합니다.
카이젠이 짧은 마감일에도 작동할 수 있나요?
네. 작은 개선은 큰 재작성보다 빠릅니다. 가장 영향력 높은 변경에 먼저 집중하세요. 반복적 접근 방식은 마감일 압박 하에 깨진 코드의 위험을 줄입니다.
카이젠 방법론을 지원하는 도구는 무엇인가요?
컴파일 타임 오류 방지를 위한 TypeScript, 표준화된 포매팅을 위한 ESLint/Prettier, 각 반복에서 검증을 위한 테스트 프레임워크, 자동화된 품질 게이트를 위한 CI/CD.

开发者详情

文件结构

📄 SKILL.md