Agent skill

risk-buffer-calculator

计算每Phase风险缓冲百分比，基于复杂度、依赖和未知因素进行启发式分析。当需要风险评估、缓冲时间规划、资源预留时使用。主要用于L3项目的严格风险管理。

View SKILL.md on GitHub Repository
Stars 5
Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/tikazyq/agentic-spec-forge/tree/main/AGENTIC_SPEC_FORGE/spec_stage_skill/execspec_compile/risk-buffer-calculator

SKILL.md

Risk Buffer Calculator

Scope: EXECSPEC_COMPILE — Compile ExecSpec（编译 ExecSpec） 版本: 1.0.0 | 创建日期: 2025-02-03

1. 描述

计算每Phase的风险缓冲百分比，为项目时长预估提供风险储备。

核心职责：计算风险缓冲百分比、基于复杂度和依赖因子、推荐缓冲分配策略

2. 适用场景

  • WORKFLOW Step 3 Task 3-8: Phase规划时计算风险缓冲
  • 场景A: L3项目需要严格风险管理
  • 场景B: 高依赖项目需要缓冲时间

对应: Build_Exec_Spec_Plans Step 4 (Phase规划，风险缓冲)

3. 输入

  • spec/build/dependency_graph.md - 依赖分析
  • spec/spec_artifacts_registry.md - 从Registry查询VS数量
  • spec/build/scaffold_analysis_report.md - 外部服务依赖

4. 输出

  • spec/build/risk_buffer_allocation.md - 风险缓冲分配

5. 执行步骤

  1. Read dependency_graph.md, count external API dependencies
  2. Read spec_artifacts_registry.md, query VS count from DESIGN section
  3. Calculate complexity_factor:
    • VS_Count > 10 → +5%, >20 → +10%
  4. Calculate dependency_factor:
    • External_APIs > 3 → +5%, >5 → +10%
  5. Calculate buffer% = Base(10%) + complexity_factor + dependency_factor
  6. Adjust by SPEC level:
    • L1: 固定10%
    • L2: 10-15% (简单计算)
    • L3: 15-25% (综合分析)
  7. Write risk_buffer_allocation.md

6. 快速开始

  1. 开发者确保dependency_graph.md已生成
  2. 调用: ///risk-buffer-calculator（并明确 Level: L3）
  3. 查看: spec/build/risk_buffer_allocation.md
  4. 预计耗时: 2-3分钟

7. 使用说明

输入要求: dependency_graph.md需包含外部依赖标注

输出格式 (spec/build/risk_buffer_allocation.md包含):

  • 每Phase计算: 基础缓冲(10%) + 复杂度因子 + 依赖因子 = 总缓冲百分比
  • 建议预留时间: 基于Phase预估时长计算具体小时数
  • L1固定: L1级别统一10%，不进行复杂计算

8. 价值

  • SPEC组织: 科学化风险预估
  • PM/BA: 真实项目周期预估
  • Dev: 缓冲时间指导

9. 质量检查

  • 缓冲百分比在合理范围（10-25%）
  • 每个Phase有单独计算
  • 建议预留时间已提供

10. 限制条件

  • 启发式: 基于简单规则，不是精确模型
  • L1固定: L1级别固定10%，不进行复杂计算

相关 SKILLs

  • 前置: dependency-graph-generator
  • 并行: integration-window-planner
  • 后续: 无

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

tikazyq/agentic-spec-forge

code-review

执行代码审查流程（提交PR→自查→同行审查→反馈修改→合并），覆盖功能正确性、代码质量、测试完整性、安全合规四大维度。当提交Pull Request、进行结对编程、执行代码走查、需要知识共享时使用。支持L1/L2/L3三级审查深度。

5 1
Explore
tikazyq/agentic-spec-forge

code-quality

执行代码质量门禁检查（测试通过→覆盖率→Lint→GOAL追溯→可提交），验证单元测试覆盖率≥80%、集成测试通过率≥95%、代码规范零错误。当完成代码实现、准备提交代码、需要质量验证、进行提交前自检时使用。确保代码可合并。

5 1
Explore
tikazyq/agentic-spec-forge

tdd-cycle

执行 TDD 红绿重构循环（RED→GREEN→REFACTOR→REPEAT），通过先写失败测试、最小代码实现、保持绿色重构的节奏驱动开发。当启动功能开发、需要测试驱动节奏、进行迭代编码、追求高测试覆盖率时使用。提供检查清单和节奏控制。

5 1
Explore
tikazyq/agentic-spec-forge

refactoring

执行代码重构（识别坏味道→选择手法→小步修改→运行测试），在保持外部行为不变前提下改进内部结构。当TDD进入REFACTOR阶段、发现代码坏味道、需要消除重复代码、优化代码结构时使用。支持提取方法、类、参数对象等重构手法。

5 1
Explore
tikazyq/agentic-spec-forge

arch-options-compare

比较多个架构方案（单体/微服务等），从SOLID原则、成本、复杂度等维度评分，生成对比表和推荐方案。当需要向客户解释架构选择或ADR决策时使用。

5 1
Explore
tikazyq/agentic-spec-forge

dev-tech-view-supplement

根据设计补充Dev视角的技术细节（数据库/API/通信协议），帮助Dev快速进入实施。当L1/L2设计缺乏技术细节、或准备向Dev交付前使用。

5 1
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results