📦

kaizen

آمن

应用 Kaizen 方法提升代码质量

软件团队难以保持代码质量的一致性,常常被动地处理错误。本技能提供了一套结构化的 Kaizen 方法论,用于持续改进、错误预防设计和遵循标准化模式。

يدعم: Claude Codex Code(CC)
🥉 74 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "kaizen". 应用 Kaizen 改进这个计算订单总额的函数

النتيجة المتوقعة:

  • 迭代 1 - 添加输入验证:在计算前检查 null/空 items 数组和负价格。这可以防止运行时错误。
  • 迭代 2 - 提高可读性:用 reduce() 替换 for 循环以表达更清晰的意图。类型签名明确返回 number。
  • 迭代 3 - 添加错误消息:为无效输入抛出描述性错误而不是静默失败。每次迭代都经过测试并能正常工作。

استخدام "kaizen". 使用 Poka-Yoke 设计一个无错误的 Order 类型

النتيجة المتوقعة:

  • 不要使用简单的对象和字符串 status,使用可辨识联合类型,使每个订单状态都有其必需的数据。
  • 待处理订单需要 createdAt 时间戳。已发货订单需要 trackingNumber。已交付订单需要 signature。
  • 类型系统使得不可能有没有跟踪信息的已发货订单。编译错误可以防止整类 bug。

التدقيق الأمني

آمن
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
الامتثال للمواصفات

ماذا يمكنك بناءه

代码审查改进

在代码审查中应用 Kaizen 原则,建议小的渐进式改进,而不是要求完全重写。每条建议在继续下一步之前都要经过验证和测试。

抗错误 API 设计

使用 Poka-Yoke 技术设计 TypeScript API,使无效状态在编译时无法表示。类型系统在运行前就能捕获错误。

重构遗留代码

应用迭代优化方法:使其工作、使其清晰、使其高效。每次迭代在进入下一步之前都是完整且经过测试的。

جرّب هذه الموجهات

基础代码改进
审查这个函数并根据 Kaizen 原则提出一个小的改进建议。解释为什么这个改进能提升质量,并在建议其他内容之前验证它能正常工作。
错误预防设计
使用 Poka-Yoke 原则分析这个 API 接口。展示如何使用 TypeScript 类型使无效状态无法表示。提供带有类型定义的改进前后示例。
模式标准化
我要为这个代码库添加一个新功能。分析 [功能类型] 的现有代码模式,并展示如何按照相同的标准化方法实现新功能。指向代码库中的具体示例。
YAGNI 重构
检查此代码中的 YAGNI 违规情况。识别任何"以防万一"的功能、过早的抽象或未使用的复杂性。对于每个问题,展示满足当前需求的最简版本,并解释要删除什么。

أفضل الممارسات

  • 进行最小可行的改进,验证它能正常工作,然后继续下一步改进
  • 在系统边界验证输入和配置,快速失败并提供清晰的错误消息
  • 遵循现有代码库模式以保持一致性。只有在明显更好且团队同意时才引入新模式

تجنب

  • 试图进行大型重构项目而不是渐进式改进
  • 在有多个经过验证的用例之前构建通用框架或抽象
  • 添加"以防万一"的功能或在没有测量实际性能问题的情况下进行优化

الأسئلة المتكررة

什么时候应该使用 Kaizen 而不是进行完全重写?
Kaizen 适用于大多数改进。重写很少是正确答案。将大问题分解成小的、可测试的改进。每次迭代都应该让代码保持正常工作且比之前更好。
如何在动态类型语言中应用 Poka-Yoke?
在边界处使用运行时验证、断言函数和标记类型。虽然不如编译时检查强大,但带有清晰错误的早期验证仍然可以防止许多生产问题。
如果我的团队没有已建立的模式怎么办?
首先记录你在可工作代码中观察到的模式。基于现有成功模式提出标准。一旦达成一致,使用 linter 和类型检查来自动化执行。
如何判断抽象是否过早?
等待三次法则:在不同地方实现相同模式三次,然后抽象。重复比错误的抽象更便宜。抽象应该从经过验证的模式中产生。
Kaizen 能在紧迫的期限内工作吗?
可以。小的改进比大型重写更快。首先关注影响最大的更改。迭代方法减少了在截止期限压力下代码被破坏的风险。
什么工具支持 Kaizen 方法论?
TypeScript 用于编译时错误预防,ESLint/Prettier 用于标准化格式化,测试框架用于每次迭代的验证,CI/CD 用于自动化质量门禁。

تفاصيل المطور

المؤلف

sickn33

الترخيص

MIT

مرجع

main

بنية الملفات

📄 SKILL.md