メニュー
Run .NET tests correctly using the test-with-timeout.sh wrapper to handle .NET 10 dual test runner modes and prevent test hangs.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/oocx/tfplan2md --skill run-dotnet-testsコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SOC 職業分類に基づく
SKILL.md を表示中
| name | run-dotnet-tests |
| description | Run .NET tests correctly using the test-with-timeout.sh wrapper to handle .NET 10 dual test runner modes and prevent test hangs. |
Provide standardized instructions for running .NET 10 tests correctly. Ensures agents use the scripts/test-with-timeout.sh wrapper instead of direct dotnet test calls, which fail due to .NET 10's dual test runner architecture.
scripts/test-with-timeout.sh wrapper - never call dotnet test directly--solution src/tfplan2md.slnx for full test suite runs--project with relative paths from src/ directory (e.g., --project tests/Oocx.TfPlan2Md.TUnit/)update-test-snapshots skill instead of manual editsdotnet test directly from command line - it will fail with MSB1001: Unknown switch errors from repo rootsrc/tests/Oocx.TfPlan2Md.TUnit/TestData/Snapshots/ - use the update-test-snapshots skill.NET 10 introduced two distinct test runners with incompatible CLI flags:
| Working Directory | Runner Mode | --solution | --project | --treenode-filter | Result |
|---|---|---|---|---|---|
Repo root (/) | VSTest | ❌ | ❌ | ❌ | MSBuild error MSB1001: Unknown switch |
src/ (where global.json lives) | Microsoft.Testing.Platform | ✅ | ✅ | ✅ | Works correctly |
The scripts/test-with-timeout.sh wrapper automatically:
src/ directory (where global.json with "runner": "Microsoft.Testing.Platform" exists)src/-prefixed paths in argumentsWhy direct dotnet test fails: Running from repo root activates VSTest mode (no global.json), which doesn't support --solution, --project, or --treenode-filter flags. The wrapper ensures tests run from src/ directory to activate Microsoft.Testing.Platform mode.
scripts/test-with-timeout.sh -- dotnet test --solution src/tfplan2md.slnx
scripts/test-with-timeout.sh -- dotnet test --solution src/tfplan2md.slnx --configuration Release --verbosity normal
scripts/test-with-timeout.sh -- dotnet test --solution src/tfplan2md.slnx --no-build
scripts/test-with-timeout.sh --timeout-seconds 300 -- dotnet test --solution src/tfplan2md.slnx
scripts/test-with-timeout.sh -- dotnet test --project tests/Oocx.TfPlan2Md.TUnit/
Important: This project uses TUnit (not xUnit). TUnit uses --treenode-filter instead of --filter. All TUnit-specific flags must come after -- in the wrapper command.
scripts/test-with-timeout.sh -- dotnet test --project tests/Oocx.TfPlan2Md.TUnit/ --treenode-filter /*/*/MarkdownRendererTests/*
scripts/test-with-timeout.sh -- dotnet test --project tests/Oocx.TfPlan2Md.TUnit/ --treenode-filter /*/*/*/Render_ValidPlan_ContainsSummarySection
TUnit uses hierarchical path patterns:
/*/*/*/TestMethodName - Match specific test method/*/*/ClassName/* - Match all tests in a class/*/Namespace.ClassName/* - Match by namespace and classDuring Development (after each meaningful change):
# Run targeted tests for the area you modified
scripts/test-with-timeout.sh -- dotnet test --project tests/Oocx.TfPlan2Md.TUnit/ --treenode-filter /*/*/YourTestClass/*
Before Committing (C# code changes only):
# Run full test suite to ensure no regressions
scripts/test-with-timeout.sh -- dotnet test --solution src/tfplan2md.slnx --no-build
Skip Tests When (documentation/agent instructions only):
.github/agents/, .github/skills/, .github/copilot-instructions.md, or docs/--treenode-filter to isolate itIf tests fail because snapshot files need updating (intentional output changes):
update-test-snapshots skill - Never manually edit snapshot filesSNAPSHOT_UPDATE_OK in commit message - Document the intentional change| Exit Code | Meaning | Action |
|---|---|---|
| 0 | All tests passed | Proceed with commit |
| 1-123 | Test failures | Fix failing tests before committing |
| 124 | Timeout | Increase timeout with --timeout-seconds or investigate hung tests |
| 125 | Wrapper error | Check command syntax |
Complete workflow for implementing a feature:
# 1. Build the project
dotnet build
# 2. Run targeted tests during development
scripts/test-with-timeout.sh -- dotnet test --project tests/Oocx.TfPlan2Md.TUnit/ --treenode-filter /*/*/MyFeatureTests/*
# 3. Make changes, run tests again
scripts/test-with-timeout.sh -- dotnet test --project tests/Oocx.TfPlan2Md.TUnit/ --treenode-filter /*/*/MyFeatureTests/*
# 4. Before committing, run full suite
scripts/test-with-timeout.sh -- dotnet test --solution src/tfplan2md.slnx --no-build
# 5. If all pass, commit changes
git add .
git commit -m "feat: implement my feature"
MSBuild error MSB1001: Unknown switchCause: Running dotnet test directly from repo root (VSTest mode doesn't support --solution/--project flags)
Solution: Use scripts/test-with-timeout.sh wrapper
Cause: Tests taking longer than default timeout
Solution: Increase timeout with --timeout-seconds 300 (or higher)
--treenode-filterCause: Incorrect filter pattern or test doesn't exist Solution:
scripts/test-with-timeout.sh -- dotnet test --list-testsCause: Intentional output format changes
Solution: Use update-test-snapshots skill to regenerate snapshots correctly
Minimum-requirements checklist for any change — code or docs-only. Run this before every PR creation or push to avoid CI failures on the first attempt.
Generate PNG screenshots for release notes using the repository's HtmlRenderer and ScreenshotGenerator tools. Use when asked to add screenshots to release notes or documentation.
Determine the next available issue number across all change types (feature, fix, workflow) by checking both local docs and remote branches, then reserve it by pushing an empty branch.