# ucap-technical-cost-estimation

**Repository Path**: rongyang/ucap-technical-cost-estimation

## Basic Information

- **Project Name**: ucap-technical-cost-estimation
- **Description**: ucap公司用于标准化技术成本评估
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Technical Cost Estimation

用于政府门户、集约化站群、平台类项目的`技术部成本评估` skill。

核心目标是：在资料不完整、只有大致意向的情况下，通过短对话快速输出 `UI / 前端 / 系统运维` 的经验型人天估算，并在需要时换算成金额，或导出为 Excel 评估表。

## 适用场景

- 投标前或立项前，只有粗略项目意向，没有完整招标文件
- 已知产品范围、站点规模、模板策略，但细节不完整
- 需要技术部内部先做一版成本评估
- 需要输出接近案例表风格的估算表，而不是纯文字分析

## 主要能力

- 通过分步对话收集最少必要信息
- 输出 `Markdown` 估算表
- 输出 `UI / 前端 / 系统运维` 分类小计
- 根据岗位单价换算金额
- 按需导出 `Excel`

## 评估逻辑

这个 skill 主要看三类变量：

- `UI`
  - 主站是否完全定制
  - 子站是复用模板，还是部分站点独立设计
  - 是否存在专题、H5、大屏、小程序、APP 等额外设计对象
- `前端`
  - 主站模板开发量
  - 子站模板族数量
  - 子站落站适配量
  - 搜索、互动、信息公开、适老化、专题等专项前端工作
- `系统运维`
  - 产品清单
  - 是否信创
  - 服务器规模
  - 是否集群、高可用、灾备、多环境

## 如何使用

### 1. 触发 skill

可直接用类似下面的话触发：

```text
Use $technical-cost-estimation to estimate a government site-group project.
```

也可以直接描述任务：

```text
帮我评估一个集约化项目的 UI、前端、系统运维工作量。
```

### 2. 对话方式

不要一次性抛很多问题。

推荐按三步走：

1. 先问产品和站点规模
2. 再问设计策略和前端复用策略
3. 最后只补会明显影响结果的复杂度因素

示例问法：

```text
我先确认两个关键点：
1. 这次项目准备上哪些产品？
2. 预计建设多少个站点？主站、区县站、部门站大概分别多少？
```

### 3. 默认输出

默认输出应是表格，而不是长篇说明文。

推荐格式：

| 序号 | 类别 | 工作项 | 工作内容/估算说明 | 工作量（人天） |
| --- | --- | --- | --- | ---: |
| 1 | UI | 主站首页设计 | 主站完全定制，按 1 套首页估算 | 3 |
| 2 | 前端 | 主站首页模板制作 | 主站首页开发 | 3 |
| 3 | 系统运维 | 产品部署 | 标准部署与调试 | 2 |

然后补：

- 分类小计
- 估算依据
- 假设条件
- 风险项

### 4. 导出 Excel

如果用户明确要求导出 Excel，不依赖外部 `xlsx` skill，直接用本 skill 自带脚本：

```bash
python3 scripts/export_estimation_xlsx.py <input.json> <output.xlsx>
```

输入 JSON 至少包含：

- `title`
- `summary`
- `rows`

可选：

- `categories`
- `notes`

## 依赖安装

Excel 导出需要 `openpyxl`。

安装方式：

```bash
python3 -m pip install -r requirements.txt
```

依赖文件：

- [requirements.txt](./requirements.txt)

如果环境里没有 `openpyxl`，则：

- 优先尝试安装依赖
- 如果装不上，退回到 `Markdown` 或 `CSV`

## 目录结构

```text
technical-cost-estimation/
├── SKILL.md
├── README.md
├── requirements.txt
├── agents/
│   └── openai.yaml
├── scripts/
│   └── export_estimation_xlsx.py
└── references/
    ├── question-flow.md
    ├── estimation-rules.md
    ├── standards-ui.md
    ├── standards-frontend.md
    ├── standards-operations.md
    ├── cost-conversion.md
    ├── case-library.md
    ├── output-template.md
    └── source-materials.md
```

## 参考资料说明

- `question-flow.md`
  - 问答流程
- `estimation-rules.md`
  - 经验估算总规则
- `standards-ui.md`
  - UI 标准口径
- `standards-frontend.md`
  - 前端标准口径
- `standards-operations.md`
  - 系统运维标准口径
- `cost-conversion.md`
  - 人天到金额的换算方式
- `case-library.md`
  - 案例口径参考
- `output-template.md`
  - 输出表格模板
- `source-materials.md`
  - 原始 Excel 来源说明

## 注意事项

- 这是`经验估算`，不是最终报价
- 不要把所有子站都按独立站点全量计算
- 不要把服务器台数当成系统运维唯一变量
- 专题数量、专题差异度、外采系统集成边界，往往是最大的波动来源
- 如果信息明显不足，优先给`区间估算`，不要假装精确
- 第二轮追问要少，只问真正影响结果的变量

## 推荐输出口径

推荐先给：

- `人天估算`

如果用户再要金额，再补：

- `金额换算`

如果用户再要文件，再导：

- `Excel`

这样更稳，也更符合售前和技术部内部的实际使用方式。