Agent Skills
› NeverSight/learn-skills.dev
› inspector-operations
inspector-operations
GitHub用于在3Lens中导航和检查实体（如网格、材质、纹理、着色器）。支持查看依赖关系、成本归因路径及变更历史，可通过查询选择实体或深入分析性能瓶颈与根因。
Trigger Scenarios
检查特定实体的详细信息
理解实体间的依赖关系
追踪成本归因路径
通过查询程序化选择实体
Install
npx skills add NeverSight/learn-skills.dev --skill inspector-operations -g -y
SKILL.md
Frontmatter
{
"name": "inspector-operations",
"description": "Navigate and inspect 3Lens entities including meshes, materials, textures, and shaders. Use when examining specific entities, understanding dependencies, tracing cost attribution, or selecting entities by query."
}
Inspector Operations
The Inspector is the spine of 3Lens. All tools route through selection and entity inspection. Use these commands to examine entities in detail.
When to Use
- Examining a specific entity (mesh, material, texture, shader)
- Understanding entity dependencies and relationships
- Tracing cost attribution paths
- Selecting entities programmatically via query
Commands
Inspect an Entity
# Basic entity inspection
3lens inspect <entityId>
# Include additional data
3lens inspect <entityId> --include edges,cost,diffs
# Output as JSON
3lens inspect <entityId> --format json
Output includes:
- Identity: type, id, origin
- Dependencies: incoming/outgoing edges
- Cost attribution: weighted blame chains
- Lifecycle + diffs: creation, updates, disposal
Select by Query
# Select top GPU cost entities
3lens inspect --query "top_gpu_cost" --limit 5
# Select materials using a specific texture
3lens inspect --query "materials_using_texture:tex123"
The 5 Inspector Questions
Every entity inspection should answer:
- What is this? (type, properties, origin)
- What does it depend on? (incoming edges)
- What depends on it? (outgoing edges)
- How much does it cost? (attributed metrics with blame chain)
- How has it changed? (diffs over time/traces)
Entity ID Format
Entity IDs follow a stable, namespaced format:
<type>:<namespace>:<identifier>
Examples:
mesh:scene:Player_Avatar
material:default:PBR_Metal_01
texture:loaded:albedo_diffuse.png
shader:compiled:StandardPBR_v123
Agent Use Cases
- Root cause analysis: "Inspect entity mesh:scene:Player to find why it's expensive"
- Dependency tracking: "Show all materials that depend on this texture"
- Cost attribution: "Trace the blame chain for this GPU hotspot"
- Bulk selection: "Select all entities matching this query"
Additional Resources
- For detailed command syntax, see .cursor/commands/
- For Inspector contract, see .cursor/contracts/inspector.md
- For entity graph rules, see .cursor/contracts/entity-graph.md
- Inspector is runtime/UI; see addon-inspector for implementation
- Contract: attribution.md
- Contract: fidelity.md
Version History
- e0220ca Current 2026-07-05 23:30
