winter-super-cli 2026.5.31 → 2026.6.5

package/resources/local/ecc/docs/zh-CN/skills/hexagonal-architecture/SKILL.md

@@ -0,0 +1,276 @@
+---
+name: hexagonal-architecture
+description: 设计、实现并重构端口与适配器系统，具有清晰的领域边界、依赖反转以及跨 TypeScript、Java、Kotlin 和 Go 服务的可测试用例编排。
+origin: ECC
+---
+
+# 六边形架构
+
+六边形架构（端口与适配器）使业务逻辑独立于框架、传输层和持久化细节。核心应用依赖于抽象端口，而适配器在边缘实现这些端口。
+
+## 适用场景
+
+* 构建需要长期可维护性和可测试性的新功能。
+* 重构分层或框架密集型代码，其中领域逻辑与I/O关注点混杂。
+* 为同一用例支持多种接口（HTTP、CLI、队列工作器、定时任务）。
+* 替换基础设施（数据库、外部API、消息总线）而无需重写业务规则。
+
+当需求涉及边界、领域驱动设计、重构紧耦合服务，或将应用逻辑与特定库解耦时，使用此技能。
+
+## 核心概念
+
+* **领域模型**：业务规则和实体/值对象。无框架导入。
+* **用例（应用层）**：编排领域行为和工作流步骤。
+* **入站端口**：描述应用能力的契约（命令/查询/用例接口）。
+* **出站端口**：应用所需依赖的契约（仓库、网关、事件发布器、时钟、UUID等）。
+* **适配器**：端口的基础设施和交付实现（HTTP控制器、数据库仓库、队列消费者、SDK封装器）。
+* **组合根**：将具体适配器绑定到用例的单一连接位置。
+
+出站端口接口通常位于应用层（仅当抽象真正属于领域层时才位于领域层），而基础设施适配器实现它们。
+
+依赖方向始终向内：
+
+* 适配器 -> 应用/领域
+* 应用 -> 端口接口（入站/出站契约）
+* 领域 -> 仅领域抽象（无框架或基础设施依赖）
+* 领域 -> 无外部依赖
+
+## 工作原理
+
+### 步骤1：建模用例边界
+
+定义具有清晰输入和输出DTO的单个用例。将传输细节（Express `req`、GraphQL `context`、任务负载包装器）保持在此边界之外。
+
+### 步骤2：首先定义出站端口
+
+将每个副作用识别为端口：
+
+* 持久化（`UserRepositoryPort`）
+* 外部调用（`BillingGatewayPort`）
+* 横切关注点（`LoggerPort`、`ClockPort`）
+
+端口应建模能力，而非技术。
+
+### 步骤3：使用纯编排实现用例
+
+用例类/函数通过构造函数/参数接收端口。它验证应用层不变量，协调领域规则，并返回纯数据结构。
+
+### 步骤4：在边缘构建适配器
+
+* 入站适配器将协议输入转换为用例输入。
+* 出站适配器将应用契约映射到具体API/ORM/查询构建器。
+* 映射保持在适配器中，而非用例内部。
+
+### 步骤5：在组合根中连接所有组件
+
+实例化适配器，然后将其注入用例。保持此连接集中化，以避免隐藏的服务定位器行为。
+
+### 步骤6：按边界测试
+
+* 使用伪造端口对用例进行单元测试。
+* 使用真实基础设施依赖对适配器进行集成测试。
+* 通过入站适配器对面向用户的流程进行端到端测试。
+
+## 架构图
+
+```mermaid
+flowchart LR
+  Client["Client (HTTP/CLI/Worker)"] --> InboundAdapter["Inbound Adapter"]
+  InboundAdapter -->|"calls"| UseCase["UseCase (Application Layer)"]
+  UseCase -->|"uses"| OutboundPort["OutboundPort (Interface)"]
+  OutboundAdapter["Outbound Adapter"] -->|"implements"| OutboundPort
+  OutboundAdapter --> ExternalSystem["DB/API/Queue"]
+  UseCase --> DomainModel["DomainModel"]
+```
+
+## 建议的模块布局
+
+使用以功能为先的组织方式，并带有显式边界：
+
+```text
+src/
+  features/
+    orders/
+      domain/
+        Order.ts
+        OrderPolicy.ts
+      application/
+        ports/
+          inbound/
+            CreateOrder.ts
+          outbound/
+            OrderRepositoryPort.ts
+            PaymentGatewayPort.ts
+        use-cases/
+          CreateOrderUseCase.ts
+      adapters/
+        inbound/
+          http/
+            createOrderRoute.ts
+        outbound/
+          postgres/
+            PostgresOrderRepository.ts
+          stripe/
+            StripePaymentGateway.ts
+      composition/
+        ordersContainer.ts
+```
+
+## TypeScript 示例
+
+### 端口定义
+
+```typescript
+export interface OrderRepositoryPort {
+  save(order: Order): Promise<void>;
+  findById(orderId: string): Promise<Order | null>;
+}
+
+export interface PaymentGatewayPort {
+  authorize(input: { orderId: string; amountCents: number }): Promise<{ authorizationId: string }>;
+}
+```
+
+### 用例
+
+```typescript
+type CreateOrderInput = {
+  orderId: string;
+  amountCents: number;
+};
+
+type CreateOrderOutput = {
+  orderId: string;
+  authorizationId: string;
+};
+
+export class CreateOrderUseCase {
+  constructor(
+    private readonly orderRepository: OrderRepositoryPort,
+    private readonly paymentGateway: PaymentGatewayPort
+  ) {}
+
+  async execute(input: CreateOrderInput): Promise<CreateOrderOutput> {
+    const order = Order.create({ id: input.orderId, amountCents: input.amountCents });
+
+    const auth = await this.paymentGateway.authorize({
+      orderId: order.id,
+      amountCents: order.amountCents,
+    });
+
+    // markAuthorized returns a new Order instance; it does not mutate in place.
+    const authorizedOrder = order.markAuthorized(auth.authorizationId);
+    await this.orderRepository.save(authorizedOrder);
+
+    return {
+      orderId: order.id,
+      authorizationId: auth.authorizationId,
+    };
+  }
+}
+```
+
+### 出站适配器
+
+```typescript
+export class PostgresOrderRepository implements OrderRepositoryPort {
+  constructor(private readonly db: SqlClient) {}
+
+  async save(order: Order): Promise<void> {
+    await this.db.query(
+      "insert into orders (id, amount_cents, status, authorization_id) values ($1, $2, $3, $4)",
+      [order.id, order.amountCents, order.status, order.authorizationId]
+    );
+  }
+
+  async findById(orderId: string): Promise<Order | null> {
+    const row = await this.db.oneOrNone("select * from orders where id = $1", [orderId]);
+    return row ? Order.rehydrate(row) : null;
+  }
+}
+```
+
+### 组合根
+
+```typescript
+export const buildCreateOrderUseCase = (deps: { db: SqlClient; stripe: StripeClient }) => {
+  const orderRepository = new PostgresOrderRepository(deps.db);
+  const paymentGateway = new StripePaymentGateway(deps.stripe);
+
+  return new CreateOrderUseCase(orderRepository, paymentGateway);
+};
+```
+
+## 多语言映射
+
+在不同生态系统中使用相同的边界规则；仅语法和连接方式发生变化。
+
+* **TypeScript/JavaScript**
+  * 端口：`application/ports/*` 作为接口/类型。
+  * 用例：带有构造函数/参数注入的类/函数。
+  * 适配器：`adapters/inbound/*`、`adapters/outbound/*`。
+  * 组合：显式工厂/容器模块（无隐藏全局变量）。
+* **Java**
+  * 包：`domain`、`application.port.in`、`application.port.out`、`application.usecase`、`adapter.in`、`adapter.out`。
+  * 端口：`application.port.*` 中的接口。
+  * 用例：普通类（Spring `@Service` 是可选的，非必需）。
+  * 组合：Spring配置或手动连接类；将连接逻辑保持在领域/用例类之外。
+* **Kotlin**
+  * 模块/包镜像Java的拆分（`domain`、`application.port`、`application.usecase`、`adapter`）。
+  * 端口：Kotlin接口。
+  * 用例：带有构造函数注入的类（Koin/Dagger/Spring/手动）。
+  * 组合：模块定义或专用组合函数；避免服务定位器模式。
+* **Go**
+  * 包：`internal/<feature>/domain`、`application`、`ports`、`adapters/inbound`、`adapters/outbound`。
+  * 端口：由消费应用包拥有的小型接口。
+  * 用例：带有接口字段和显式 `New...` 构造函数的结构体。
+  * 组合：在 `cmd/<app>/main.go` 中连接（或专用连接包），保持构造函数显式。
+
+## 应避免的反模式
+
+* 领域实体导入ORM模型、Web框架类型或SDK客户端。
+* 用例直接从 `req`、`res` 或队列元数据读取。
+* 从用例直接返回数据库行，未经领域/应用映射。
+* 让适配器直接相互调用，而非通过用例端口流转。
+* 将依赖连接分散到多个文件中，使用隐藏的全局单例。
+
+## 迁移手册
+
+1. 选择一个垂直切片（单个端点/任务），该切片频繁变更且带来痛苦。
+2. 提取具有显式输入/输出类型的用例边界。
+3. 围绕现有基础设施调用引入出站端口。
+4. 将编排逻辑从控制器/服务移动到用例中。
+5. 保留旧适配器，但使其委托给新用例。
+6. 围绕新边界添加测试（单元测试 + 适配器集成测试）。
+7. 逐个切片重复；避免完全重写。
+
+### 重构现有系统
+
+* **绞杀者模式**：保留当前端点，一次将一个用例路由到新的端口/适配器。
+* **无大爆炸式重写**：按功能切片迁移，并通过特征化测试保持行为。
+* **先建外观**：在替换内部实现之前，将遗留服务包装在出站端口后面。
+* **组合冻结**：尽早集中连接，使新依赖不会泄漏到领域/用例层。
+* **切片选择规则**：优先处理高变更频率、低影响范围的流程。
+* **回滚路径**：为每个迁移的切片保留可逆开关或路由切换，直到生产行为得到验证。
+
+## 测试指南（相同的六边形边界）
+
+* **领域测试**：将实体/值对象作为纯业务规则进行测试（无模拟，无框架设置）。
+* **用例单元测试**：使用出站端口的伪造/桩件测试编排；断言业务结果和端口交互。
+* **出站适配器契约测试**：在端口级别定义共享契约套件，并针对每个适配器实现运行。
+* **入站适配器测试**：验证协议映射（HTTP/CLI/队列负载到用例输入，以及输出/错误映射回协议）。
+* **适配器集成测试**：针对真实基础设施（数据库/API/队列）运行，测试序列化、模式/查询行为、重试和超时。
+* **端到端测试**：覆盖关键用户旅程，通过入站适配器 -> 用例 -> 出站适配器。
+* **重构安全性**：在提取之前添加特征化测试；保持它们直到新边界行为稳定且等价。
+
+## 最佳实践清单
+
+* 领域和应用层仅导入内部类型和端口。
+* 每个外部依赖都由一个出站端口表示。
+* 验证发生在边界处（入站适配器 + 用例不变量）。
+* 使用不可变转换（返回新值/实体，而非修改共享状态）。
+* 错误在边界间进行转换（基础设施错误 -> 应用/领域错误）。
+* 组合根是显式的且易于审计。
+* 用例可通过简单的内存伪造端口进行测试。
+* 重构从具有行为保持测试的一个垂直切片开始。
+* 语言/框架特定内容保持在适配器中，绝不进入领域规则。

