分享一个自用 code-style-review skill

之前分享了一个自用的 docx-format skill, 发现能帮到不少佬友。在此分享一个自己更常用的 SKILL：code-style-review. 原理是把我平常的代码风格沉淀下来作为 SKILL：绝对避免防御性编程、绝对避免复杂性编程。感兴趣的佬友们可以二次开发反馈～

code-style-review.zip (6.1 KB)

贴一下 SKILL.md 文档：

---
name: code-style-review
description: Python code style guide for clean, maintainable code. Use when writing or reviewing Python code.
---

# Python Code Style Guide

## 必须 (Must)

### Naming
- Classes: `PascalCase` (e.g., `DataLoader`, `ConfigManager`)
- Functions/methods: `snake_case` with verb-first (e.g., `load_data`, `process_batch`)
- Constants: `UPPER_CASE` (e.g., `MAX_RETRIES`, `DEFAULT_TIMEOUT`)
- Math operations: single-letter variables allowed (N, D, x, y)

### Exception Handling
- Fail-fast: no defensive try/except, let errors crash early
- Use `logger.warning()` for recoverable issues, not exceptions

### Code Philosophy
- No over-engineering; keep it simple
- Comments in English only
- Follow Occam's Razor: no unnecessary complexity

## 尽量 (Should)

### Comments & Docs
- Minimal docstrings; only for complex logic
- Explain "why", not "what"
- Self-explanatory code needs no comments

### Imports
- Order: stdlib → third-party → local (blank lines between)
- Prefer absolute imports
- Explicit names, avoid `import *`

### Function Design
- Explicit parameters; avoid `**kwargs`
- Multiple returns: use tuple
- Avoid hidden global state

### Code Organization
- Layered architecture: low-level → high-level
- OOP for core logic
- Separation of concerns

### Aesthetics
- Clean alignment and simple naming
- Colorful output / progress bars for UX
- Use `logging` module

## 可选 (Optional)

### Type Annotations
- Python 3.10+ syntax: `list[int]`, `X | None`
- Annotate public methods and return types

### Assert
- Use sparingly for invariants; don't overuse

### Logging
- Optionally write logs to file (ask user first)

## 加分项 (Nice to Have)

### Data Structures
- Use `@dataclass` for configs
- Prefer simple containers (list, dict)

---

## Code Review (Codex)

All code review is delegated to Codex. Claude should NOT run scripts directly.

When invoking, Claude MUST replace placeholders with absolute paths:
- `{SKILL_DIR}` → absolute path to this skill directory (e.g., `/Users/xxx/.claude/skills/code-style-review`)
- `{TARGET}` → absolute path to file(s) or directory to review (supports multiple files or recursive directory scan)

