[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6MMYKZTAZVDPC4FZTW6N3RJ":3,"skill-same:01M6MMYKZTAZVDPC4FZTW6N3RJ":85},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":26,"publishedAt":50,"linkOnly":51,"markdownContent":52,"markdownBody":53,"frontMatter":54,"refName":55,"commitSha":56,"skillDirectory":57,"forksCount":58,"repositoryHtmlUrl":59,"repositoryHomepageUrl":60,"ownerHtmlUrl":61,"ownerBlogUrl":62,"ownerDescription":63,"updatedAt":64,"install":65,"resources":78},"01M6MMYKZTAZVDPC4FZTW6N3RJ","contam-mcp",null,"Use when working with CONTAM projects through the local contam MCP server, including discovering CONTAM executables and API integrations, listing .prj\u002F.sim\u002F.wth\u002F.ctm files, inspecting or diagnosing project references, cloning scenario folders, running baseline\u002Fintervention case matrices, using contamxpy for step-by-step co-simulation, updating weather or contaminant references, running simulations, upgrading projects, comparing .sim results, analyzing text outputs, exporting simulation text, or using bridge sessions for zone\u002Fpath\u002FAHS metadata and adjustments.","hashgraph-online\u002Fawesome-codex-plugins","hashgraph-online","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F160371962?v=4","01M6CNB6NRJVNNGN14TR01Q6D3","HOL (Hashgraph Online)","01M6JT1HSKKG9V68KQAQGBA7XP",1575,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fsummer521521\u002FCONTAM_plugin\u002Fskills\u002Fcontam-mcp\u002FSKILL.md",[18,23],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",[27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49],"contam mcp","MCP","cloning","Simulations","listing","when","path","co","scenario","project","local","references","files","bridge","integrations","text","projects","simulation","api","analyzing","server","mcp server","weather","2026-11-10 10:12:30",false,"---\nname: contam-mcp\ndescription: Use when working with CONTAM projects through the local contam MCP server, including discovering CONTAM executables and API integrations, listing .prj\u002F.sim\u002F.wth\u002F.ctm files, inspecting or diagnosing project references, cloning scenario folders, running baseline\u002Fintervention case matrices, using contamxpy for step-by-step co-simulation, updating weather or contaminant references, running simulations, upgrading projects, comparing .sim results, analyzing text outputs, exporting simulation text, or using bridge sessions for zone\u002Fpath\u002FAHS metadata and adjustments.\n---\n\n# CONTAM Plugin\n\nUse this skill when the user wants to inspect, diagnose, clone, batch-run, co-simulate, upgrade, compare, analyze, or export CONTAM projects through the `contam` MCP server.\n\n## Setup\n\n- The plugin starts the MCP server through `scripts\u002Fstart-contam-mcp.ps1`.\n- The plugin also ships `scripts\u002FInvoke-ContamProjectGuard.ps1` for local PRJ hygiene, input checks, output cleanup, result-profile updates, and XLog triage.\n- The current official CONTAM release checked for this workflow is CONTAM 3.4.0.8, with command-line tools such as ContamX 3.4.0.3. Re-check the official NIST release page before changing executable assumptions.\n- `CONTAM_PLUGIN_ROOT` is set by the launcher when the plugin runs from this repository.\n- `CONTAM_HOME` may point to the directory containing CONTAM executables.\n- `CONTAM_CHINESE_HOME` may point to an extracted `contam_chinese` release; when set, the launcher uses those localized executables unless explicit tool paths override them.\n- Optional executable overrides: `CONTAMX_PATH`, `CONTAMW_PATH`, `PRJUP_PATH`, `SIMREAD_PATH`, `SIMCOMP_PATH`.\n- The server targets command-line tools such as `contamx3.exe`, `prjup.exe`, `simread.exe`, and `simcomp.exe`; do not assume GUI automation through `contamw3.exe`.\n\n## Standard Flow\n\n1. Confirm the installation before running a case:\n   - `discover_contam_installation`\n   - `discover_contam_api_stack`\n2. Find candidate project and result files:\n   - `list_contam_case_files`\n3. Inspect the project before edits or simulation:\n   - `inspect_contam_project`\n   - `diagnose_contam_project`\n4. If references are wrong, update only the requested fields:\n   - `update_contam_project_references`\n5. For baseline\u002Fintervention studies, clone scenarios before running:\n   - `create_contam_case_variant`\n   - `run_contam_case_matrix`\n6. When a PRJ can run but needs ContamW-visible layout, apply SketchPad data before GUI review:\n   - `apply_contam_sketchpad_layout`\n7. Before asking the user to open or run in ContamW, use the project guard script for local checks:\n   - `scripts\u002FInvoke-ContamProjectGuard.ps1 -ProjectPath \u003Cfile.prj> -Mode InputCheck -ResultProfile GuiSafeResults -CleanOutputs -RequireSingleProject`\n8. For paper-style API workflows, use `contamxpy` when available:\n   - `inspect_contamxpy_project`\n   - `run_contamxpy_cosimulation`\n9. Run or upgrade the project:\n   - `run_contam_simulation`\n   - `upgrade_contam_project`\n10. Compare, export, or quickly triage results:\n   - `compare_contam_sim_results`\n   - `export_contam_sim_text`\n   - `analyze_contam_text_results`\n\n## Project Guard Flow\n\nUse `Invoke-ContamProjectGuard.ps1` whenever a generated or modified PRJ is expected to open in ContamW or be handed to another user.\n\nTypical commands:\n\n```powershell\n.\\scripts\\Invoke-ContamProjectGuard.ps1 `\n  -ProjectPath \"\u003Ccase>\\model.prj\" `\n  -Mode InputCheck `\n  -ResultProfile GuiSafeResults `\n  -CleanOutputs `\n  -RequireSingleProject\n```\n\nFor a command-line full run:\n\n```powershell\n.\\scripts\\Invoke-ContamProjectGuard.ps1 `\n  -ProjectPath \"\u003Ccase>\\model.prj\" `\n  -Mode Run `\n  -ResultProfile GuiSafeResults\n```\n\nUse this flow before GUI work:\n\n1. Keep case-specific data outside the plugin, for example `case-spec.json`, `layout.json`, `inputs\u002F*.csv`, and `ERRORS.md` in the case folder.\n2. Avoid local absolute paths in shared PRJ files; prefer relative case-local references so another user can move the case folder.\n3. Keep only one active `.prj` in a case folder unless the user explicitly wants scenarios; remove failed variants and stale result files.\n4. Repair UTF-8 BOM if present. CONTAM expects the format line at byte 0; PowerShell writes can accidentally break this.\n5. Run `InputCheck` after every PRJ edit. A ContamX input check passing means the text structure is readable; it does not prove SketchPad geometry is GUI-valid.\n6. Run full simulation from command line to separate solver failures from ContamW GUI result handoff failures.\n7. Inspect the newest `.xlog`; trust `Simulation completed successfully.` over a GUI impression that the console \"closed\".\n8. If a manual ContamW run reports `CONTAMX.EXE: simulation terminated abnormally` but command-line ContamX exits 0 and writes a successful XLog, treat it as a GUI result handoff\u002Floading issue, not a solver issue.\n\nFor generated models that are meant to match a hand-built ContamW reference, pass structural expectations into the guard:\n\n```powershell\n.\\scripts\\Invoke-ContamProjectGuard.ps1 `\n  -ProjectPath \"\u003Ccase>\\model.prj\" `\n  -Mode InputCheck `\n  -ExpectedZoneCount 9 `\n  -ExpectedPathCount 49 `\n  -ExpectedAmbientPathCount 40 `\n  -ExpectedInterzonePathCount 9 `\n  -MinimumAmbientPathsPerZone 1\n```\n\nUse the expected counts from the reference case, not from the generated model. A model can pass ContamX input checks while still being too simplified for the user's intended ContamW case.\n\n## Reference PRJ Learning Flow\n\nWhen the user provides a hand-built ContamW `.prj` as a reference for a generated project, treat the hand-built file as the structural source of truth before changing generation logic.\n\n1. Compare section counts first: zones, source\u002Fsink elements, flow elements, flow paths, source\u002Fsinks, schedules, and wind pressure profiles.\n2. Compare flow path inventory by class: zone-to-ambient paths, interzone paths, vertical or stair paths, and paths with wind pressure profile fields enabled.\n3. Preserve every real opening represented in the reference model. Do not collapse multiple facade leaks, doors, windows, supplies, and exhausts into one generic ambient path per room unless the user explicitly asks for a simplified model.\n4. Preserve inter-floor\u002Fstair connectivity as explicit paths. If the reference uses a stair or vertical connection, do not replace it with same-floor hall links just to make the SketchPad layout easier.\n5. If the reference has no wind pressure profiles and uses neutral exterior path fields, do not introduce WPC profiles merely because they look more physical. Add WPC only when the case definition, weather study, or user request requires it.\n6. Renaming zones, flow elements, schedules, and sources is useful for readability, but after renaming verify that source\u002Fsink rows, initial concentrations, schedule ids, and zone ids still point to the same physical rooms.\n7. For GUI-facing cases, prefer a complete path inventory plus simpler, valid SketchPad geometry over a visually clean drawing that hides or omits airflow paths.\n\nRecent lesson from a two-floor SF6\u002FCOMIS-style comparison: the hand-built reference had 9 zones, 18 flow elements, and 49 flow paths (40 ambient and 9 interzone), while a generated GUI variant had 9 zones, 20 flow elements, and 27 flow paths (20 ambient and 7 interzone). The useful correction is not to copy the case values into the plugin, but to force generated workflows to carry over the reference model's path inventory and check ambient\u002Finterzone counts explicitly.\n\n## Case Matrix Flow\n\nUse `run_contam_case_matrix` when the user needs a complete case workflow from an existing `.prj`:\n\n1. Keep the original project as the baseline source.\n2. Create one named folder per scenario.\n3. Apply only supported `.prj` reference changes when requested: `weatherFile`, `contaminantFile`, `continuousValuesFile`, `discreteValuesFile`, `wpcFile`, `ewcFile`.\n4. Run `testInputOnly` first for new or uncertain cases.\n5. Run full simulations after references and input checks pass.\n6. Use `analyze_contam_text_results` for quick `.xlog` or `simread` text triage, then write separate post-processing scripts for final charts or paper tables when needed.\n\n## SketchPad Layout Flow\n\nUse `apply_contam_sketchpad_layout` when an existing `.prj` already has simulation records but needs a ContamW-visible drawing.\n\n1. Inspect the project first to confirm zones, paths, source\u002Fsinks, and levels exist.\n2. Convert the user's verbal description, hand sketch, paper plan, or screenshot into a small layout spec.\n3. Use rectangles for simple rooms, clockwise orthogonal `polygon` points for jogged rooms, and explicit `wallSegments` for shared partitions that are visible in the sketch.\n4. Let the tool generate wall corner\u002Ftee\u002Fcross icons, zone icons, source\u002Fsink icons, and SketchPad size\u002Fscale metadata.\n5. Put all essential real doors, windows, supply\u002Fexhaust openings, and sources in explicit `pathIcons` or `sourceSinkIcons`. If a path is hidden and the user saves\u002Fruns from ContamW, ContamW may rewrite the PRJ from SketchPad state and drop that path.\n6. Put each airflow path icon on the wall that matches its PRJ direction field. A wrong side commonly produces Building Check messages such as `The same zone is on both sides of the wall that the path is on.`\n7. Avoid crowded or ambiguous tee\u002Fcross wall nodes. If ContamW draws long unintended wall lines or reports undefined zones, replace the layout with simpler closed room rectangles and valid shared-wall door icons.\n8. Be cautious with wall icon type `20` in generated layouts. It can be valid in official projects, but in some generated wall graphs it triggered ContamW GUI crashes; prefer simpler wall graphs or side-specific stable nodes and verify manually.\n9. For GUI review or screenshots, set `cleanDisplay: true` so pseudo-geometry is hidden and unplaced\u002Fhelper paths are omitted. Use `hideAirflowPathIcons: true` only for a read-only screenshot pass, not for a model that the user will save or run from ContamW.\n10. Prefer writing to `outputPath` for a first pass.\n11. Run the project guard `InputCheck` after layout changes, then ask the user to manually open in ContamW for Building Check screenshots if needed.\n\nTreat this as template-based SketchPad generation, not proof that ContamW will exactly reproduce a paper figure. Complex floor-plan tracing, curved geometry, and publication-style airflow diagrams still need dedicated post-processing or manual GUI checks.\n\n## ContamW Building Check Playbook\n\nWhen the user reports ContamW Building Check messages:\n\n- `At least one zone is not defined on level`: the SketchPad walls usually do not form closed regions on that level. Simplify to closed rectangles or fix wall graph nodes.\n- `The same zone is on both sides of the wall that the path is on`: the path icon is on the wrong wall side, lies inside a zone, or the surrounding wall does not divide two zones. Move the icon to the correct shared\u002Fexterior wall and align its direction.\n- `Zone not connected to ambient by variable flow link`: ambient links may exist in PRJ records but are hidden or not recognized in SketchPad. Show one valid exterior variable flow path per relevant zone.\n- `Vertical path is not above a sublevel` or floor same-zone errors: do not fake stairs with arbitrary vertical path icons. Either model a proper sublevel\u002Fstair representation or keep the uncertain vertical connection out of the GUI-run PRJ and document the assumption.\n- `PathList reordering error` or repeated possible level errors: stop editing the GUI variant, restore from the data spec or a known-good PRJ, then reapply a simpler layout.\n\nAlways record the user-visible message and the fix in a case-local `ERRORS.md` or equivalent notes file. Do not commit case-local logs or generated outputs into the plugin repository.\n\n## Result Output Profiles\n\nPrefer the guard's `GuiSafeResults` profile when the user will run from ContamW:\n\n```text\ndoDlg=1 pfsave=1 zfsave=1 zcsave=0\nach=1\ncsm=1 srf=1 log=1\n```\n\nThis follows a known working output pattern and avoids `zcsave=1`, which can trigger ContamW result handoff\u002Fdisplay problems in generated models.\n\nUse `NoResults` only for GUI crash isolation. If `NoResults` runs but result display fails, run the same PRJ with command-line ContamX and parse XLog\u002Fresults outside the GUI.\n\nDo not treat a ContamX console window closing after Enter as a failure by itself. Check the newest `.xlog`; if it says `Simulation completed successfully.`, the run completed normally.\n\n## Paper\u002FReport Workflow\n\nFor literature reproduction or report cases, keep the plugin generic and keep all paper-specific values in case-local files. A report generally needs:\n\n- zone table: names, levels, areas, volumes, temperatures, initial concentrations\n- airflow elements: leakage area\u002Fmodel\u002Fexponent and source table references\n- airflow paths: zone-to-zone and zone-to-ambient connectivity\n- species\u002Fsource\u002Fschedule settings\n- weather\u002Frun-control settings\n- ACH and contaminant time-series outputs\n- comparison and assumptions\n\nThe ContamW SketchPad screenshot is optional unless explicitly requested. It is a model-check artifact, not the primary evidence.\n\n## Bridge Sessions\n\nUse bridge sessions when the user needs zone, path, ambient target, AHS, or contaminant metadata, or when they need controlled changes during a run:\n\n- `start_contam_bridge_session`\n- `get_contam_bridge_session`\n- `list_contam_bridge_entities`\n- `advance_contam_bridge_session`\n- `close_contam_bridge_session`\n\nAlways close sessions when finished. For ambiguous path or zone selections, list entities first and use stable ids or selector labels rather than guessing.\n\n## Paper API Flow\n\nUse `discover_contam_api_stack` when the user references the CONTAM API paper, `contamx-lib`, `contamxpy`, `contamp-lib`, ANT, Rhino, or Grasshopper.\n\n- If `contamxpy` is available, prefer `inspect_contamxpy_project` for API-level metadata and `run_contamxpy_cosimulation` for time-step control, custom control logic, zone concentration sampling, flow sampling, and supported dynamic adjustments.\n- If ANT is unavailable, explain that Rhino\u002FGrasshopper + ANT are needed for the paper's 3D\u002Fmodel-creation path.\n- Do not claim full `contamp-lib` project creation unless Rhino\u002FGrasshopper ANT or a callable ContamP\u002Fcontamp-lib binding is actually present.\n\n## Safety\n\n- Prefer read-only inspection before modifying `.prj` files.\n- Before changing references, report the field names being changed and keep the edit scoped to the requested weather, contaminant, WPC, EWC, or library references.\n- Write outputs outside the plugin repository.\n- Treat scenario generation as template-based cloning, not full `contamp-lib`-style geometry\u002Fmodel creation.\n- Treat `contamxpy` as optional; if missing, run the repository setup script or ask the user before installing into a persistent environment.\n- If an executable cannot be found, ask the user to set `CONTAM_HOME` or the specific executable override instead of searching personal directories.\n","# CONTAM Plugin\n\nUse this skill when the user wants to inspect, diagnose, clone, batch-run, co-simulate, upgrade, compare, analyze, or export CONTAM projects through the `contam` MCP server.\n\n## Setup\n\n- The plugin starts the MCP server through `scripts\u002Fstart-contam-mcp.ps1`.\n- The plugin also ships `scripts\u002FInvoke-ContamProjectGuard.ps1` for local PRJ hygiene, input checks, output cleanup, result-profile updates, and XLog triage.\n- The current official CONTAM release checked for this workflow is CONTAM 3.4.0.8, with command-line tools such as ContamX 3.4.0.3. Re-check the official NIST release page before changing executable assumptions.\n- `CONTAM_PLUGIN_ROOT` is set by the launcher when the plugin runs from this repository.\n- `CONTAM_HOME` may point to the directory containing CONTAM executables.\n- `CONTAM_CHINESE_HOME` may point to an extracted `contam_chinese` release; when set, the launcher uses those localized executables unless explicit tool paths override them.\n- Optional executable overrides: `CONTAMX_PATH`, `CONTAMW_PATH`, `PRJUP_PATH`, `SIMREAD_PATH`, `SIMCOMP_PATH`.\n- The server targets command-line tools such as `contamx3.exe`, `prjup.exe`, `simread.exe`, and `simcomp.exe`; do not assume GUI automation through `contamw3.exe`.\n\n## Standard Flow\n\n1. Confirm the installation before running a case:\n   - `discover_contam_installation`\n   - `discover_contam_api_stack`\n2. Find candidate project and result files:\n   - `list_contam_case_files`\n3. Inspect the project before edits or simulation:\n   - `inspect_contam_project`\n   - `diagnose_contam_project`\n4. If references are wrong, update only the requested fields:\n   - `update_contam_project_references`\n5. For baseline\u002Fintervention studies, clone scenarios before running:\n   - `create_contam_case_variant`\n   - `run_contam_case_matrix`\n6. When a PRJ can run but needs ContamW-visible layout, apply SketchPad data before GUI review:\n   - `apply_contam_sketchpad_layout`\n7. Before asking the user to open or run in ContamW, use the project guard script for local checks:\n   - `scripts\u002FInvoke-ContamProjectGuard.ps1 -ProjectPath \u003Cfile.prj> -Mode InputCheck -ResultProfile GuiSafeResults -CleanOutputs -RequireSingleProject`\n8. For paper-style API workflows, use `contamxpy` when available:\n   - `inspect_contamxpy_project`\n   - `run_contamxpy_cosimulation`\n9. Run or upgrade the project:\n   - `run_contam_simulation`\n   - `upgrade_contam_project`\n10. Compare, export, or quickly triage results:\n   - `compare_contam_sim_results`\n   - `export_contam_sim_text`\n   - `analyze_contam_text_results`\n\n## Project Guard Flow\n\nUse `Invoke-ContamProjectGuard.ps1` whenever a generated or modified PRJ is expected to open in ContamW or be handed to another user.\n\nTypical commands:\n\n```powershell\n.\\scripts\\Invoke-ContamProjectGuard.ps1 `\n  -ProjectPath \"\u003Ccase>\\model.prj\" `\n  -Mode InputCheck `\n  -ResultProfile GuiSafeResults `\n  -CleanOutputs `\n  -RequireSingleProject\n```\n\nFor a command-line full run:\n\n```powershell\n.\\scripts\\Invoke-ContamProjectGuard.ps1 `\n  -ProjectPath \"\u003Ccase>\\model.prj\" `\n  -Mode Run `\n  -ResultProfile GuiSafeResults\n```\n\nUse this flow before GUI work:\n\n1. Keep case-specific data outside the plugin, for example `case-spec.json`, `layout.json`, `inputs\u002F*.csv`, and `ERRORS.md` in the case folder.\n2. Avoid local absolute paths in shared PRJ files; prefer relative case-local references so another user can move the case folder.\n3. Keep only one active `.prj` in a case folder unless the user explicitly wants scenarios; remove failed variants and stale result files.\n4. Repair UTF-8 BOM if present. CONTAM expects the format line at byte 0; PowerShell writes can accidentally break this.\n5. Run `InputCheck` after every PRJ edit. A ContamX input check passing means the text structure is readable; it does not prove SketchPad geometry is GUI-valid.\n6. Run full simulation from command line to separate solver failures from ContamW GUI result handoff failures.\n7. Inspect the newest `.xlog`; trust `Simulation completed successfully.` over a GUI impression that the console \"closed\".\n8. If a manual ContamW run reports `CONTAMX.EXE: simulation terminated abnormally` but command-line ContamX exits 0 and writes a successful XLog, treat it as a GUI result handoff\u002Floading issue, not a solver issue.\n\nFor generated models that are meant to match a hand-built ContamW reference, pass structural expectations into the guard:\n\n```powershell\n.\\scripts\\Invoke-ContamProjectGuard.ps1 `\n  -ProjectPath \"\u003Ccase>\\model.prj\" `\n  -Mode InputCheck `\n  -ExpectedZoneCount 9 `\n  -ExpectedPathCount 49 `\n  -ExpectedAmbientPathCount 40 `\n  -ExpectedInterzonePathCount 9 `\n  -MinimumAmbientPathsPerZone 1\n```\n\nUse the expected counts from the reference case, not from the generated model. A model can pass ContamX input checks while still being too simplified for the user's intended ContamW case.\n\n## Reference PRJ Learning Flow\n\nWhen the user provides a hand-built ContamW `.prj` as a reference for a generated project, treat the hand-built file as the structural source of truth before changing generation logic.\n\n1. Compare section counts first: zones, source\u002Fsink elements, flow elements, flow paths, source\u002Fsinks, schedules, and wind pressure profiles.\n2. Compare flow path inventory by class: zone-to-ambient paths, interzone paths, vertical or stair paths, and paths with wind pressure profile fields enabled.\n3. Preserve every real opening represented in the reference model. Do not collapse multiple facade leaks, doors, windows, supplies, and exhausts into one generic ambient path per room unless the user explicitly asks for a simplified model.\n4. Preserve inter-floor\u002Fstair connectivity as explicit paths. If the reference uses a stair or vertical connection, do not replace it with same-floor hall links just to make the SketchPad layout easier.\n5. If the reference has no wind pressure profiles and uses neutral exterior path fields, do not introduce WPC profiles merely because they look more physical. Add WPC only when the case definition, weather study, or user request requires it.\n6. Renaming zones, flow elements, schedules, and sources is useful for readability, but after renaming verify that source\u002Fsink rows, initial concentrations, schedule ids, and zone ids still point to the same physical rooms.\n7. For GUI-facing cases, prefer a complete path inventory plus simpler, valid SketchPad geometry over a visually clean drawing that hides or omits airflow paths.\n\nRecent lesson from a two-floor SF6\u002FCOMIS-style comparison: the hand-built reference had 9 zones, 18 flow elements, and 49 flow paths (40 ambient and 9 interzone), while a generated GUI variant had 9 zones, 20 flow elements, and 27 flow paths (20 ambient and 7 interzone). The useful correction is not to copy the case values into the plugin, but to force generated workflows to carry over the reference model's path inventory and check ambient\u002Finterzone counts explicitly.\n\n## Case Matrix Flow\n\nUse `run_contam_case_matrix` when the user needs a complete case workflow from an existing `.prj`:\n\n1. Keep the original project as the baseline source.\n2. Create one named folder per scenario.\n3. Apply only supported `.prj` reference changes when requested: `weatherFile`, `contaminantFile`, `continuousValuesFile`, `discreteValuesFile`, `wpcFile`, `ewcFile`.\n4. Run `testInputOnly` first for new or uncertain cases.\n5. Run full simulations after references and input checks pass.\n6. Use `analyze_contam_text_results` for quick `.xlog` or `simread` text triage, then write separate post-processing scripts for final charts or paper tables when needed.\n\n## SketchPad Layout Flow\n\nUse `apply_contam_sketchpad_layout` when an existing `.prj` already has simulation records but needs a ContamW-visible drawing.\n\n1. Inspect the project first to confirm zones, paths, source\u002Fsinks, and levels exist.\n2. Convert the user's verbal description, hand sketch, paper plan, or screenshot into a small layout spec.\n3. Use rectangles for simple rooms, clockwise orthogonal `polygon` points for jogged rooms, and explicit `wallSegments` for shared partitions that are visible in the sketch.\n4. Let the tool generate wall corner\u002Ftee\u002Fcross icons, zone icons, source\u002Fsink icons, and SketchPad size\u002Fscale metadata.\n5. Put all essential real doors, windows, supply\u002Fexhaust openings, and sources in explicit `pathIcons` or `sourceSinkIcons`. If a path is hidden and the user saves\u002Fruns from ContamW, ContamW may rewrite the PRJ from SketchPad state and drop that path.\n6. Put each airflow path icon on the wall that matches its PRJ direction field. A wrong side commonly produces Building Check messages such as `The same zone is on both sides of the wall that the path is on.`\n7. Avoid crowded or ambiguous tee\u002Fcross wall nodes. If ContamW draws long unintended wall lines or reports undefined zones, replace the layout with simpler closed room rectangles and valid shared-wall door icons.\n8. Be cautious with wall icon type `20` in generated layouts. It can be valid in official projects, but in some generated wall graphs it triggered ContamW GUI crashes; prefer simpler wall graphs or side-specific stable nodes and verify manually.\n9. For GUI review or screenshots, set `cleanDisplay: true` so pseudo-geometry is hidden and unplaced\u002Fhelper paths are omitted. Use `hideAirflowPathIcons: true` only for a read-only screenshot pass, not for a model that the user will save or run from ContamW.\n10. Prefer writing to `outputPath` for a first pass.\n11. Run the project guard `InputCheck` after layout changes, then ask the user to manually open in ContamW for Building Check screenshots if needed.\n\nTreat this as template-based SketchPad generation, not proof that ContamW will exactly reproduce a paper figure. Complex floor-plan tracing, curved geometry, and publication-style airflow diagrams still need dedicated post-processing or manual GUI checks.\n\n## ContamW Building Check Playbook\n\nWhen the user reports ContamW Building Check messages:\n\n- `At least one zone is not defined on level`: the SketchPad walls usually do not form closed regions on that level. Simplify to closed rectangles or fix wall graph nodes.\n- `The same zone is on both sides of the wall that the path is on`: the path icon is on the wrong wall side, lies inside a zone, or the surrounding wall does not divide two zones. Move the icon to the correct shared\u002Fexterior wall and align its direction.\n- `Zone not connected to ambient by variable flow link`: ambient links may exist in PRJ records but are hidden or not recognized in SketchPad. Show one valid exterior variable flow path per relevant zone.\n- `Vertical path is not above a sublevel` or floor same-zone errors: do not fake stairs with arbitrary vertical path icons. Either model a proper sublevel\u002Fstair representation or keep the uncertain vertical connection out of the GUI-run PRJ and document the assumption.\n- `PathList reordering error` or repeated possible level errors: stop editing the GUI variant, restore from the data spec or a known-good PRJ, then reapply a simpler layout.\n\nAlways record the user-visible message and the fix in a case-local `ERRORS.md` or equivalent notes file. Do not commit case-local logs or generated outputs into the plugin repository.\n\n## Result Output Profiles\n\nPrefer the guard's `GuiSafeResults` profile when the user will run from ContamW:\n\n```text\ndoDlg=1 pfsave=1 zfsave=1 zcsave=0\nach=1\ncsm=1 srf=1 log=1\n```\n\nThis follows a known working output pattern and avoids `zcsave=1`, which can trigger ContamW result handoff\u002Fdisplay problems in generated models.\n\nUse `NoResults` only for GUI crash isolation. If `NoResults` runs but result display fails, run the same PRJ with command-line ContamX and parse XLog\u002Fresults outside the GUI.\n\nDo not treat a ContamX console window closing after Enter as a failure by itself. Check the newest `.xlog`; if it says `Simulation completed successfully.`, the run completed normally.\n\n## Paper\u002FReport Workflow\n\nFor literature reproduction or report cases, keep the plugin generic and keep all paper-specific values in case-local files. A report generally needs:\n\n- zone table: names, levels, areas, volumes, temperatures, initial concentrations\n- airflow elements: leakage area\u002Fmodel\u002Fexponent and source table references\n- airflow paths: zone-to-zone and zone-to-ambient connectivity\n- species\u002Fsource\u002Fschedule settings\n- weather\u002Frun-control settings\n- ACH and contaminant time-series outputs\n- comparison and assumptions\n\nThe ContamW SketchPad screenshot is optional unless explicitly requested. It is a model-check artifact, not the primary evidence.\n\n## Bridge Sessions\n\nUse bridge sessions when the user needs zone, path, ambient target, AHS, or contaminant metadata, or when they need controlled changes during a run:\n\n- `start_contam_bridge_session`\n- `get_contam_bridge_session`\n- `list_contam_bridge_entities`\n- `advance_contam_bridge_session`\n- `close_contam_bridge_session`\n\nAlways close sessions when finished. For ambiguous path or zone selections, list entities first and use stable ids or selector labels rather than guessing.\n\n## Paper API Flow\n\nUse `discover_contam_api_stack` when the user references the CONTAM API paper, `contamx-lib`, `contamxpy`, `contamp-lib`, ANT, Rhino, or Grasshopper.\n\n- If `contamxpy` is available, prefer `inspect_contamxpy_project` for API-level metadata and `run_contamxpy_cosimulation` for time-step control, custom control logic, zone concentration sampling, flow sampling, and supported dynamic adjustments.\n- If ANT is unavailable, explain that Rhino\u002FGrasshopper + ANT are needed for the paper's 3D\u002Fmodel-creation path.\n- Do not claim full `contamp-lib` project creation unless Rhino\u002FGrasshopper ANT or a callable ContamP\u002Fcontamp-lib binding is actually present.\n\n## Safety\n\n- Prefer read-only inspection before modifying `.prj` files.\n- Before changing references, report the field names being changed and keep the edit scoped to the requested weather, contaminant, WPC, EWC, or library references.\n- Write outputs outside the plugin repository.\n- Treat scenario generation as template-based cloning, not full `contamp-lib`-style geometry\u002Fmodel creation.\n- Treat `contamxpy` as optional; if missing, run the repository setup script or ask the user before installing into a persistent environment.\n- If an executable cannot be found, ask the user to set `CONTAM_HOME` or the specific executable override instead of searching personal directories.\n",{"name":5,"description":7},"main","2b63f856ce19c2a797929cacabd9e0fc936812fa","plugins\u002Fsummer521521\u002FCONTAM_plugin\u002Fskills\u002Fcontam-mcp",491,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins","https:\u002F\u002Fhol.org\u002Fplugins\u002Fbest-codex-plugins","https:\u002F\u002Fgithub.com\u002Fhashgraph-online","https:\u002F\u002Fhol.org","Open-source standards and developer tools for interoperable AI agents: discovery, identity, communication, payments, privacy and security.","2026-11-14 14:06:13",{"source":8,"skillName":5,"commands":66,"prompt":76,"zipAvailable":77},[67,70,73],{"tool":68,"command":69},"npx","npx skills add hashgraph-online\u002Fawesome-codex-plugins --skill contam-mcp",{"tool":71,"command":72},"bunx","bunx skills add hashgraph-online\u002Fawesome-codex-plugins --skill contam-mcp",{"tool":74,"command":75},"pnpm","pnpm dlx skills add hashgraph-online\u002Fawesome-codex-plugins --skill contam-mcp","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fsummer521521\u002FCONTAM_plugin\u002Fskills\u002Fcontam-mcp\u002FSKILL.md",true,[79],{"path":80,"resourceType":81,"resourceTypeDesc":82,"sizeBytes":83,"sourceHtmlUrl":84},"agents\u002Fopenai.yaml","REFERENCE","参考文档",168,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fsummer521521\u002FCONTAM_plugin\u002Fskills\u002Fcontam-mcp\u002Fagents\u002Fopenai.yaml",[86,96,104,112,120,128],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":90,"licenseFileUrl":91,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":95},"01M7DV332YQMGD8WTRJ9DZQXTB","worktable-review-with-annotations","Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.","MIT","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":90,"licenseFileUrl":100,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":95},"01M7DV2YGHCZVBEB1AHYB6CGHE","worktable-find-and-synthesize-context","Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FSKILL.md",[],[],{"skillNo":105,"name":106,"nameZh":6,"description":107,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":90,"licenseFileUrl":108,"sourceHtmlUrl":109,"categories":110,"keywords":111,"publishedAt":95},"01M7DV2TQN1H11ME2SAF9MXN7V","worktable-create-or-update-docs","Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FSKILL.md",[],[],{"skillNo":113,"name":114,"nameZh":6,"description":115,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":90,"licenseFileUrl":116,"sourceHtmlUrl":117,"categories":118,"keywords":119,"publishedAt":95},"01M7DV2NE452NEA8TXATKSNAJH","worktable-create-or-manage-records","Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FSKILL.md",[],[],{"skillNo":121,"name":122,"nameZh":6,"description":123,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":90,"licenseFileUrl":124,"sourceHtmlUrl":125,"categories":126,"keywords":127,"publishedAt":95},"01M7DV2HENRBR2KSCVM064WH0Y","worktable-create-or-manage-interactive-html","Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FSKILL.md",[],[],{"skillNo":129,"name":130,"nameZh":6,"description":131,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":90,"licenseFileUrl":132,"sourceHtmlUrl":133,"categories":134,"keywords":135,"publishedAt":95},"01M7DV2CADR5R7RQFFYPNAGR9Y","worktable-collaborate-threads","Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FSKILL.md",[],[]]