# dev-project-mgmt

**Repository Path**: gogojaja/dev-project-mgmt

## Basic Information

- **Project Name**: dev-project-mgmt
- **Description**: dev-project-mgmt
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-01
- **Last Updated**: 2026-09-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# dev-project-mgmt

> 轻量、可复用的项目管理工具集：RAID 管理 / 进展报告 / 变更协调 / EVM 计算

---

## 特性

- RAID 台账管理（风险/假设/问题/依赖四维跟踪）
- 进展报告自动生成（周报/阶段报模板化）
- 变更协调流程（变更请求登记/影响分析/审批跟踪）
- EVM 挣值计算（CPI/SPI/里程碑准点率）
- 跨项目复用（PROJECT_ROOT 环境变量注入）

---

## 快速开始

```bash
# CLI 接口
dev-project-mgmt raid / report / change / evm
```

## 技术栈

Python 3.10+ / CSV（UTF-8 BOM）+ SQLite / 标准库优先

## 与技能库的关系

本项目承载**工具实现**，方法论/流程由对应技能库承载（单一信源互补）：
- .trae/skills/role-project-mgmt（方法论技能，单一信源互补）

跨项目调用遵循 `PROJECT_ROOT` 环境变量注入规范（对齐 `tool_calling_standard.md`）。

### EVM / RAID 能力内化说明（2026-09-08）

依据行业最佳实践与单一信源原则，本项目的 **EVM 挣值计算**（`evm_calculator.py`）与 **RAID 台账管理**（`raid_manager.py`）能力已**重新内化**至 DevProjectTeamSkill 技能库，成为两个独立可部署技能的本地权威工具：

| 本项目模块 | 内化目标（DevProjectTeamSkill） | 权威工具 | 独立可部署技能 |
|------------|-------------------------------|----------|----------------|
| `evm_calculator.py` | 进度成本挣值管理 | `tools/evm_ops.py` v1.0.0 | `schedule-cost`（SKILL_INDEX 条目 29） |
| `raid_manager.py` | 风险与 RAID 管理 | `tools/raid_ops.py` v1.0.0 | `risk-mgmt`（SKILL_INDEX 条目 30） |

- **保留兼容**：本项目 `evm_calculator.py` / `raid_manager.py` 及其 CLI（`dev-project-mgmt evm/raid`）、`report_generator.py` 依赖**继续保留**，供本项目自身、其他卫星项目与既有 CLI 调用方使用，不做破坏性移除。
- **一致性保障**：内化时吸收本项目实现逻辑（EVM 公式、RAID 四维状态机、风险分级）；DevProjectTeamSkill 侧 `test_evm_ops.py` / `test_raid_ops.py` 含与本项目的一致性断言，防止两侧实现漂移。
- **权威归属**：技能库侧 EVM/RAID 能力以 DevProjectTeamSkill 的 `evm_ops.py` / `raid_ops.py` 为**单一信源**；MCP 工具 `evm_analyze` / `raid_mgmt` / `risk_scan` 已改为委派本地权威工具。

---

## 治理

- 遵循 DevProjectTeamSkill 全生命周期与铁律卡
- 授权依据：AUTH-022（`/Volumes/BR256G/DevProjectTeamSkill/台账/14_授权登记.csv`）
- 立项依据：INC-2026-09-01-001（评分 94/100）

---

*知识产权所有：段波（验证邮箱：duanbo.douglas@163.com）*