activity-duration-estimation

activity-duration-estimation — 全周期项目管理

WBS项目规划 → 活动历时估算 → 项目文档生成，三环节完整闭环。 全流程由 scripts/runner.py 的 run_full() 自动编排， LLM 只需调用一个函数即可完成项目从分解到文档的全部工作。 详细内容拆分到 references/*.md 按需加载。

---

触发场景

正向触发：估算工期/三点估算/PERT/蒙特卡洛/β分布/OMP/紧前关系/FS-SS-FF-SF/CPM甘特图/重叠分析/P50-P90/生成评估报告：估算工期/三点估算/PERT/蒙特卡洛/β分布/OMP/紧前关系/FS-SS-FF-SF/CPM甘特图/重叠分析/P50-P90/生成评估报告

不触发：仅概念询问 / 纯数学讨论 / 明确使用其他技能

核心能力

📚 渐进式加载：本技能采用渐进式 MD 体系，SKILL.md 为入口（≤230行），详细内容拆分到 references/*.md 按需加载。

---

渐进式文件索引

工作流程

工作流程由 scripts/runner.py 自动编排，LLM 无需关心内部阶段顺序。

# 推荐：一键全流程（WBS → 估算 → 报告 → 文档，全环节必做）
from scripts.runner import run_full, PipelineState
result = run_full("帮我规划并估算一个电商后台管理系统")

if result["status"] == "ok":
    state = result["state"]
    print(state.wbs_text_tree)      # ① WBS文本树
    print(state.estimate_summary)   # ② 估算摘要
    print(state.html_report_path)   # ③ HTML报告路径
    print(state.doc_content)        # ④ 项目文档
elif result["status"] == "blocked":
    # 需要LLM提供WBS数据（即使已有OMP参数，WBS也是必做的）
    wbs_data = {"name": "电商后台", "children": [...]}  # LLM提供
    state = PipelineState("帮我规划并估算一个电商后台管理系统")
    state.run_wbs(custom_data=wbs_data)
    result = state.run_full()  # 继续执行估算→报告→文档
else:
    print(result["message"])        # 错误信息

全流程阶段（代码硬编码，不可跳过，与 runner.py 中 6 个阶段一一对应）：

1. WBS分解 → run_wbs()（全流程模式下必做，LLM提供结构化数据）
2. WBS进入估算门控 → _wbs_passes_estimation_gate() 硬校验
3. 紧前关系规划 → _prompt_llm_for_dependencies() / 自动FS串联
4. 估算计算 → run_estimate()（全Python自动：CPM + MC + 重叠分析）
5. HTML评估报告 → _generate_html_report()（全Python自动）
6. 项目文档 → generate_docs()（按模板生成立项/结项/风险/相关方文档）

单独调用模式（不经过run_full()全流程，按需使用）：

LLM交互点

当流程需要LLM推理时，runner.py 会抛出 LLMInteractionRequired 异常：

LLM看到异常后按提示提供数据，然后继续执行即可。

---

快速开始

场景1：直接估算 — "乐观3天、最可能6天、悲观15天" → β分布7天, σ=2天 → 68%概率5~9天
场景2：多阶段CPM — "前端(5/10/20)→后端(8/15/25)→测试(10/20/35), FS" → 总工期47天 →出HTML报告
场景3：搜索辅助 — "装配式建筑施工" → 搜索同类→给出典型OMP→确认→估算
场景4：WBS→估算 — "帮我规划并估算电商后台" → 分解→确认→HTML报告
场景5：项目文档 — "生成立项申请书, 手动模式" → 空模板→"自动填充背景"→逐节生成→拼合
场景6：经济效益分析 — "初始100万, 年收益12万, 年支出5万, 5年, 终值200万, 折现率10%" → NPV=50.72, IRR=20.35%
场景7：挣值管理 — "项目到D阶段, 做挣值分析" → EV=320.27, SPI=1.01, CPI=1.07, EAC=379.73

常用操作速查

---

WBS子技能 — Phase -1：项目规划与工作分解

| scripts/wbs_engine.py 全流程模式下必做，由 run_full() 自动触发。

---

项目文档生成子技能 — :project-docs

| scripts/project_docs_engine.py 三种模式：manual（空模板，token≈0）/ mixed（按章节设 auto/outline/manual，推荐）/ 全自动（所有节 auto）。 支持模板定制：增/删/改/重排章节、每节独立模式、另存为新模板。

from project_docs_engine import set_section_mode
tpl = load_template("立项申请书")
tpl = set_section_mode(tpl, "项目背景", "auto")    # 自动生成
tpl = set_section_mode(tpl, "预算", "manual")       # 留空手动填
state.generate_docs(mode="mixed", filled_sections={"project_background": "..."})
save_template(tpl, "我的模板", overwrite=True)       # 另存自定义模板

内置模板：立项申请书(11节) / 结项报告书(10节) / 相关方登记册(4节) / 风险登记册(5节)

子模块详解

各子模块详细说明见 references/：

• Phase 0: 语义分析与方法推荐 → references/semantic-analysis.md
• Phase 1: 外部知识搜索 → references/search-integration.md
• Phase 2-3: 紧前关系规划 + 估算计算（CPM/MC/重叠分析）→ references/methods.md
• Phase 4: HTML评估报告 → references/report-template.md
• WBS方法论: → references/wbs-methodology.md
• 项目文档: → references/project-docs-methodology.md

---

限制与边界

---

版本

当前版本 v1.11.0 —