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
EnjoyHarness 唯一强制入口，初始化全局状态、文件体系、技能注册表
配置文件读取和验证技能，确保用户配置正确且完整
全流程自动执行超级组合技能，编排所有16个基础技能，从用户需求到完整交付的全自动化流程
头脑风暴技能，在实现前探索用户意图、需求和设计，防止返工
实施计划执行技能，逐任务执行实施计划，支持检查点、错误恢复和进度跟踪
10倍产能提效超级组合技能，通过并行执行、智能调度、优化策略实现10倍开发效率提升
| name | harness-analyze-project-scale |
| description | 分析项目规模，统计功能数、接口数，估算执行时间，确定粒度等级 |
| trigger_words | ["harness-analyze-project-scale","分析项目规模","项目规模识别"] |
| priority | MEDIUM |
| dependencies | ["harness-init"] |
| version | v1.0.0 |
分析项目规模，统计功能数、接口数，估算执行时间，确定粒度等级（COARSE/MEDIUM/FINE）。
核心职责：
工具: Read
文件列表:
- README.md（项目概述）
- docs/requirements.md（需求文档）
- docs/specifications.md（技术规范）
- docs/api.md（API 文档）
Token 消耗: ~2000 tokens（小型项目）或 ~10000 tokens（大型项目）
失败处理:
- 如果文件不存在 → 跳过，继续检查其他文件
- 如果所有文件都不存在 → 提示"缺少需求文档，请提供项目概述"
分析逻辑:
1. 识别功能描述关键词:
- "实现"、"开发"、"添加"（功能动词）
- "用户故事"、"User Story"（敏捷术语）
- "功能点"、"Feature"（需求术语）
2. 统计方法:
- 提取所有功能描述
- 去重（避免重复计数）
- 分类（core/api/ui/security/performance/test）
Token 消耗: ~500 tokens
分析逻辑:
1. 识别 API 接口:
- HTTP 方法（GET/POST/PUT/DELETE）
- 路由定义（/api/xxx）
- RPC 方法（grpc/protobuf）
2. 统计方法:
- 正则表达式匹配路由定义
- 去重（避免重复计数）
- 分类（auth/user/product/order/payment）
Token 消耗: ~300 tokens
估算公式:
execution_time = (
功能数 * avg_time_per_feature
+ 接口数 * avg_time_per_api
+ 复杂度系数
)
参数定义:
- avg_time_per_feature: 2 小时（基于历史数据）
- avg_time_per_api: 1 小时（基于历史数据）
- 复杂度系数:
- 简单: 1.0
- 中等: 1.5
- 复杂: 2.0
示例:
- 功能数: 50
- 接口数: 10
- 复杂度: 中等（1.5）
- 执行时间 = (50 * 2 + 10 * 1) * 1.5 = 165 小时
Token 消耗: ~100 tokens
粒度等级定义:
- COARSE（粗粒度）:
- 功能数: <10
- 接口数: <5
- 执行时间: <20 小时
- 适用场景: 紧急修复、小型项目、线性任务
- MEDIUM（中粒度）:
- 功能数: 10-50
- 接口数: 5-10
- 执行时间: 20-100 小时
- 适用场景: 中型项目、模块化开发、迭代优化
- FINE（细粒度）:
- 功能数: >50
- 接口数: >10
- 执行时间: >100 小时
- 适用场景: 大型项目、复杂系统、长期演进
判定逻辑:
if 功能数 > 50 or 接口数 > 10 or 执行时间 > 100:
granularity_level = FINE
elif 功能数 >= 10 or 接口数 >= 5 or 执行时间 >= 20:
granularity_level = MEDIUM
else:
granularity_level = COARSE
Token 消耗: ~100 tokens
报告格式:
📊 项目规模分析报告
项目名称: {project_name}
分析时间: {timestamp}
功能统计:
- 功能总数: {total_features}
- 核心功能: {core_features}
- API 功能: {api_features}
- UI 功能: {ui_features}
- 安全功能: {security_features}
- 性能功能: {performance_features}
- 测试功能: {test_features}
接口统计:
- 接口总数: {total_apis}
- 认证接口: {auth_apis}
- 用户接口: {user_apis}
- 产品接口: {product_apis}
- 订单接口: {order_apis}
- 支付接口: {payment_apis}
执行估算:
- 预计执行时间: {estimated_hours} 小时
- 复杂度等级: {complexity_level}
- 推荐模式: {recommended_mode}
粒度等级: {granularity_level}
判定依据:
- 功能数: {total_features} ({criteria_features})
- 接口数: {total_apis} ({criteria_apis})
- 执行时间: {estimated_hours} 小时 ({criteria_time})
下一步建议:
- 如果 FINE → 使用子代理并行模式（max_parallel_agents: 3）
- 如果 MEDIUM → 使用单会话模式（max_features_per_session: 1）
- 如果 COARSE → 使用快速模式（一次性完成）
Token 消耗: ~300 tokens
必须满足：
harness-init（系统初始化）如果前置条件不满足：
成功标准：
失败情况：
检测: 所有文档文件不存在
处理:
1. 自动回退到以下信息源：
- README.md
- docs/ 目录结构
- 源码目录结构与文件数量
2. 使用默认参数估算规模
3. 记录 WARNING | SCALE_ANALYSIS_DEGRADED
4. 提供文档模板作为后续优化参考:
- README.md（项目概述）
- docs/requirements.md（需求列表）
检测: 正则表达式匹配失败
处理:
1. 尝试不同的提取策略:
- 关键词搜索（实现、开发、添加）
- 标题解析（## 功能列表）
- 表格解析（| 功能 | 描述 |）
2. 如果仍然失败 → 使用目录、文件命名和模块数做保守估算
检测: 历史数据不足（首次运行）
处理:
1. 使用默认参数估算:
- avg_time_per_feature: 2 小时
- avg_time_per_api: 1 小时
2. 提示用户: "首次运行，使用默认参数估算"
3. 记录 WARNING | SCALE_ESTIMATE_DEFAULTED
分析完成:
- 触发 harness-track-feature-progress（使用正确的粒度等级）
- 写入 GLOBAL_STATE.md（granularity_level 字段）
触发时机:
- harness-init 完成后（自动分析项目规模）
- 用户显式调用："分析项目规模"
- 功能清单生成前（确定粒度等级）
必须依赖:
- harness-init（系统初始化）
小型项目（10项）:
- Read 需求文档: ~2000 tokens
- 统计功能数: ~500 tokens
- 统计接口数: ~300 tokens
- 估算执行时间: ~100 tokens
- 确定粒度等级: ~100 tokens
- 输出报告: ~300 tokens
总计: ~3300 tokens
大型项目（200项）:
- Read 需求文档: ~10000 tokens
- 其他步骤相同
总计: ~11300 tokens
性能优化:
- 仅读取必要文档（README.md + docs/requirements.md）
- Token 消耗降低 50%
输入:
项目: 电商平台
README.md: "本项目包含用户管理、商品管理、订单管理、支付系统等 215 个功能点..."
API 文档: "提供 25 个 REST API 接口..."
处理:
1. Read README.md → 提取 215 个功能
2. Read API 文档 → 提取 25 个接口
3. 分类统计:
- 功能: core(30), api(50), ui(80), security(25), performance(15), test(15)
- 接口: auth(5), user(8), product(6), order(4), payment(2)
4. 估算执行时间:
- (215 * 2 + 25 * 1) * 1.5 = 682.5 小时
5. 确定粒度等级: FINE（功能数 > 50, 接口数 > 10）
输出:
📊 项目规模分析报告
项目名称: 电商平台
功能总数: 215
接口总数: 25
预计执行时间: 682.5 小时
粒度等级: FINE
判定依据:
- 功能数: 215 (>50) ✅
- 接口数: 25 (>10) ✅
- 执行时间: 682.5 小时 (>100) ✅
推荐模式: 子代理并行（max_parallel_agents: 3）
输入:
项目: 博客系统
README.md: "本项目包含文章管理、评论管理、用户管理等 35 个功能点..."
API 文档: "提供 8 个 REST API 接口..."
处理:
1. Read README.md → 提取 35 个功能
2. Read API 文档 → 提取 8 个接口
3. 分类统计:
- 功能: core(10), api(12), ui(8), security(3), performance(2)
- 接口: auth(2), user(3), article(2), comment(1)
4. 估算执行时间:
- (35 * 2 + 8 * 1) * 1.2 = 93.6 小时
5. 确定粒度等级: MEDIUM（功能数 10-50）
输出:
📊 项目规模分析报告
项目名称: 博客系统
功能总数: 35
接口总数: 8
预计执行时间: 93.6 小时
粒度等级: MEDIUM
判定依据:
- 功能数: 35 (10-50) ✅
- 接口数: 8 (5-10) ✅
- 执行时间: 93.6 小时 (<100) ✅
推荐模式: 单会话模式（max_features_per_session: 1）
输入:
项目: 待办事项
README.md: "本项目包含添加任务、删除任务、标记完成等 5 个功能点..."
处理:
1. Read README.md → 提取 5 个功能
2. 无 API 文档 → 接口数: 0
3. 分类统计:
- 功能: core(3), ui(2)
4. 估算执行时间:
- (5 * 2 + 0 * 1) * 1.0 = 10 小时
5. 确定粒度等级: COARSE（功能数 <10）
输出:
📊 项目规模分析报告
项目名称: 待办事项
功能总数: 5
接口总数: 0
预计执行时间: 10 小时
粒度等级: COARSE
判定依据:
- 功能数: 5 (<10) ✅
- 接口数: 0 (<5) ✅
- 执行时间: 10 小时 (<20) ✅
推荐模式: 快速模式（一次性完成）
Token 优化:
- 仅读取必要文档（README.md + docs/requirements.md）
- 正则表达式优化（避免贪婪匹配）
- 增量式统计（逐步提取，降低峰值）
执行优化:
- 并行读取文档（多个文件同时读取）
- 缓存分析结果（避免重复分析）
- 历史数据复用（提高估算准确性）
总体优化:
- Token 消耗降低 50%
- 执行时长缩短 30%