agent-skill-rules
Agent Skill Rules
以 Agent Skills 官方 Step 1–4 为主流程，并在每一步中嵌入平台无关的治理增强项。
Instructions（分步说明）
Pre-Step：先做能力落位判断（是否应该 skill 化）
在创建、抽取或重构 skill 前，先判断当前需求最适合落到哪一层；不要把“可复用”直接等同于“应该做成 skill”。
| 落位候选 | 何时优先选择 | 不该做什么 |
|---|---|---|
| 自动化工具 / 脚本 / hook / workflow | 动作机械、确定、高频、易漏做，且可以稳定脚本化 | 把固定命令顺序或构建动作仅写成 skill 提醒 |
| 项目级规则文件 | 规则强依赖当前仓库/业务，且对大多数任务默认相关 | 把项目私有约束伪装成通用 skill |
| 通用 skill | 跨项目复用，按需触发，且需要一套认知流程、检查框架或方法论 | 用 skill 替代脚本、模板工程或工具链 |
| 项目私有 skill | 只在当前项目成立，但不是每次任务都默认相关，且仍需要专门方法或检查流程 | 把这类内容强塞进全局常驻规则，污染默认上下文 |
| 单次 prompt | 一次性需求、短期要求、低复用内容 | 过早沉淀为长期规则 |
More from qiao-925/qiao-skills
python-coding-standards
Python 实现基线能力单元，帮助 Agent 在 Python 代码实现、修改、补全、重构与审查场景中，先对齐项目既有约定，再落实类型边界、日志纪律、命名与结构可读性，避免把个人偏好或项目私货写成通用规范。关键词：Python、编码规范、类型提示、日志、命名、代码结构、项目对齐。
23critical-thinking-guidance
规范 Agent 在解答前进行智能判断与思考引导，避免不必要的替代思考并保留用户主导权。适用于用户提问、方案咨询、学习交流等需要平衡效率与思考深度的场景。关键词：引导提问、智能判断、轻量引导、强制思考
21single-responsibility
单一职责能力单元，帮助 Agent 在文件拆分、函数重构、模块设计、代码审查与边界澄清场景中，识别职责混杂、变化原因耦合与命名失真问题，让文件、函数、类与模块都能围绕一个稳定职责组织。关键词：单一职责、职责拆分、边界澄清、重构、文件拆分、函数重构、模块设计。
20architecture-governance
架构治理能力单元，帮助 Agent 在架构评审、重构、新模块设计、分层边界调整、接口契约设计与项目初始化分析场景中，检查分层与依赖方向、变更影响面、接口契约与可替换性，避免跨层耦合、反向依赖与破坏性演进。关键词：架构治理、分层、依赖方向、影响面分析、接口契约、依赖注入、可插拔、重构。
19core-first-simplicity
核心优先的复杂度控制能力单元，帮助 Agent 在项目取舍、架构设计、模块重构、实现裁剪与方案收敛场景中，先识别主亮点、控制复杂度预算、稳定主路径、延后非核心扩张，避免过度设计与大而全实现。关键词：核心优先、复杂度控制、KISS、方案收敛、过度设计、主路径。
19python-uv-acceleration
Python 工具链加速能力单元，帮助 Agent 在 Python 项目创建虚拟环境、安装依赖、同步 requirements、替换 pip/venv 工作流时，优先使用 uv 提升速度与一致性，同时识别何时不应覆盖 poetry、pdm、hatch 等既有项目管理器。关键词：Python、uv、依赖安装、虚拟环境、pip 替代、venv 替代、requirements。
19