| name | u0939-infra-knowledge-graph-linker |
| description | Build and operate the "Infra Knowledge Graph Linker" capability for Infrastructure and Sustainability. Trigger when this exact capability is needed in mission execution. |
Infra Knowledge Graph Linker
Why This Skill Exists
We need this skill because long-term scale depends on resilient and sustainable infrastructure choices. This specific skill connects fragmented facts into reusable structures.
When To Use
Use this skill when the request explicitly needs "Infra Knowledge Graph Linker" outcomes in the Infrastructure and Sustainability domain.
Step-by-Step Implementation Guide
- Define the scope and success metrics for
Infra Knowledge Graph Linker, including at least three measurable KPIs tied to capacity collapse and environmental debt.
- Design and version the input/output contract for capacity forecasts, energy usage, and sustainability metrics, then add schema validation and failure-mode handling.
- Implement the core capability using entity and relation linking, and produce linked knowledge entities with deterministic scoring.
- Integrate the skill into swarm orchestration: task routing, approval gates, retry strategy, and rollback controls.
- Add unit, integration, and simulation tests that explicitly cover capacity collapse and environmental debt, then run regression baselines.
- Deploy behind a feature flag, monitor telemetry/alerts for two release cycles, and iterate thresholds based on observed outcomes.
Required Deliverables
- Capability contract: input schema, deterministic scoring, output schema, and failure modes.
- Runtime profile: general-capability using entity and relation linking to produce linked knowledge entities.
- Orchestration integration: infrastructure-and-sustainability:general-capability routing, approval gates, retries, and rollback controls.
- Validation evidence: unit, integration, simulation, regression-baseline suites and rollout telemetry.
Operational Runbook
Preflight
- Confirm the Infra Knowledge Graph Linker request scope, source evidence, and measurable success criteria before execution.
- Verify feature flag skill_0939_infra-knowledge-graph-linker, approval gates, and rollback owner before autonomous use.
Execution
- Execute entity and relation linking with deterministic scoring and reproducible trace capture.
- Produce linked knowledge entities plus scorecard, assumptions, and unresolved-risk notes.
Recovery
- Fail closed when required signals, evidence, or approval gates are missing.
- Rollback to the last stable baseline when posture is critical or validation fails.
Handoff
- Publish linked knowledge entities, validation evidence, and telemetry links to downstream owners.
- Queue follow-up tasks for unresolved risks, threshold tuning, or approval review.
Guardrails
- [quality] Require deterministic scoring and validation evidence before promotion.
- [reliability] Preserve retries, rollback controls, and failure-mode evidence for every run.
- [safety] Route critical posture or missing approval gates to human review before autonomous action.
