跳到正文
cccskills
免费在 GitHub 公开

dotnet-agent-guardrails

Deterministic guardrails for defining the review/validation process in .NET/C# development agents and agent squads: .editorconfig + dotnet format, TreatWarningsAsErrors, custom Roslyn analyzers, full test suites, Aspire telemetry, and Copilot/Claude Code hooks as the gates a change must pass. USE FOR: defining what 'done' means and which deterministic checks gate an agent-generated .NET change before merge, for a single agent or a squad of agents/subagents sharing a repo. DO NOT USE FOR: general AGENTS.md authoring for non-.NET repos (agents-md); C# style rules (csharp-best-practices); non-agent solution scaffolding (dotnet-solution-setup); BenchmarkDotNet usage (dotnet-benchmarking).

中文简介正在准备中。当前显示原文说明。

NetFabric/NetFabric.Numerics星标 36(GitHub 36 + cccskills 0)

实测评分 未实测

查看安装方法

包含的文件(5)

  • SKILL.md4.2 KB
  • references/aspire-agent-native.md2.2 KB
  • references/conventions-and-analyzers.md3.7 KB
  • references/hooks-governance.md1.9 KB
  • references/testing-contract.md1.6 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

.NET Development in the Code Agent Era

Code agents are non-deterministic — the same prompt can yield different code. The .NET toolchain is deterministic by design; wire it up as guardrails instead of trusting agent output alone.

Anatomy

FilePurpose
SKILL.mdGuardrail overview + AGENTS.md wiring
references/conventions-and-analyzers.md.editorconfig, dotnet format, TreatWarningsAsErrors, custom Roslyn analyzer projects
references/testing-contract.mdTest tiers as the behavioral contract, agent failure-triage pattern
references/aspire-agent-native.mdAspire orchestration, telemetry, and agent-as-service integration
references/hooks-governance.mdHooks as a governance layer, hook categories, file-based C# scripts

The Six Guardrails

