Back to Details

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

在遇到技术选型时，按以下步骤分析：
  1. 识别决策点 — 明确需要选择的技术维度（语言/框架/工具/数据格式等）。
  2. 对比当前偏好 — 检查上方"已知偏好"列表，确认是否已有约定；若有，默认遵循。
  3. 分析偏差理由 — 如果需要偏离已知偏好，明确写出原因（性能、生态、约束等）。
  4. 讨论新偏好 — 如果发现新的、值得固化的偏好，在响应中明确提出：
    建议将「X 替代 Y，原因：...」加入 tech-preferences skill。
  5. 自主提案 — 当偏好有明显新增或变化时，主动在 PR/Issue 中提交偏好变更提案（格式见下），无需等待人类提示。
  6. 沉淀更新 — 经人类确认后，将新偏好追加到"当前已知偏好"节。
When encountering technology selection, analyze according to the following steps:
  1. Identify decision points — Clarify the technical dimension to be selected (language/framework/tool/data format, etc.).
  2. Compare with current preferences — Check the "Known Preferences" list above to confirm if there is an existing agreement; follow it by default if any.
  3. Analyze deviation reasons — If you need to deviate from known preferences, clearly write down the reasons (performance, ecosystem, constraints, etc.).
  4. 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.
  5. 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.
  6. Deposit and update — After confirmation by humans, append the new preferences to the "Current Known Preferences" section.

示例分析

Example Analysis

场景：需要为新 Python 项目选择测试框架。
  1. 决策点：测试框架选型
  2. 已知偏好：无（当前基线未列测试框架）
  3. 对比候选：
    pytest
    （生态最丰富，prek 默认集成）vs 
    unittest
    （标准库，无额外依赖）
  4. 分析：已有仓库均使用 
    pytest
    ；
    prek
    钩子默认运行 
    pytest
    ；选 
    pytest
  5. 新偏好提案：pytest（Python 测试框架首选）→ 提交提案加入基线
Scenario: Need to select a testing framework for a new Python project.
  1. Decision point: Testing framework selection
  2. Known preference: None (the current baseline does not list testing frameworks)
  3. Compare candidates: 
    pytest
    (richest ecosystem, prek integrated by default) vs 
    unittest
    (standard library, no extra dependencies)
  4. Analysis: All existing repositories use 
    pytest
    ; 
    prek
    hook runs 
    pytest
    by default; choose 
    pytest
  5. 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.