tech-preferences

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

目的

Purpose

技术偏好不能穷举——它是一个持续演进的过程。本 skill 提供一个偏好分析流程，帮助在具体任务中发现、讨论并固化偏好。

Technology preferences cannot be exhaustively listed - it is a process of continuous evolution. This skill provides a preference analysis process to help discover, discuss and solidify preferences in specific tasks.

当前已知偏好（基线）

Current Known Preferences (Baseline)

Python 生态

Python Ecosystem

包管理：uv（替代 pip/poetry/pyenv）
代码质量：ruff（lint + format），ty（类型检查）
预提交/CI 钩子：prek（替代 pre-commit）
依赖自动升级：Renovate
数据模型：dataclasses（首选，原生零依赖）；仅在需要运行时校验或序列化时才引入 Pydantic v2

Package management: uv (replaces pip/poetry/pyenv)
Code quality: ruff (lint + format), ty (type check)
Pre-commit/CI hooks: prek (replaces pre-commit)
Automatic dependency upgrade: Renovate
Data model: dataclasses (preferred, native zero dependency); introduce Pydantic v2 only when runtime validation or serialization is required

Web 后端

Web Backend

框架：FastAPI（async-first，自动 OpenAPI 文档）
输入校验/序列化（API 边界）：Pydantic v2

Framework: FastAPI (async-first, automatic OpenAPI documentation)
Input validation/serialization (API boundary): Pydantic v2

Web 前端

Web Frontend

框架：Svelte（轻量，编译时优化，无运行时 vdom）
构建工具：Vite

Framework: Svelte (lightweight, compile-time optimization, no runtime vdom)
Build tool: Vite

系统 / 自动化

System / Automation

任务运行：just（替代 Makefile）
容器：Docker / OCI 镜像
macOS 守护进程：launchd（不用 cron）

Task running: just (replaces Makefile)
Containers: Docker / OCI images
macOS daemon: launchd (do not use cron)

数据格式

Data Format

配置：TOML（首选），YAML（CI only），JSON（API 交换）
文本格式：Markdown（文档），结构化日志优先 JSON

Configuration: TOML (preferred), YAML (CI only), JSON (API exchange)
Text format: Markdown (documentation), structured logs prefer JSON

偏好分析流程

Preference Analysis Process

在遇到技术选型时，按以下步骤分析：

识别决策点 — 明确需要选择的技术维度（语言/框架/工具/数据格式等）。
对比当前偏好 — 检查上方"已知偏好"列表，确认是否已有约定；若有，默认遵循。
分析偏差理由 — 如果需要偏离已知偏好，明确写出原因（性能、生态、约束等）。
讨论新偏好 — 如果发现新的、值得固化的偏好，在响应中明确提出：

建议将「X 替代 Y，原因：...」加入 tech-preferences skill。
自主提案 — 当偏好有明显新增或变化时，主动在 PR/Issue 中提交偏好变更提案（格式见下），无需等待人类提示。
沉淀更新 — 经人类确认后，将新偏好追加到"当前已知偏好"节。

When encountering technology selection, analyze according to the following steps:

Identify decision points — Clarify the technical dimension to be selected (language/framework/tool/data format, etc.).
Compare with current preferences — Check the "Known Preferences" list above to confirm if there is an existing agreement; follow it by default if any.
Analyze deviation reasons — If you need to deviate from known preferences, clearly write down the reasons (performance, ecosystem, constraints, etc.).
Discuss new preferences — If you find new preferences worth solidifying, clearly propose them in the response:

It is recommended to add "X replaces Y, reason: ..." to the tech-preferences skill.
Initiate proposal independently — When there are obvious new additions or changes to preferences, actively submit a preference change proposal in PR/Issue (see format below) without waiting for human prompts.
Deposit and update — After confirmation by humans, append the new preferences to the "Current Known Preferences" section.

示例分析

Example Analysis

场景：需要为新 Python 项目选择测试框架。

决策点：测试框架选型
已知偏好：无（当前基线未列测试框架）
对比候选：
```
pytest
```
（生态最丰富，prek 默认集成）vs
```
unittest
```
（标准库，无额外依赖）
分析：已有仓库均使用
```
pytest
```
；
```
prek
```
钩子默认运行
```
pytest
```
；选
```
pytest
```
新偏好提案：pytest（Python 测试框架首选）→ 提交提案加入基线

Scenario: Need to select a testing framework for a new Python project.

Decision point: Testing framework selection
Known preference: None (the current baseline does not list testing frameworks)
Compare candidates:
```
pytest
```
(richest ecosystem, prek integrated by default) vs
```
unittest
```
(standard library, no extra dependencies)
Analysis: All existing repositories use
```
pytest
```
;
```
prek
```
hook runs
```
pytest
```
by default; choose
```
pytest
```
New preference proposal: pytest (preferred Python testing framework) → Submit proposal to add to the baseline

如何贡献新偏好

How to Contribute New Preferences

当发现偏好有明显新增或变化时，自主提交偏好变更提案，格式如下：

偏好提案：将 <新工具/框架> 加入 tech-preferences skill
- 类别：<Python生态 / Web后端 / 前端 / 系统 / 数据格式>
- 替代：<被替代的工具，若有>
- 原因：<具体理由，1-3句>
- 参考：<项目/PR/文档链接，若有>

可通过 PR 直接修改此 skill 的"当前已知偏好"节，或在相关 Issue/PR 中以评论形式提案。

When there are obvious new additions or changes to preferences, submit a preference change proposal independently, the format is as follows:

偏好提案：将 <新工具/框架> 加入 tech-preferences skill
- 类别：<Python生态 / Web后端 / 前端 / 系统 / 数据格式>
- 替代：<被替代的工具，若有>
- 原因：<具体理由，1-3句>
- 参考：<项目/PR/文档链接，若有>

You can directly modify the "Current Known Preferences" section of this skill through PR, or propose in the form of comments in related Issue/PR.