GuardrailToolEnforcesConfig
Conventionsdotnet format + .editorconfigstyle, naming, import order.editorconfig
Compiler strictnessTreatWarningsAsErrorsnullability, unreachable code, API misuseDirectory.Build.props
Architecturecustom Roslyn analyzer projectdomain/architecture rules with no built-in analyzerProjectReference OutputItemType="Analyzer"
Behaviorfull test suite (unit/integration/e2e)correctness, regressionsCI + AGENTS.md instruction
RuntimeAspire AppHostservice wiring, config, telemetryAppHost project
Actionsagent hooksintercept/validate agent edits before they landhook scripts (file-based C#)

Each is deterministic: same input, same result, every run. That stability is what lets an agent self-correct across turns instead of drifting.

AGENTS.md Wiring

Encode "done" in operational, checkable terms — not "write clean code":

Run `dotnet format` to ensure code style compliance. Issues not automatically fixed
must be resolved manually. A feature is not complete until `dotnet format` exits
with code 0 and the full test suite passes.

Directory.Build.props — Minimum

<PropertyGroup>
  <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
</PropertyGroup>

Set once in Directory.Build.props at the repo root so every project inherits it — see dotnet-solution-setup for the full shared-properties list.

Practical Example

BookStore applies all six guardrails (conventions, analyzers, tests, Aspire, hooks) in one open-source .NET solution.

Reference Files

FileLoad When
references/conventions-and-analyzers.mdWiring .editorconfig/dotnet format/TreatWarningsAsErrors, or scaffolding a custom Roslyn analyzer project
references/testing-contract.mdDeciding test tiers, writing AGENTS.md test instructions, triaging agent-caused test failures
references/aspire-agent-native.mdUsing Aspire orchestration/telemetry so an agent can reason about a running distributed system
references/hooks-governance.mdWriting or categorizing Copilot/Claude Code hooks that gate agent actions

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Abstract math for 3D rotation representations and conversions. USE FOR: understanding axis-angle representation; Euler angles (yaw/pitch/roll, convention choices); rotation matrices (SO(3)); quaternion-based rotation; converting between representations; identifying and avoiding gimbal lock; composing rotations; half-angle formula; right-hand rule. DO NOT USE FOR: quaternion arithmetic details (use quaternion-algebra); slerp/lerp interpolation (use interpolation-on-manifolds); coordinate system definitions (use coordinate-system-conversions).

中文简介正在准备中。当前显示原文说明。

NetFabric/NetFabric.Numerics362026年8月10日 更新

Design and scaffold multi-agent squads/swarms using the graph orchestration pattern (nodes = agents, edges = dependencies/data flow). USE FOR: designing a coordination topology for a multi-agent squad (sequential pipeline, parallel fan-out/aggregation, branching, feedback loop, cyclic); building an orchestrator agent that delegates to specialist agents; setting up an adversarial/tribunal code or document review with independent reviewers; scaffolding a squad's agent files for a target coding-agent harness (e.g. Copilot CLI or Claude Code custom agents). DO NOT USE FOR: authoring a single agent's frontmatter/prompt body (use copilot-cli-custom-agents, claude-code-custom-agents, or the target harness's own skill); SKILL.md authoring (use create-skill); ad-hoc multi-agent chat with no explicit topology.

中文简介正在准备中。当前显示原文说明。

NetFabric/NetFabric.Numerics362026年8月10日 更新

Find, inspect, query, redact, and troubleshoot logs, transcripts, sessions, and OpenTelemetry data from coding-agent harnesses on Windows, macOS, Linux, and WSL. USE FOR: GitHub Copilot in VS Code; Copilot CLI; Claude Code; OpenAI Codex; Gemini CLI; OpenCode; Cursor, Windsurf, Kiro, or other VS Code-family editors; locating log files; diagnosing tool or model failures; correlating turns, subagents, and tool calls; querying JSONL, plaintext, or SQLite without spending model tokens; preparing sanitized diagnostics. DO NOT USE FOR: application logs unrelated to coding agents; uploading raw logs; treating unstable transcript schemas as public APIs.

中文简介正在准备中。当前显示原文说明。

NetFabric/NetFabric.Numerics362026年8月10日 更新

agents-md

免费

Author and maintain AGENTS.md files — the open, tool-agnostic format for giving coding agents project context. Use when: creating AGENTS.md; writing an agent instructions file; root or nested AGENTS.md for monorepos; migrating CLAUDE.md, AGENT.md, .cursor/rules, or copilot-instructions.md to AGENTS.md; greenfield project setup before code exists; brownfield onboarding for an existing codebase; documenting build/test/lint commands, code style, PR/commit conventions, and security considerations for agents; AGENTS.md discovery and precedence rules. Works for any language, framework, or project size. DO NOT USE FOR: authoring SKILL.md skill files (use create-skill); APM package/plugin authoring (use apm-producer); language-specific style rules (use language skills e.g. csharp-best-practices).

中文简介正在准备中。当前显示原文说明。

NetFabric/NetFabric.Numerics362026年8月10日 更新

Abstract math for angle measurement, unit systems, and circular arithmetic. USE FOR: implementing angle types; converting between degrees/radians/gradians/revolutions; reducing angles to canonical range [0, Full); computing reference angles and quadrants; implementing safe modular arithmetic with negative inputs; angle addition and subtraction; classifying angles by sign and size. DO NOT USE FOR: trigonometric functions (use trigonometric-functions); coordinate conversions (use coordinate-system-conversions); interpolation (use interpolation-on-manifolds).

中文简介正在准备中。当前显示原文说明。

NetFabric/NetFabric.Numerics362026年8月10日 更新

Create and maintain Claude Code custom subagents (.claude/agents/*.md files). USE FOR: authoring project (.claude/agents/) or user (~/.claude/agents/) subagent files; frontmatter fields (name, description, tools, disallowedTools, model, permissionMode, maxTurns, skills, mcpServers, hooks, memory, background, effort, isolation, color, initialPrompt); writing descriptions that drive automatic delegation and 'use proactively' phrasing; invoking subagents via natural language, @-mention, session-wide --agent, or the Agent tool; restricting which subagent types a coordinator can spawn with Agent(name1, name2); nested subagents and depth limits; built-in subagents (Explore, Plan, general-purpose, claude); troubleshooting a subagent that won't load or isn't invoked. DO NOT USE FOR: GitHub Copilot CLI custom agents (use copilot-cli-custom-agents); agent teams/teammates (a different, session-spanning feature); MCP server authoring; SKILL.md authoring (use create-skill).

中文简介正在准备中。当前显示原文说明。

NetFabric/NetFabric.Numerics362026年8月10日 更新

查看 NetFabric 的全部技能

报告此技能的问题