```bash
codex exec -m gpt-5.2 \
  -c model_reasoning_effort="xhigh" \
  --dangerously-bypass-approvals-and-sandbox \
  --skip-git-repo-check \
  "You are a code style reviewer. Review the Python code for style compliance.

## Paths (absolute)
- Skill directory: {SKILL_DIR}
- Target to review: {TARGET}

## Setup (run once if tools missing)
bash {SKILL_DIR}/setup.sh

## Your Tasks
1. Read the style guide: cat {SKILL_DIR}/skill.md
2. Run automated linter: ruff check --config {SKILL_DIR}/ruff.toml {TARGET}
3. Run custom checker: python3 {SKILL_DIR}/style_check.py {TARGET}
4. Read and analyze the target code
5. Combine automated results with your own analysis

## Output Format
Provide a structured review:
- **Summary**: Overall assessment (pass/needs work/fail)
- **Automated Issues**: List violations from ruff and style_check.py
- **Manual Review**: Issues requiring human judgment (over-engineering, naming clarity, code aesthetics)
- **Suggestions**: Specific, actionable improvements with code examples

## Priority Levels
- 必须 (Must): Violations are errors, must fix
- 尽量 (Should): Violations are warnings, should fix
- 可选 (Optional): Suggestions for improvement
- 加分项 (Nice to Have): Optional enhancements" 2>/dev/null

3 posts - 3 participants

Read full topic

via LINUX DO - 最新话题 (author: smart-lty)

Cherry Studio上面的小程序tab标签页只能打开3个

如图

当我再添加一个小程序以后, 就会覆盖最前面的tab标签页
有佬遇到这个问题吗, 能解决吗? 我想多打开几个, 同时使用
1 post - 1 participant

Read full topic

via LINUX DO - 最新话题 (author: 白骆驼)

Invalid media: image

茅台 青龙脚本问题

茅台青龙脚本，有佬知道这是怎么回事吗，咋解决呀
1 post - 1 participant

Read full topic

via LINUX DO - 最新话题 (author: shixuan)

Invalid media: image

赛博AI炒股半个月收益以及分析

和前女友分手后，无心他事，自己学习炒股，本金5000，半个月小赚400

常用炒股助手

1. Google AI stuido 相较于网页，幻觉会减少，且会实时搜索，但是它会乱说！！！如果你上文了说了非农，下文分析其他股票它会强行关联到非农的影响，除非新开一个话题。
2. Chatgpt 用的k12版本，不太行，但是GPT一点好就是不会瞎说，它会根据新闻资讯来判断，但是很少做出前瞻性建议和判断。
3. Grok 我常用来进行新闻真伪判断，结合新闻询问AI

总得来说AI作为助手，比我自己瞎炒股靠谱点，是一个很好的帮手。下面有我自己的写的propmt。一半自己资讯分析一半运气，AI也是能扩大你了解到的资讯，它会抓取到你没注意到的一些信息。

块引用1. 你是一位拥有实时联网能力的资深金融分析师。
1. 【核心指令】：
2. 强制联网 (Must Search)：对于我询问的任何股票、指数、汇率或新闻，你必须第一时间调用搜索工具查询此时此刻的最新价格、涨跌幅和相关新闻。
1. 我要求联网搜索，enable websearch tool，抓取当前尽可能多的信息，搜索中国（政府网站、东方财富网、雪球网、同花顺、金十财经、微信公众号、网络文章、抖音、小红书等等）、国际上的内外的消息进行分析，不限制数量，可以结合外媒权威的报道进行交叉判断信息的真实性，越详细越权威越好，不要自己乱推理，有数据支撑，不要有太多的感情因素。
3. 数据校验 (Verify)：不要依赖你的训练数据，也不要盲目相信我上传文件中的过时/未来日期。一切以Google/Bing搜索到的最新实时数据为准。
1. enable websearch tool，联网搜索当前日期，并以实时获取的日期当作最新的锚点，实时获取我问的股票、黄金、白银的价格，要多次从不同渠道和资讯验证获取其正确的盘面价格。
1. 如果我给出股票价格以及当前时间以我给出的为准进行分析，可能包含涨停等词语，也需要进行分析。
5. 时间锚定 (Time Anchor)：在回答开头，请务必标注你搜索到的**“当前北京时间”和“最新价格”**，并附上来源链接。请忽略所有非实时的预设背景，直接搜索最新数据并分析
6. 并对适合抄底的时机做出判断和建议，以及对我所询问的，给出前瞻性的建议，包括抄底、逃离等，持仓观望、空仓观望等等。
1. 给出是否建议抄底，如不建议给出理由，如建议也要给出理由
2. 给出利空和利好的消息，如果没有相应的消息，可以说没有
4. 如果问的是A股市场中的股票，需要结合资讯，给出当前热门的板块和行业，以及这些行业的利好或者利空消息。
7. 在返回最终答复之前，请根据用户的原始约束条件审查您生成的输出。我是否回答了用户的意图，而不仅仅是字面意思？
8. 中英文对照生成prompt，让Gemini更好的理解进而来减少幻觉。以及最后要求中文回答 优化一下上述的prompt

13 posts - 9 participants

Read full topic

via LINUX DO - 最新话题 (author: yueshiMC)

你们觉得 人工智能 应该达到什么水平才算AGI

4 posts - 4 participants

Read full topic

via LINUX DO - 最新话题 (author: Fake)

站里有没有好用的cc中转站

佬友们好，求推荐一个好用稳定的cc中转站？日常开发使用 🤩

4 posts - 4 participants

Read full topic

via LINUX DO - 最新话题 (author: 天畅)

怎么才周一啊，等下班

好困，不想上班……每天中午都不知道吃啥，我根本不想出门。

2 posts - 2 participants

Read full topic

via LINUX DO - 最新话题 (author: SZY)

现在古法开发是不是要淘汰了，什么agent，skills来了，古法开发该如何破局呀

谁还在手搓代码呀

5 posts - 5 participants

Read full topic

via LINUX DO - 最新话题 (author: SIX_MAN)

Invalid media: image

QQ音乐是不是把我当pcdn了

今早忽然发现qq音乐的上传流量很高，比我听歌的都高，就很奇怪

又发现了这个，这是不是把我当pcdn了 🤣
4 posts - 3 participants

Read full topic

via LINUX DO - 最新话题 (author: williamye)

Invalid media:
image
image

chatgpt的apple music应用有人使用过吗，要怎么获提供给ChatGPT信息呀

我的chatgpt上已经绑定apple music了，但是chatgpt似乎什么上下文都获取不了，我把我的歌单分享链接发给ChatGPT他回答的驴唇不对马嘴的

1 post - 1 participant

Read full topic

via LINUX DO - 最新话题 (author: Alan xtl)

Invalid media: image

被广告公司Google坑了,建议不要购买pixel

买了一台美版的pixel手机,没有root,Android 16(最新版本)

0、家里搭建旁路由,落地鸡AT&T家用宽带,4%纯净度
1、PC购买AT&T eSIM手机卡,pixel扫码下载eSIM,成功激活
2、pixel恢复出厂设置(保留eSIM),英文
3、关闭位置、国家选择US,关闭wifi,使用AT&T漫游手机网络+新手机号注册新的Google账号
4、美区Google player下载ebay
5、使用AT&T新手机号注册ebay,注册完成后发现国家默认为china,10分钟后账户被锁
6、使用AT&T新手机号注册Google voice,注册成功,但选择虚拟号码号码一直不成功

我严重怀疑是pixel手机的问题,是Google描判定了我的位置,并共享给了app.

问了Gemini,结论是eBay/Google读取手机的 TelephonyManager API。

但是iPhone 的 App 权限与 Android 完全不同,普通的第三方 App没有权限获取类似 Android TelephonyManager 这种能够读取“基站 ID (Cell ID)”或“位置区码 (LAC)”的底层数据

说到底,Google是广告公司,对用户的信息保护没有apple认真. 毁了我一张手机卡

3 posts - 2 participants

Read full topic

via LINUX DO - 最新话题 (author: 萨蛮)

antigravity 省着用也被 3d 了

一直在这样省着用，没想到也被砍了。看来得买号了
分享一个 antigravity 实践使用小技巧 开发调优

经过尝试发现只能手动，设置workflow也没有大用处

1 post - 1 participant

Read full topic

via LINUX DO - 最新话题 (author: haidao)

Invalid media: image

目前上门维修还有什么平台能选吗？

家里燃气灶最近出问题了，想找个靠谱的上门维修，想问问大家有没有推荐。

1 post - 1 participant

Read full topic

via LINUX DO - 最新话题 (author: Dor)

关于“ASDF”类别

（将第一段替换为新类别的简要说明。此指导将显示在类别选择区域中，因此请尽量将其保持在 200 个字符以内。）

使用以下段落提供详细描述或者建立类别准则或规则：

● 为什么应使用此类别？它用来做什么？
● 此类别和我们已经有的类别究竟有什么不同？
● 此类别中的话题一般包含什么？
● 我们需要此类别吗？我们可以将其与其他类别或子类别合并吗？

1 post - 1 participant

Read full topic

via LINUX DO - 最新话题 (author: Neo)

【富可敌国】Augmunt已逐步恢复Claude供应（Claude/CodeX/Gemini）

各位亲：

周五-周日，因为Claude供应的问题，我们下架了大部分的充值套餐。

现在我们已经逐步恢复CC供应，但是为了避免大家期望过高，我们压力太大，所以依然提醒各位用户，谨慎充值。

这个帖子还没有满，大家依然可以冲，抓紧：

【富可敌国】Augmunt 新用户活动，前四百楼站点新用户都送10刀，仅限新用户(Claude/CodeX/Gemini)

4 posts - 4 participants

Read full topic

via LINUX DO - 最新话题 (author: triplekillgod)

鼠标垫推荐，有啥说法吗

RT。鼠标垫佬子们有推荐的不。 😍
要大块的。
以前是用的送的，容易脏和发霉。 🤧
看了皮革类的，网图看着不错，实际不知道咋样。 🤧

27 posts - 16 participants

Read full topic

via LINUX DO - 最新话题 (author: kingstacker)

老倔驴低费率证券开户已帮助千人，10元京东卡中奖率 20%【无限抽】

回帖抽奖，成语接龙或者投资问题。每10楼抽2个10元京东卡，上不封顶(官方抽奖工具)

关于老倔驴

老倔驴开户 聚合几十家券商优惠，连接上百家营业部，已帮助上千人，无一差评，简单实在，负责到底。
不开户也可以免费答疑。。

----------------------

如何开户

详细&开户链接: https://jue.lv/kh/LD/202601b 👈️ 👈️ 👈️
(点这里过去，有二维码加上就能开，好多私信我怎么开户？，这里！这里！这里！)

----------------------

那么多券商怎么选？

1. 只玩 ETF 的聪明钱 YH ETF 万 0.5 ，适合大多数散户，宽指 ETF+逆回购+打新，朋友也是推荐这家，过去一年朋友纳指收益躺赚 20%，我不听劝一番折腾没亏没赚。
2. 低门槛 有点拉跨，需要排队等等，一周后能缓解；
3. miniqmt 申w需要50w；
4. 50万+的大佬们 国T国X万0.8免五，各项费率都很优秀。
5. 两融银河广发平安： 50w-3.5%，100w-3.3%,200w-3.2%,700w-2.88%,2000w-2.6%
6. Lof套利 拖拉机首推银河lof申购 1折赎回 5 折，次选华宝，都可以开拖拉机，前一端白银 lof 套利让不少赚了几千，收益 60%；
7. VIP通道上线50人，万0.76，ptrade 5万门槛ptrade适合量化学习；另外，渣打远程开港卡，港美复星可选；

不因奖品而涉足股市，得不偿失

14 posts - 12 participants

Read full topic

via LINUX DO - 最新话题 (author: Ericlin)

Invalid media: image

请教一个关于n8n使用gemini请求规范的错误问题

请教大家一个问题：

我想在n8n中使用gemini模型，在添加渠道后，可以通过链接测试。但是在流程中请求却出现了这个错误提示

Unexpected token '<', "<!DOCTYPE "... is not valid JSON

而我在Cherry studio里面通过这种方式设置确是可以正常请求的。所以可以证明API端是没有问题。

2 posts - 2 participants

Read full topic

via LINUX DO - 最新话题 (author: Google)

Invalid media:
image
image
image
image

始皇又在搞装修了，让我们看看怎么个事

关于“ASDF”类别ASDF

（将第一段替换为新类别的简要说明。此指导将显示在类别选择区域中，因此请尽量将其保持在 200 个字符以内。） 使用以下段落提供详细描述或者建立类别准则或规则： 为什么应使用此类别？它用来做什么？ 此类别和我们已经有的类别究竟有什么不同？ 此类别中的话题一般包含什么？ 我们需要此类别吗？我们可以将其与其他类别或子类别合并吗？

9 posts - 5 participants

Read full topic

via LINUX DO - 最新话题 (author: 9C)

Invalid media: image

目前有这种设备吗，想买一个

8 posts - 6 participants

Read full topic

via LINUX DO - 最新话题 (author: 韩宇栋)

Invalid media: image

windows用什么码农工具

有佬跟我一样是用windows的么？ 我现在都是用windows的cmd工具来用cc和codex这些。但是发觉挺多问题的，本身cmd就比较多问题，用得很不舒服。也试过用docker来部署一个linux来用，但是也是用得不畅快。是不是应该搞一个cursor客户端来用？如何配置自定义的模型？

15 posts - 11 participants

Read full topic

via LINUX DO - 最新话题 (author: 江畔明月风)