package/resources/local/ecc/docs/zh-CN/skills/hipaa-compliance/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: hipaa-compliance
+description: 针对医疗隐私和安全工作的HIPAA特定入口点。当任务明确围绕HIPAA、PHI处理、受保实体、BAA、违规态势或美国医疗合规要求时使用。
+origin: ECC direct-port adaptation
+version: "1.0.0"
+---
+
+# HIPAA 合规
+
+当任务明确涉及美国医疗合规时，以此作为 HIPAA 专用入口。此技能刻意保持精简和规范：
+
+* `healthcare-phi-compliance` 仍是处理 PHI/PII、数据分类、审计日志、加密和泄露防护的主要实施技能。
+* `healthcare-reviewer` 仍是当代码、架构或产品行为需要医疗感知的二次审查时的专业审核者。
+* `security-review` 仍适用于通用认证、输入处理、密钥、API 和部署加固。
+
+## 使用时机
+
+* 请求明确提及 HIPAA、PHI、受保实体、业务伙伴或 BAA
+* 构建或审查存储、处理、导出或传输 PHI 的美国医疗软件
+* 评估日志记录、分析、LLM 提示、存储或支持工作流是否产生 HIPAA 暴露风险
+* 设计面向患者或临床医生的系统时，需关注最小必要访问和可审计性
+
+## 工作原理
+
+将 HIPAA 视为覆盖在更广泛的医疗隐私技能之上的叠加层：
+
+1. 从 `healthcare-phi-compliance` 开始，获取具体的实施规则。
+2. 应用 HIPAA 专用决策门：
+   * 这些数据是否为 PHI？
+   * 该行为者是否为受保实体或业务伙伴？
+   * 供应商或模型提供商在接触数据前是否需要 BAA？
+   * 访问权限是否限制在最小必要范围内？
+   * 读/写/导出事件是否可审计？
+3. 如果任务影响患者安全、临床工作流或受监管的生产架构，则升级至 `healthcare-reviewer`。
+
+## HIPAA 专用防护栏
+
+* 切勿将 PHI 置于日志、分析事件、崩溃报告、提示或客户端可见的错误字符串中。
+* 切勿在 URL、浏览器存储、截图或复制的示例负载中暴露 PHI。
+* 要求对 PHI 的读写操作进行认证访问、范围授权并保留审计追踪。
+* 默认将第三方 SaaS、可观测性、支持工具和 LLM 提供商视为禁止状态，直至明确其 BAA 状态和数据边界。
+* 遵循最小必要访问原则：正确的用户应仅看到完成任务所需的最小 PHI 片段。
+* 优先使用不透明的内部 ID，而非姓名、病历号、电话号码、地址或其他标识符。
+
+## 示例
+
+### 示例 1：以 HIPAA 为框架的产品需求
+
+用户请求：
+
+> 为我们的临床医生仪表板添加 AI 生成的就诊摘要。我们服务美国诊所，需保持 HIPAA 合规。
+
+响应模式：
+
+* 激活 `hipaa-compliance`
+* 使用 `healthcare-phi-compliance` 审查 PHI 流动、日志记录、存储和提示边界
+* 在发送任何 PHI 前，验证摘要生成提供商是否受 BAA 覆盖
+* 如果摘要影响临床决策，则升级至 `healthcare-reviewer`
+
+### 示例 2：供应商/工具决策
+
+用户请求：
+
+> 我们可以将支持对话记录和患者消息发送到分析平台吗？
+
+响应模式：
+
+* 假设这些消息可能包含 PHI
+* 除非分析供应商已获批准处理 HIPAA 约束的工作负载且数据路径已最小化，否则阻止该设计
+* 尽可能要求进行脱敏处理或采用非 PHI 事件模型
+
+## 相关技能
+
+* `healthcare-phi-compliance`
+* `healthcare-reviewer`
+* `healthcare-emr-patterns`
+* `healthcare-eval-harness`
+* `security-review`

