# Skills

**Repository Path**: XiHanFun/Skills

## Basic Information

- **Project Name**: Skills
- **Description**: 曦寒技能存储库。用于快速使用 AI 工具创建基于曦寒的范式应用。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 3
- **Created**: 2026-04-19
- **Last Updated**: 2026-08-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

![logo](./assets/logo.png)

[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/XiHanFun/XiHan.Skills)

[曦寒懿官方交流群](https://qm.qq.com/q/qYp1Urv3z2) 462371834

# XiHan.Skills

用于快速使用 AI 工具创建基于曦寒的范式应用。本仓库是一套面向 AI 编程助手的**全局约定 + 项目级 Skill 库**。

## 设计原则：原则与实现分层（面向长期可用）

为了让规则**长期不过期**，全仓库内容分为两层：

- **原则层（稳定）**：正文默认是原则层，描述“为什么”和“要达成什么”，与具体工具、版本、命令、框架无关。
- **实现层（快照，可替换）**：所有具体工具名、API、命令、配置默认值、版本号、代码模板，都是“当前如何做”的快照，会过期。它们集中在显式标注的区块或代码块中。

核心规则：**单一事实来源是仓库实际代码与官方文档**；实现层只是参考快照。工具/版本/命令过期时，只替换对应实现快照，原则层无需改动。与 .NET / Vue 绑定的内容会显式标记为**栈实现层**，换栈时只替换该层。

详见 [`AGENTS.md`](./AGENTS.md) 的“时效约定”一节。

## 结构

- [`AGENTS.md`](./AGENTS.md) — 全局工作方式：能力角色、五段闭环（理解 → 计划 → 实施 → 验证 → 交付）、影响面、多项目支持、当前工具实现映射（附录 A）。
- `skills/` — 项目级 Skill 库，命中任务时先读对应 `SKILL.md`。

## Skill 索引

| 目录 | 用途 | 层 |
|------|------|----|
| [`karpathy-guidelines`](./skills/karpathy-guidelines/SKILL.md) | 减少 LLM 编码错误：先思考、简洁优先、精确修改、目标驱动 | 通用原则 |
| [`requirement-driven-iterative-change`](./skills/requirement-driven-iterative-change/SKILL.md) | 需求驱动分步改代码：可追溯、可回滚、可验证 | 通用原则 |
| [`dotnet-vue-fullstack-dev`](./skills/dotnet-vue-fullstack-dev/SKILL.md) | 后端 API + 前端全栈开发：分层、契约、状态流 | 通用原则 + 栈实现 |
| [`dotnet-vue-code-style`](./skills/dotnet-vue-code-style/SKILL.md) | 代码风格与格式化：配置为单一事实来源 | 通用原则 + 栈实现 |
| [`dotnet-vue-build-quality`](./skills/dotnet-vue-build-quality/SKILL.md) | 构建与质量门禁：可构建、可验证、可发布 | 通用原则 + 栈实现 |
| [`dotnet-vue-stack-review`](./skills/dotnet-vue-stack-review/SKILL.md) | 全栈代码审查：先风险、后正确性、再维护性 | 通用原则 + 栈实现 |
| [`saas-rbac-abac-workflow`](./skills/saas-rbac-abac-workflow/SKILL.md) | 多租户 RBAC + 轻量 ABAC 全流程（八角色分册） | 通用原则 + 栈实现 |

## 维护约定

新增或重命名 skill 后，请同步更新本表与 `AGENTS.md` 的本地 Skill 索引。修改实现层时注明更新日期，不要改动其上方的原则层。

## License

[MIT](./LICENSE)