Menu
编写项目文档。当用户要求写文档、添加文档、更新文档、或整理文档时使用此技能。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | doc-writer |
| description | 编写项目文档。当用户要求写文档、添加文档、更新文档、或整理文档时使用此技能。 |
为 EsportManager 2 项目编写规范的技术文档。确保文档风格统一、结构清晰、易于维护。
docs/
├── README.md # 文档索引（必须更新）
├── CONTRIBUTING.md # 文档编写指南
├── 01-overview/ # 项目概览
├── 02-game-design/ # 游戏设计/策划
├── 03-core-systems/ # 核心系统文档
├── 04-technical/ # 技术开发文档
├── 05-ai/ # AI 系统文档
└── archive/ # 归档（已废弃的旧文档）
| 目录 | 用途 | 适合内容 |
|---|---|---|
01-overview | 项目总览 | 架构图、技术栈、目录结构 |
02-game-design | 游戏策划 | 游戏规则、赛事设计、数值设计 |
03-core-systems | 核心系统 | 各业务系统的设计与实现 |
04-technical | 技术开发 | API、数据库、前后端指南 |
05-ai | AI 系统 | AI 决策、算法说明 |
archive | 归档 | 已废弃但保留参考的旧文档 |
根据内容选择目录：
游戏规则/数值设计 → 02-game-design/
业务系统实现 → 03-core-systems/
开发技术指南 → 04-technical/
AI/算法相关 → 05-ai/
命名规则：
player-system.md✅ 正确：player-system.md, match-simulation.md
❌ 错误：选手系统.md, PlayerSystem.md, player_system.md
# 系统名称
## 概述
一句话描述系统的核心功能和目的。
## 核心概念
解释关键术语和概念。
## 数据结构
\`\`\`rust
pub struct ExampleModel {
pub id: u64,
pub name: String,
}
\`\`\`
## 核心流程
\`\`\`
步骤1 → 步骤2 → 步骤3
\`\`\`
## 规则说明
| 规则 | 说明 |
|------|------|
| 规则1 | 详细说明 |
## API 接口
| 接口 | 描述 |
|------|------|
| `api_name` | 功能描述 |
## 文件位置
| 文件 | 说明 |
|-----|------|
| `src-tauri/src/xxx.rs` | 核心实现 |
# 技术主题
## 概述
技术背景和用途说明。
## 技术栈
| 技术 | 版本 | 用途 |
|------|------|------|
| xxx | x.x | 用途说明 |
## 使用方法
### 基本用法
\`\`\`typescript
// 代码示例
\`\`\`
## 最佳实践
1. **实践1**：说明
2. **实践2**：说明
## 文件位置
| 文件 | 说明 |
|-----|------|
| `path/to/file` | 说明 |
在 docs/README.md 中添加新文档链接：
### 03-core-systems 核心系统
- [新系统](03-core-systems/new-system.md) - 新系统描述
| 元素 | 规范 |
|---|---|
| 标题 | # 文档标题，## 主章节，### 子章节 |
| 代码块 | 必须标注语言类型 |
| 表格 | 用于对比、配置、参数说明 |
| 列表 | 有序=步骤流程，无序=并列项目 |
写完文档后检查：
当文档不再需要时：
archive/ 目录README.md 索引中移除链接mv docs/03-core-systems/old-system.md docs/archive/
电竞经理游戏的数据中心系统。管理选手赛季统计、影响力排行、赛事表现记录、身价变化追踪。当需要修改统计计算、排行榜逻辑、年度评分时使用此技能。
电竞经理游戏的金额单位规范。全项目金额统一以「元」存储和传递，前端使用 formatMoney 系列函数格式化显示。当需要新增金额相关计算、修改身价/薪资/奖金/赞助公式、添加新的金额字段、或排查金额显示异常时使用此技能。
电竞经理游戏的版本更新（Meta）系统。管理20种Meta版本、位置权重、加权战力计算、赛季版本轮换。当需要修改Meta配置、位置权重、战力计算公式、版本轮换规则时使用此技能。
电竞经理游戏的选手系统。管理选手属性、成长曲线、忠诚度、满意度、身价计算。当需要修改选手属性、成长规则、身价公式、忠诚度机制时使用此技能。
电竞经理游戏的时间推进系统。管理赛季阶段、比赛模拟、赛季结算等核心游戏流程。当需要修改游戏进度、阶段推进、比赛模拟逻辑时使用此技能。
电竞经理游戏的选手特性系统。管理14种选手特性的定义、触发条件、修正计算、随机生成、互斥规则。特性影响比赛模拟中选手的ability/stability/condition。当需要修改特性效果、添加新特性、调整触发条件、修改生成规则时使用此技能。