package/resources/local/ecc/docs/zh-CN/skills/hookify-rules/SKILL.md

@@ -0,0 +1,139 @@
+---
+name: hookify-rules
+description: 当用户要求创建hookify规则、编写hook规则、配置hookify、添加hookify规则或需要关于hookify规则语法和模式的指导时，应使用此技能。
+---
+
+# 编写 Hookify 规则
+
+## 概述
+
+Hookify 规则是带有 YAML 前置元数据的 Markdown 文件，用于定义要监控的模式以及匹配时显示的消息。规则存储在 `.claude/hookify.{rule-name}.local.md` 文件中。
+
+## 规则文件格式
+
+### 基本结构
+
+```markdown
+---
+name: rule-identifier
+enabled: true
+event: bash|file|stop|prompt|all
+pattern: regex-pattern-here
+---
+
+当此规则触发时向 Claude 显示的消息。
+可包含 Markdown 格式、警告、建议等内容。
+```
+
+### 前置元数据字段
+
+| 字段 | 必填 | 值 | 描述 |
+|-------|----------|--------|-------------|
+| name | 是 | kebab-case 字符串 | 唯一标识符（动词优先：warn-*、block-*、require-*） |
+| enabled | 是 | true/false | 无需删除即可切换 |
+| event | 是 | bash/file/stop/prompt/all | 触发规则的钩子事件 |
+| action | 否 | warn/block | warn（默认）显示消息；block 阻止操作 |
+| pattern | 是* | 正则表达式字符串 | 要匹配的模式（\*或使用 conditions 实现复杂规则） |
+
+### 高级格式（多条件）
+
+```markdown
+---
+name: warn-env-api-keys
+enabled: true
+event: file
+conditions:
+  - field: file_path
+    operator: regex_match
+    pattern: \.env$
+  - field: new_text
+    operator: contains
+    pattern: API_KEY
+---
+
+你正在向 .env 文件中添加 API 密钥。请确保该文件已包含在 .gitignore 中！
+```
+
+**按事件划分的条件字段：**
+
+* bash：`command`
+* file：`file_path`、`new_text`、`old_text`、`content`
+* prompt：`user_prompt`
+
+**运算符：** `regex_match`、`contains`、`equals`、`not_contains`、`starts_with`、`ends_with`
+
+所有条件必须同时满足才能触发规则。
+
+## 事件类型指南
+
+### bash 事件
+
+匹配 Bash 命令模式：
+
+* 危险命令：`rm\s+-rf`、`dd\s+if=`、`mkfs`
+* 权限提升：`sudo\s+`、`su\s+`
+* 权限问题：`chmod\s+777`
+
+### file 事件
+
+匹配编辑/写入/多重编辑操作：
+
+* 调试代码：`console\.log\(`、`debugger`
+* 安全风险：`eval\(`、`innerHTML\s*=`
+* 敏感文件：`\.env$`、`credentials`、`\.pem$`
+
+### stop 事件
+
+完成检查与提醒。模式 `.*` 始终匹配。
+
+### prompt 事件
+
+匹配用户提示内容以强制执行工作流程。
+
+## 模式编写技巧
+
+### 正则表达式基础
+
+* 转义特殊字符：`.` 转义为 `\.`，`(` 转义为 `\(`
+* `\s` 空白字符，`\d` 数字，`\w` 单词字符
+* `+` 一个或多个，`*` 零个或多个，`?` 可选
+* `|` 或运算符
+
+### 常见陷阱
+
+* **过于宽泛**：`log` 会匹配 "login"、"dialog"——请使用 `console\.log\(`
+* **过于具体**：`rm -rf /tmp`——请使用 `rm\s+-rf`
+* **YAML 转义**：使用无引号模式；带引号的字符串需要 `\\s`
+
+### 测试
+
+```bash
+python3 -c "import re; print(re.search(r'your_pattern', 'test text'))"
+```
+
+## 文件组织
+
+* **位置**：项目根目录下的 `.claude/` 目录
+* **命名**：`.claude/hookify.{descriptive-name}.local.md`
+* **Gitignore**：将 `.claude/*.local.md` 添加到 `.gitignore`
+
+## 命令
+
+* `/hookify [description]` - 创建新规则（无参数时自动分析对话）
+* `/hookify-list` - 以表格形式查看所有规则
+* `/hookify-configure` - 交互式切换规则开关
+* `/hookify-help` - 完整文档
+
+## 快速参考
+
+最小可行规则：
+
+```markdown
+---
+name: my-rule
+enabled: true
+event: bash
+pattern: dangerous_command
+---
+此处显示警告信息
+```