技能 cqs-patterns
📦

cqs-patterns

内容修订 r1 安全 ⚙️ 外部命令

在 .NET 中应用 CQS 和 CQRS 模式

团队经常将状态变更和数据读取混在一起，这会让代码更难测试和理解。此技能指导你为 .NET 方法、处理程序和控制器设计清晰的 CQS 和 CQRS 方案。

支持: Claude Codex Code(CC)
🥉 77 青铜

使用我的智能体安装

将此请求复制给你的智能体，其中包含权威 Skill 页面和清单。

智能体请求
Review the Skillstore skill "cqs-patterns" from https://skillstore.io/skills/doubleslashse-cqs-patterns.md and its manifest at https://skillstore.io/api/skills/doubleslashse-cqs-patterns/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

你的智能体仍应展示其计划，并按安全策略请求必要确认。

Agent 可读资源

当 AI Agent、爬虫或脚本需要干净上下文，而不是读取完整页面时，请使用这些链接。

Markdown 详情 GET /skills/doubleslashse-cqs-patterns.md 已签名 manifest GET /api/skills/doubleslashse-cqs-patterns/manifest 已签名 lockfile GET /api/skills/doubleslashse-cqs-patterns/lockfile

测试它

正在使用“cqs-patterns”。 一个栈类有一个方法会移除并返回栈顶项。

预期结果:

  • 该方法混合了命令和查询。
  • 使用一个操作来查看栈顶项，并使用另一个独立操作来移除它。
  • 这能保证重复读取是安全的，并让状态变更更明确。

正在使用“cqs-patterns”。 一个订单功能需要创建、取消、查找和客户订单列表操作。

预期结果:

  • 创建和取消是命令，因为它们会改变状态。
  • 查找和列表操作是查询，因为它们返回数据且没有副作用。
  • 独立的处理程序让验证、持久化和读取优化更容易测试。

正在使用“cqs-patterns”。 正在考虑为一个小型 CRUD 管理页面使用 CQRS。

预期结果:

  • 对于简单的管理工作流，CQRS 可能会增加不必要的复杂度。
  • 只有当读取模型和写入模型存在明显不同的需求时才使用它。
  • 标准服务或控制器可能已经足够。

安全审计

安全
v9 • 2026/7/6 打开版本化报告

All static findings appear to be false positives caused by Markdown code fences, ASCII diagrams, and C# examples in documentation. I found no prompt injection, data exfiltration intent, executable scripts, network behavior, or real system reconnaissance in SKILL.md.

1
已扫描文件
532
分析行数
0
复核项
0
已忽略误报

风险因素

⚙️ 外部命令 (25)
SKILL.md:13-26 SKILL.md:26-33 SKILL.md:33-66 SKILL.md:66-69 SKILL.md:69-122 SKILL.md:122-131 SKILL.md:131-143 SKILL.md:143-146 SKILL.md:146-162 SKILL.md:162-165 SKILL.md:165-176 SKILL.md:176-184 SKILL.md:184-213 SKILL.md:213-217 SKILL.md:217-254 SKILL.md:254-258 SKILL.md:258-330 SKILL.md:330-334 SKILL.md:334-398 SKILL.md:398-402 SKILL.md:402-440 SKILL.md:440-444 SKILL.md:444-482 SKILL.md:482-518 SKILL.md:518-531
最新一次完成的静态与语义审计未检测到已确认的安全发现。这并不能证明该 Skill 没有副作用。
审计者: codex 查看审计历史 →
分享与引用此报告

分享版本化评估报告、中性徽章、嵌入卡片和引用。Skillstore 只报告证据，不判断该 Skill 是否安全。

打开版本化报告
安全评估

复制报告链接

https://skillstore.io/skills/doubleslashse-cqs-patterns/audits/9?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 徽章

