القائمة
Continue.dev 编程基础规则合集（基础：代码规范、中文注释、不啰嗦）。触发条件：代码编写规范、命名约定、函数设计、注释规范、代码整洁、SOLID原则、错误处理。
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/drgon1/santian --skill awesome-rulesيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
عرض SKILL.md
| name | awesome-rules |
| description | Continue.dev 编程基础规则合集（基础：代码规范、中文注释、不啰嗦）。触发条件：代码编写规范、命名约定、函数设计、注释规范、代码整洁、SOLID原则、错误处理。 |
核心原则：本Skill整合 continuedev/awesome-rules 仓库的核心编程基础规范，包含代码规范、注释规范、代码整洁三大模块。
使用对象：需要统一编码风格、规范注释、保持代码整洁的AI模型。
强制要求：编写代码时严格遵循命名规范、函数设计原则、注释规范，不自行发明风格。
以下任一关键词或场景出现时，自动启用本Skill：
| 触发场景 | 典型需求 |
|---|---|
| 代码编写 | "写个Python脚本"、"编写函数"、"实现功能" |
| 命名规范 | "变量命名"、"函数命名"、"类命名" |
| 注释规范 | "加注释"、"文档字符串"、"代码说明" |
| 代码整洁 | "整理代码"、"clean code"、"重构美化" |
| 代码审查 | "Review代码"、"检查代码质量"、"代码规范" |
| SOLID原则 | "符合SOLID"、"面向对象设计"、"设计原则" |
非触发场景（不启用本Skill）：
来源：continuedev/awesome-rules - coding-standards
# 好
MAX_RETRY_ATTEMPTS = 3
user_authentication_token = generate_token()
def calculate_compound_interest(principal, rate, time): ...
# 不好
max = 3
tkn = generate_token()
def calc(p, r, t): ...
# 好
def calculate_order_total(items):
if not items:
return Decimal('0.00')
subtotal = sum(item.price * item.quantity for item in items)
return apply_taxes(subtotal)
# 不好
def process(data):
# 200行的混合逻辑
# 多个职责
# 隐藏的副作用
project/
├── src/
│ ├── controllers/
│ ├── services/
│ ├── models/
│ ├── utils/
│ └── config/
├── tests/
├── docs/
└── scripts/
def divide_numbers(dividend, divisor):
if divisor == 0:
raise ValueError('除数不能为零')
if not isinstance(dividend, (int, float)):
raise TypeError('被除数必须是数字')
return dividend / divisor
| 原则 | 要点 |
|---|---|
| 单一职责 | 一个类只有一个改变理由 |
| 开闭原则 | 对扩展开放，对修改关闭 |
| 里氏替换 | 子类型必须可替换其基类型 |
| 接口隔离 | 多个专用接口优于一个通用接口 |
| 依赖反转 | 依赖抽象，不依赖具体实现 |
来源：continuedev/awesome-rules - code-comments
# 使用指数退避避免高峰时段压倒API
# （参见事故报告 #1234）
delay = min(1000 * pow(2, retry_count), 30000)
# WORKAROUND: Chrome bug #123456 需要显式设置高度
# Chrome 120+ 采用率达95%后移除
element.style.height = 'auto'
# TODO(john): 实现网络失败的重试逻辑
# TODO(security): v2.0 发布前添加限流
# FIXME: 处理用户有多个账户时的边缘情况
# HACK: 临时修复，数据库迁移完成后移除
# 不好：显而易见的注释
# 计数器加1
counter += 1
# 不好：过时的注释
# 给用户发邮件（实际上现在发的是短信）
await notification_service.send(user)
# 不好：无上下文的注释掉的代码
# user.set_status('active')
# user.save()
def process_transaction(transaction):
"""
处理金融交易，包含欺诈检测和验证。
此方法在执行前进行多项检查：
1. 验证交易格式和必填字段
2. 检查欺诈检测规则
3. 验证账户余额和限额
4. 通过支付网关处理
Args:
transaction: 包含支付细节的交易对象
Returns:
ProcessResult，包含状态和错误信息
Raises:
ValidationError: 交易格式无效时
InsufficientFundsError: 账户余额不足时
Note:
超过$10,000的交易需要额外验证
"""
来源：continuedev/awesome-rules - clean-code
评估每个类/函数：
警告信号：
单一职责原则（SRP）：
开闭原则（OCP）：
里氏替换原则（LSP）：
接口隔离原则（ISP）：
依赖反转原则（DIP）：
استنادا إلى تصنيف SOC المهني