# project-management-skill

**Repository Path**: snail_tech/project-management-skill

## Basic Information

- **Project Name**: project-management-skill
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-27
- **Last Updated**: 2026-04-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 项目开发管理技能包（project-management-skill-v2）

## 概述

AI 辅助研发全生命周期技能包，覆盖版本规划→需求分析→模块架构→设计→开发→测试全流程。

## 核心开发规范

### 1. 分阶段迭代开发

- 每个阶段明确界定**单一功能模块**的开发范围
- 完成并通过验证后再进入下一阶段开发
- 严禁同时开展多个阶段的开发工作

### 2. 方法级开发原则

- 每次仅开发**一个独立方法**
- 方法开发完成后必须进行**单元测试验证**
- 测试通过后才能开始下一个方法的开发
- 通过该方式确保**问题定位精准**，将错误控制在单点范围

### 3. 开发约束

- **严禁跨多个脚本文件同时进行开发工作**
- 必须严格执行"**一个方法一实现一测试**"的开发流程
- 所有方法实现后必须通过测试验证，未通过测试的方法不得进入下一开发环节

### 4. 预防措施

- 建立方法开发清单，明确方法间依赖关系
- 每个方法需包含详细的输入输出说明
- 测试用例应覆盖正常场景、边界条件及异常情况
- 方法开发过程中需同步编写必要的注释文档

### 5. 真实开发

- 全局禁止使用 mock 模拟测试（除明确说明可使用 mock 的模块外）
- 必须执行真实流程：查询数据库、调用外部方法等

### 6. 模块化开发

- 按照多级模块进行划分，支持任意深度的子模块嵌套
- 每个模块下有自己的目录、入口文件和说明文档
- 每个模块都要进行自测，且只有一个主测试脚本
- 优先开发被依赖的功能模块，再开发依赖的功能模块
- 修改代码时涉及其他模块功能，必须先测试通过其他模块功能

### 7. 代码设计规范

- 单个方法 ≤ **100 行**（不含空行和注释），单个文件 ≤ **500 行**
- 单个方法参数 ≤ **5 个**；超过时必须封装为对象
- 单个方法只返回一个值或对象；多数据封装为对象返回
- 相同逻辑出现第 2 次必须提取为通用方法
- 注释应说明"做什么"和"为什么做"
- 使用 ESLint、Prettier 等工具确保代码风格一致性

### 8. 工具类分层

- **全局工具**（`src/[端]/utils/`）：被 2 个及以上模块引用的通用方法
- **模块工具**（`src/[端]/modules/[模块]/utils/`）：仅在本模块内使用

### 9. 文档管理

- 每个业务模块必须配备对应的 MD 说明文件
- 文档命名规范：`[一级]-[二级]-[三级]-module.md`
- 新增方法通过测试后，必须立即补充文档
- 方法更新或修改时，同步更新文档

### 10. 质量保障

- 统一的错误处理策略：错误捕获、错误日志、用户友好提示
- 前端防止 XSS、CSRF 等安全漏洞
- 后端实现接口权限控制、输入验证、敏感数据加密存储
- 前端优化资源加载、减少 DOM 操作、合理缓存
- 后端优化数据库查询、减少不必要的计算和 IO 操作

## 七阶段流程

```
① 需求梳理 → ② 模块架构 → ③ 产品设计 → ④ 功能拆分 → ⑤ 方法规划 → ⑥ 迭代开发 → ⑦ 测试回归
```

## 技能包结构

```
project-management/
├── SKILL.md                      ← 主入口
├── extensions/
│   ├── project-init.md           ← 项目初始化
│   ├── version-start.md         ← 版本迭代
│   ├── pm-designer.md           ← 产品设计
│   ├── backend-arch.md          ← 后端开发
│   ├── frontend-ui.md           ← 前端开发
│   ├── qa-regression.md         ← 测试回归
│   ├── project-mgr.md           ← 项目管理
│   └── git-workflow.md          ← Git工作流
└── references/
    ├── ui-style-guide.md        ← UI风格指南
    ├── code-review-checklist.md ← 代码审查清单
    └── module-doc-standard.md   ← 模块文档标准
```