project-reading
目标
把“看一个好项目”变成“提炼出可迁移的做法”。
适用场景
- 阅读优秀开源项目
- 研究某个 repo 的结构与实现
- 想借鉴别人做法但不想盲目照搬
不适用
- 自己已有项目的日常推进和收敛
- 直接启动一个新 repo 或第一版原型
工作方式
- 先明确这次阅读的学习目标。
- 找关键切面:目录结构、核心抽象、边界划分、工具链、演进痕迹。
More from zrr1999/skills
unix-software-design
适用于软件设计、架构拆分、边界划分、接口规划、复杂度控制等场景。只要任务核心是“怎么把系统设计得更简单、更透明、更可组合”,就应参考。
34tech-preferences
适用于技术选型、架构规划、工具推荐、重构方向判断、开新坑定栈等场景。只要任务里出现“该选什么”“什么更适合我”“要不要换工具/框架”这类问题,就应先使用。
23modern-stack
个人现代化技术栈说明。在进行任何规划或实现功能、搭建项目脚手架、写示例代码或 CI/自动化配置等任务时,优先按照这里提供的内容来思考和生成方案。
13agent-cli-toolkit
终端取证与 CLI 自动化优先:用 rg/fd、bat、sd、delta/difft、http/jq、fzf、hyperfine、dust/duf/procs/btm、gh/gh-llm、x/vp/bun/uv;多窗格/命名会话/长时并行或 layout 用 zellij。应在用户或任务出现「终端/命令行/shell/CLI」「在机器上跑/验证」「搜仓库/找文件」「看 diff 或 JSON」「查 PR/Issue/GitHub」「磁盘/进程/性能对比」「并行跑多个服务或测试」「tmux 式多会话」或 agent 需用上述工具链而非仅靠编辑器时加载。
12maintenance-pass
适用于“维护老坑”“接着做下去”“修一下这个 repo”“挑下一步最值得做的点”“这个项目有点乱先帮我收一收”这类任务。只要重点是基于现状继续向前,而不是从零设计,就应使用。
7modern-python
用现代 Python 工具链(uv、ruff、ty)初始化或改造项目:生成/调整 pyproject.toml、本地检查命令、预提交与 CI 模板;按项目最低版本(默认 >=3.12,尽量用最新稳定小版本)从 3.12 起叠读各版 What's New 以利用新特性。应在「新建 Python 项目」「写独立脚本要可维护」「统一 lint/format/类型检查」或用户提到 uv/ruff/ty/Python 工程化时加载;与 tech-preferences 的 Python 基线一致,本 skill 负责落地步骤与文件内容。
6