[![Skillstore security assessment](https://skillstore.io/badges/skills/doubleslashse-cqs-patterns/security.svg)](https://skillstore.io/skills/doubleslashse-cqs-patterns?utm_source=security_passport_badge)

HTML 徽章

<a href="https://skillstore.io/skills/doubleslashse-cqs-patterns?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/doubleslashse-cqs-patterns/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

嵌入卡片

<iframe src="https://skillstore.io/embed/skills/doubleslashse-cqs-patterns.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
学术引用 (APA · BibTeX · CFF)

APA 引用

DoubleslashSE. (2026). cqs-patterns security audit report (audit version 9) [Author version unspecified]. Skillstore. https://skillstore.io/skills/doubleslashse-cqs-patterns/audits/9

BibTeX 引用

@techreport{doubleslashse-doubleslashse-cqs-patterns-2026, author = {DoubleslashSE}, title = {cqs-patterns security audit report (audit version 9)}, institution = {Skillstore}, year = {2026}, number = {9}, url = {https://skillstore.io/skills/doubleslashse-cqs-patterns/audits/9}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "cqs-patterns security audit report (audit version 9)" version: "unspecified" type: report authors: - name: "DoubleslashSE" date-released: "2026-07-06" url: "https://skillstore.io/skills/doubleslashse-cqs-patterns/audits/9" identifiers: - type: other value: "skillstore:doubleslashse-cqs-patterns:audit:9" description: "Skillstore immutable audit report identifier"

Skillstore 评分

评分依据 证据置信度: 高
55
架构
85
可维护性
87
内容
70
社区
78
规范符合性

你能构建什么

分离服务方法

审查既修改状态又返回领域数据的服务方法，然后将它们拆分为更清晰的命令和查询。

设计 CQRS 处理程序

为 .NET 应用程序层创建命令和查询记录，并配套相应的处理程序。

审查架构复杂度

判断某个功能是否需要 CQRS，或者更简单的 CRUD 模式是否更合适。

试试这些提示

识别 CQS 违规 
审查这个 .NET 类中的 CQS 违规。识别既改变状态又返回数据的方法，然后建议更简单的名称和职责。
重构为命令和查询 
将这个服务 API 重构为独立的命令和查询操作。保持行为等效，并解释每个新职责。
设计 CQRS 应用程序层 
为这个功能设计一个 CQRS 应用程序层。包括命令记录、查询记录、处理程序职责和控制器流程。
评估 CQRS 权衡 
评估 CQRS 是否适合这个系统。比较收益、增加的复杂度、测试影响、读取模型需求和替代方案。

最佳实践

  • 用祈使动词命名命令，用偏向读取的名称命名查询。
  • 保持查询无副作用，使其可以安全地重复执行。
  • 当读取路径和写入路径具有不同的模型、扩展需求或规则时，使用 CQRS。

避免

  • 从同时持久化变更的方法中返回完整领域对象。
  • 在没有明确需求的简单 CRUD 页面中引入 CQRS。
  • 将状态变更隐藏在 getter、计算属性或查询处理程序中。

常见问题

这个技能解决什么问题？
它帮助团队在 .NET 代码中分离会改变状态的操作和读取操作。
它会生成生产就绪代码吗？
它提供设计指导和示例，用户必须根据自己的应用程序进行调整。
CQS 和 CQRS 是一回事吗？
不是。CQS 是方法级原则，而 CQRS 在架构级别分离读取模型和写入模型。
什么时候应该避免使用 CQRS？
对于独立的读取模型和写入模型无法带来价值的简单 CRUD 工作流，应避免使用 CQRS。
命令可以返回标识符吗？
可以。该技能将从命令返回标识符视为可接受的实用例外。
哪些工具可以使用这个技能？
报告列出了对 Claude、Codex 和 Claude Code 的支持。

开发者详情

许可证

MIT

Skillstore 修订

r1

版本提示

作者未声明版本。

仓库

https://github.com/DoubleslashSE/claude-workflows/tree/main/Plugins/dotnet-tdd/skills/cqs-patterns

引用

72d5025b022c77f7a51bdf5c1637c689c80e89d1

维护新鲜度

2026/7/26

使用量

5 次下载 · 194 次浏览

文件结构

📄 SKILL.md

DoubleslashSE 的更多技能

查看全部

相关技能

查看全部