work-estimation-zh

软件开发工时评估技能。当用户提到"工时评估"、"工作量评估"、"开发周期评估"、"项目评估"、"评估工时"、"拆分工作"、"任务拆分"、"项目工时"、"排期评估"、"开发周期估算"时触发。 支持用户输入需求描述或上传需求文档，自动进行工作拆分和工时估算，输出 Excel 评估报告。

Security Scan

The skill's files and runtime instructions are internally consistent with a work‑estimation/Excel‑generation tool: it produces offline Excel reports and does not request credentials or reach out to external endpoints.

Purpose & Capability

Name/description (software work estimation and Excel report generation) match the included files: SKILL.md describes collecting requirements and producing an Excel report, and scripts/generate_estimation.py implements multi‑sheet Excel generation. There are no unexpected credentials, binaries, or unrelated packages requested.

Instruction Scope

SKILL.md describes asking the user for requirement text or a document path and using AI to split/estimate. The repository provides the Excel generation logic but does not include code to parse arbitrary uploaded files or call external services; the AI/model is expected to do the splitting. This is reasonable, but be aware the skill's instructions imply the agent may request/ingest user documents — avoid uploading sensitive documents (API keys, passwords, PII) to the skill/agent unless you trust the platform's data handling.

Install Mechanism

There is no install spec (instruction-only skill with bundled utility scripts). The script imports openpyxl (and other standard libs) but the skill metadata does not declare Python package dependencies. You should ensure required Python packages (openpyxl) are available in the runtime. No remote download URLs or installers are present.

Credentials

The skill does not require environment variables, credentials, or config paths. The code does not access secrets or external services. This is proportionate to its stated purpose.

Persistence & Privilege

Skill flags: always=false and it does not request system-wide config changes. It does not attempt to persist credentials or modify other skills. Autonomous invocation is allowed by default but is not combined with broad privileges here.

Assessment

This skill appears to be what it says: an estimator + Excel generator. Before installing/using it: 1) ensure the runtime has Python and the openpyxl package (the script imports openpyxl but dependencies aren't declared); 2) do not upload documents that contain secrets, credentials, or sensitive PII — the skill expects requirement texts or document contents which the agent may process; 3) note scripts/test_login.py contains a hard‑coded Windows sys.path sample (C:/Users/Administrator/…) used only for local testing — harmless but non‑portable; 4) if you plan to run the included Python scripts locally, run them in an isolated environment (virtualenv) to avoid dependency conflicts. Overall, there are no signs of credential exfiltration or hidden network endpoints in the packaged files.

📊 软件开发工时评估

自动分析用户需求，拆分为具体工作项，并从多个维度进行工时评估，输出结构化的 Excel 报告。

使用流程

第一步：收集需求

请用户提供：

• 需求描述（可直接粘贴文字）
• 或需求文档路径（支持 .md、.docx、.txt 等格式）

第二步：AI 需求拆分

AI 会自动：

1. 分析需求内容
2. 拆分为具体工作模块
3. 按维度分类（需求分析、设计、前端、后台、算法、测试）

第三步：工时评估

对每个工作项评估：

• 工作量（人天）
• 复杂度（低/中/高）
• 风险等级（低/中/高）
• 并行可行性
• 前置依赖

第四步：生成 Excel

输出多 Sheet 的 Excel 报告：

• 总览表
• 各维度详细评估
• 甘特图（项目进度）
• 重点风险项
• 协调关系表

输出说明

Sheet 1：工时总览

工作模块	需求分析	设计	前端	后台	算法	测试	合计
模块A	1人天	2人天	3人天	5人天	1人天	2人天	14人天

Sheet 2-7：各维度详情

按维度详细列出工作内容、评估依据、预估工时。

Sheet 8：甘特图

可视化展示并行工作、项目关键路径、里程碑。自动跳过周末和法定节假日。

Sheet 9：重点评估

高风险或不确定性高的工作单独列出，说明原因和建议。

Sheet 10：关系协调

工作间的依赖关系、前置任务、协调事项。

Sheet 11：成本估算

包含三部分：

• 人力成本：按角色统计工时 × 日均成本
• 软硬件成本：服务器、域名、SSL、第三方服务等
• 项目总预算：含15%应急缓冲

评估标准参考

复杂度	前端	后台	算法	测试
低	1-2天	1-3天	1-3天	0.5-1天
中	3-5天	3-7天	3-7天	1-3天
高	5-10天	7-14天	7-14天	3-5天

注意事项

• 评估基于常规团队配置（前端1人、后端1人、测试1人）
• 多人并行时工时不变，仅缩短日历时间
• 预留 10-20% buffer 应对变更
• 实际执行需根据团队情况调整

示例对话

用户： 帮我评估一下这个项目：开发一个电商小程序，包括用户登录、商品展示、购物车、订单支付功能

AI：

收到！我来帮你进行工时评估。

基于你描述的需求，我拆分为以下模块：

📦 **工作模块**
1. 用户系统（登录、注册、个人中心）
2. 商品模块（列表、详情、搜索）
3. 购物车模块
4. 订单模块
5. 支付模块
6. 基础架构（路由、状态管理、API封装）

正在生成详细评估报告...