[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M72XFPJ5SBG328ABJPHZNE5P":3,"skill-same:01M72XFPJ5SBG328ABJPHZNE5P":48},{"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":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M72XFPJ5SBG328ABJPHZNE5P","perl-patterns",null,"现代 Perl 5.36+ 的惯用法、最佳实践和约定，用于构建稳健、可维护的 Perl 应用程序。","SriramGandhiS\u002FSkills","SriramGandhiS","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F211849986?v=4","01M72WQCW12BYX71C6WN584TTA","Sriram S","01M72WQCWTJ2RD0ET1X31AF1RC",1,"MIT","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fdocs\u002Fzh-CN\u002Fskills\u002Fperl-patterns\u002FSKILL.md",[],[],"2026-11-10 22:39:42",false,"---\nname: perl-patterns\ndescription: 现代 Perl 5.36+ 的惯用法、最佳实践和约定，用于构建稳健、可维护的 Perl 应用程序。\norigin: ECC\n---\n\n# 现代 Perl 开发模式\n\n适用于构建健壮、可维护应用程序的 Perl 5.36+ 惯用模式和最佳实践。\n\n## 何时启用\n\n* 编写新的 Perl 代码或模块时\n* 审查 Perl 代码是否符合惯用法时\n* 重构遗留 Perl 代码以符合现代标准时\n* 设计 Perl 模块架构时\n* 将 5.36 之前的代码迁移到现代 Perl 时\n\n## 工作原理\n\n将这些模式作为偏向现代 Perl 5.36+ 默认设置的指南应用：签名、显式模块、聚焦的错误处理和可测试的边界。下面的示例旨在作为起点被复制，然后根据您面前的实际应用程序、依赖栈和部署模型进行调整。\n\n## 核心原则\n\n### 1. 使用 `v5.36` 编译指令\n\n单个 `use v5.36` 即可替代旧的样板代码，并启用严格模式、警告和子程序签名。\n\n```perl\n# Good: Modern preamble\nuse v5.36;\n\nsub greet($name) {\n    say \"Hello, $name!\";\n}\n\n# Bad: Legacy boilerplate\nuse strict;\nuse warnings;\nuse feature 'say', 'signatures';\nno warnings 'experimental::signatures';\n\nsub greet {\n    my ($name) = @_;\n    say \"Hello, $name!\";\n}\n```\n\n### 2. 子程序签名\n\n使用签名以提高清晰度和自动参数数量检查。\n\n```perl\nuse v5.36;\n\n# Good: Signatures with defaults\nsub connect_db($host, $port = 5432, $timeout = 30) {\n    # $host is required, others have defaults\n    return DBI->connect(\"dbi:Pg:host=$host;port=$port\", undef, undef, {\n        RaiseError => 1,\n        PrintError => 0,\n    });\n}\n\n# Good: Slurpy parameter for variable args\nsub log_message($level, @details) {\n    say \"[$level] \" . join(' ', @details);\n}\n\n# Bad: Manual argument unpacking\nsub connect_db {\n    my ($host, $port, $timeout) = @_;\n    $port    \u002F\u002F= 5432;\n    $timeout \u002F\u002F= 30;\n    # ...\n}\n```\n\n### 3. 上下文敏感性\n\n理解标量上下文与列表上下文——这是 Perl 的核心概念。\n\n```perl\nuse v5.36;\n\nmy @items = (1, 2, 3, 4, 5);\n\nmy @copy  = @items;            # List context: all elements\nmy $count = @items;            # Scalar context: count (5)\nsay \"Items: \" . scalar @items; # Force scalar context\n```\n\n### 4. 后缀解引用\n\n对嵌套结构使用后缀解引用语法以提高可读性。\n\n```perl\nuse v5.36;\n\nmy $data = {\n    users => [\n        { name => 'Alice', roles => ['admin', 'user'] },\n        { name => 'Bob',   roles => ['user'] },\n    ],\n};\n\n# Good: Postfix dereferencing\nmy @users = $data->{users}->@*;\nmy @roles = $data->{users}[0]{roles}->@*;\nmy %first = $data->{users}[0]->%*;\n\n# Bad: Circumfix dereferencing (harder to read in chains)\nmy @users = @{ $data->{users} };\nmy @roles = @{ $data->{users}[0]{roles} };\n```\n\n### 5. `isa` 运算符 (5.32+)\n\n中缀类型检查——替代 `blessed($o) && $o->isa('X')`。\n\n```perl\nuse v5.36;\nif ($obj isa 'My::Class') { $obj->do_something }\n```\n\n## 错误处理\n\n### eval\u002Fdie 模式\n\n```perl\nuse v5.36;\n\nsub parse_config($path) {\n    my $content = eval { path($path)->slurp_utf8 };\n    die \"Config error: $@\" if $@;\n    return decode_json($content);\n}\n```\n\n### Try::Tiny（可靠的异常处理）\n\n```perl\nuse v5.36;\nuse Try::Tiny;\n\nsub fetch_user($id) {\n    my $user = try {\n        $db->resultset('User')->find($id)\n            \u002F\u002F die \"User $id not found\\n\";\n    }\n    catch {\n        warn \"Failed to fetch user $id: $_\";\n        undef;\n    };\n    return $user;\n}\n```\n\n### 原生 try\u002Fcatch (5.40+)\n\n```perl\nuse v5.40;\n\nsub divide($x, $y) {\n    try {\n        die \"Division by zero\" if $y == 0;\n        return $x \u002F $y;\n    }\n    catch ($e) {\n        warn \"Error: $e\";\n        return;\n    }\n}\n```\n\n## 使用 Moo 的现代 OO\n\n优先使用 Moo 进行轻量级、现代的面向对象编程。仅当需要 Moose 的元协议时才使用它。\n\n```perl\n# Good: Moo class\npackage User;\nuse Moo;\nuse Types::Standard qw(Str Int ArrayRef);\nuse namespace::autoclean;\n\nhas name  => (is => 'ro', isa => Str, required => 1);\nhas email => (is => 'ro', isa => Str, required => 1);\nhas age   => (is => 'ro', isa => Int, default  => sub { 0 });\nhas roles => (is => 'ro', isa => ArrayRef[Str], default => sub { [] });\n\nsub is_admin($self) {\n    return grep { $_ eq 'admin' } $self->roles->@*;\n}\n\nsub greet($self) {\n    return \"Hello, I'm \" . $self->name;\n}\n\n1;\n\n# Usage\nmy $user = User->new(\n    name  => 'Alice',\n    email => 'alice@example.com',\n    roles => ['admin', 'user'],\n);\n\n# Bad: Blessed hashref (no validation, no accessors)\npackage User;\nsub new {\n    my ($class, %args) = @_;\n    return bless \\%args, $class;\n}\nsub name { return $_[0]->{name} }\n1;\n```\n\n### Moo 角色\n\n```perl\npackage Role::Serializable;\nuse Moo::Role;\nuse JSON::MaybeXS qw(encode_json);\nrequires 'TO_HASH';\nsub to_json($self) { encode_json($self->TO_HASH) }\n1;\n\npackage User;\nuse Moo;\nwith 'Role::Serializable';\nhas name  => (is => 'ro', required => 1);\nhas email => (is => 'ro', required => 1);\nsub TO_HASH($self) { { name => $self->name, email => $self->email } }\n1;\n```\n\n### 原生 `class` 关键字 (5.38+, Corinna)\n\n```perl\nuse v5.38;\nuse feature 'class';\nno warnings 'experimental::class';\n\nclass Point {\n    field $x :param;\n    field $y :param;\n    method magnitude() { sqrt($x**2 + $y**2) }\n}\n\nmy $p = Point->new(x => 3, y => 4);\nsay $p->magnitude;  # 5\n```\n\n## 正则表达式\n\n### 命名捕获和 `\u002Fx` 标志\n\n```perl\nuse v5.36;\n\n# Good: Named captures with \u002Fx for readability\nmy $log_re = qr{\n    ^ (?\u003Ctimestamp> \\d{4}-\\d{2}-\\d{2} \\s \\d{2}:\\d{2}:\\d{2} )\n    \\s+ \\[ (?\u003Clevel> \\w+ ) \\]\n    \\s+ (?\u003Cmessage> .+ ) $\n}x;\n\nif ($line =~ $log_re) {\n    say \"Time: $+{timestamp}, Level: $+{level}\";\n    say \"Message: $+{message}\";\n}\n\n# Bad: Positional captures (hard to maintain)\nif ($line =~ \u002F^(\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2})\\s+\\[(\\w+)\\]\\s+(.+)$\u002F) {\n    say \"Time: $1, Level: $2\";\n}\n```\n\n### 预编译模式\n\n```perl\nuse v5.36;\n\n# Good: Compile once, use many\nmy $email_re = qr\u002F^[A-Za-z0-9._%+-]+\\@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}$\u002F;\n\nsub validate_emails(@emails) {\n    return grep { $_ =~ $email_re } @emails;\n}\n```\n\n## 数据结构\n\n### 引用和安全深度访问\n\n```perl\nuse v5.36;\n\n# Hash and array references\nmy $config = {\n    database => {\n        host => 'localhost',\n        port => 5432,\n        options => ['utf8', 'sslmode=require'],\n    },\n};\n\n# Safe deep access (returns undef if any level missing)\nmy $port = $config->{database}{port};           # 5432\nmy $missing = $config->{cache}{host};           # undef, no error\n\n# Hash slices\nmy %subset;\n@subset{qw(host port)} = @{$config->{database}}{qw(host port)};\n\n# Array slices\nmy @first_two = $config->{database}{options}->@[0, 1];\n\n# Multi-variable for loop (experimental in 5.36, stable in 5.40)\nuse feature 'for_list';\nno warnings 'experimental::for_list';\nfor my ($key, $val) (%$config) {\n    say \"$key => $val\";\n}\n```\n\n## 文件 I\u002FO\n\n### 三参数 open\n\n```perl\nuse v5.36;\n\n# Good: Three-arg open with autodie (core module, eliminates 'or die')\nuse autodie;\n\nsub read_file($path) {\n    open my $fh, '\u003C:encoding(UTF-8)', $path;\n    local $\u002F;\n    my $content = \u003C$fh>;\n    close $fh;\n    return $content;\n}\n\n# Bad: Two-arg open (shell injection risk, see perl-security)\nopen FH, $path;            # NEVER do this\nopen FH, \"\u003C $path\";        # Still bad — user data in mode string\n```\n\n### 使用 Path::Tiny 进行文件操作\n\n```perl\nuse v5.36;\nuse Path::Tiny;\n\nmy $file = path('config', 'app.json');\nmy $content = $file->slurp_utf8;\n$file->spew_utf8($new_content);\n\n# Iterate directory\nfor my $child (path('src')->children(qr\u002F\\.pl$\u002F)) {\n    say $child->basename;\n}\n```\n\n## 模块组织\n\n### 标准项目布局\n\n```text\nMyApp\u002F\n├── lib\u002F\n│   └── MyApp\u002F\n│       ├── App.pm           # 主模块\n│       ├── Config.pm        # 配置\n│       ├── DB.pm            # 数据库层\n│       └── Util.pm          # 工具集\n├── bin\u002F\n│   └── myapp                # 入口脚本\n├── t\u002F\n│   ├── 00-load.t            # 编译测试\n│   ├── unit\u002F                # 单元测试\n│   └── integration\u002F         # 集成测试\n├── cpanfile                 # 依赖项\n├── Makefile.PL              # 构建系统\n└── .perlcriticrc            # 代码检查配置\n```\n\n### 导出器模式\n\n```perl\npackage MyApp::Util;\nuse v5.36;\nuse Exporter 'import';\n\nour @EXPORT_OK   = qw(trim);\nour %EXPORT_TAGS = (all => \\@EXPORT_OK);\n\nsub trim($str) { $str =~ s\u002F^\\s+|\\s+$\u002F\u002Fgr }\n\n1;\n```\n\n## 工具\n\n### perltidy 配置 (.perltidyrc)\n\n```text\n-i=4        # 4 空格缩进\n-l=100      # 100 字符行宽\n-ci=4       # 续行缩进\n-ce         # else 与右花括号同行\n-bar        # 左花括号与语句同行\n-nolq       # 不对长引用字符串进行反向缩进\n```\n\n### perlcritic 配置 (.perlcriticrc)\n\n```ini\nseverity = 3\ntheme = core + pbp + security\n\n[InputOutput::RequireCheckedSyscalls]\nfunctions = :builtins\nexclude_functions = say print\n\n[Subroutines::ProhibitExplicitReturnUndef]\nseverity = 4\n\n[ValuesAndExpressions::ProhibitMagicNumbers]\nallowed_values = 0 1 2 -1\n```\n\n### 依赖管理 (cpanfile + carton)\n\n```bash\ncpanm App::cpanminus Carton   # Install tools\ncarton install                 # Install deps from cpanfile\ncarton exec -- perl bin\u002Fmyapp  # Run with local deps\n```\n\n```perl\n# cpanfile\nrequires 'Moo', '>= 2.005';\nrequires 'Path::Tiny';\nrequires 'JSON::MaybeXS';\nrequires 'Try::Tiny';\n\non test => sub {\n    requires 'Test2::V0';\n    requires 'Test::MockModule';\n};\n```\n\n## 快速参考：现代 Perl 惯用法\n\n| 遗留模式 | 现代替代方案 |\n|---|---|\n| `use strict; use warnings;` | `use v5.36;` |\n| `my ($x, $y) = @_;` | `sub foo($x, $y) { ... }` |\n| `@{ $ref }` | `$ref->@*` |\n| `%{ $ref }` | `$ref->%*` |\n| `open FH, \"\u003C $file\"` | `open my $fh, '\u003C:encoding(UTF-8)', $file` |\n| `blessed hashref` | `Moo` 带类型的类 |\n| `$1, $2, $3` | `$+{name}` (命名捕获) |\n| `eval { }; if ($@)` | `Try::Tiny` 或原生 `try\u002Fcatch` (5.40+) |\n| `BEGIN { require Exporter; }` | `use Exporter 'import';` |\n| 手动文件操作 | `Path::Tiny` |\n| `blessed($o) && $o->isa('X')` | `$o isa 'X'` (5.32+) |\n| `builtin::true \u002F false` | `use builtin 'true', 'false';` (5.36+, 实验性) |\n\n## 反模式\n\n```perl\n# 1. Two-arg open (security risk)\nopen FH, $filename;                     # NEVER\n\n# 2. Indirect object syntax (ambiguous parsing)\nmy $obj = new Foo(bar => 1);            # Bad\nmy $obj = Foo->new(bar => 1);           # Good\n\n# 3. Excessive reliance on $_\nmap { process($_) } grep { validate($_) } @items;  # Hard to follow\nmy @valid = grep { validate($_) } @items;           # Better: break it up\nmy @results = map { process($_) } @valid;\n\n# 4. Disabling strict refs\nno strict 'refs';                        # Almost always wrong\n${\"My::Package::$var\"} = $value;         # Use a hash instead\n\n# 5. Global variables as configuration\nour $TIMEOUT = 30;                       # Bad: mutable global\nuse constant TIMEOUT => 30;              # Better: constant\n# Best: Moo attribute with default\n\n# 6. String eval for module loading\neval \"require $module\";                  # Bad: code injection risk\neval \"use $module\";                      # Bad\nuse Module::Runtime 'require_module';    # Good: safe module loading\nrequire_module($module);\n```\n\n**记住**：现代 Perl 是简洁、可读且安全的。让 `use v5.36` 处理样板代码，使用 Moo 处理对象，并优先使用 CPAN 上经过实战检验的模块，而不是自己动手的解决方案。\n","# 现代 Perl 开发模式\n\n适用于构建健壮、可维护应用程序的 Perl 5.36+ 惯用模式和最佳实践。\n\n## 何时启用\n\n* 编写新的 Perl 代码或模块时\n* 审查 Perl 代码是否符合惯用法时\n* 重构遗留 Perl 代码以符合现代标准时\n* 设计 Perl 模块架构时\n* 将 5.36 之前的代码迁移到现代 Perl 时\n\n## 工作原理\n\n将这些模式作为偏向现代 Perl 5.36+ 默认设置的指南应用：签名、显式模块、聚焦的错误处理和可测试的边界。下面的示例旨在作为起点被复制，然后根据您面前的实际应用程序、依赖栈和部署模型进行调整。\n\n## 核心原则\n\n### 1. 使用 `v5.36` 编译指令\n\n单个 `use v5.36` 即可替代旧的样板代码，并启用严格模式、警告和子程序签名。\n\n```perl\n# Good: Modern preamble\nuse v5.36;\n\nsub greet($name) {\n    say \"Hello, $name!\";\n}\n\n# Bad: Legacy boilerplate\nuse strict;\nuse warnings;\nuse feature 'say', 'signatures';\nno warnings 'experimental::signatures';\n\nsub greet {\n    my ($name) = @_;\n    say \"Hello, $name!\";\n}\n```\n\n### 2. 子程序签名\n\n使用签名以提高清晰度和自动参数数量检查。\n\n```perl\nuse v5.36;\n\n# Good: Signatures with defaults\nsub connect_db($host, $port = 5432, $timeout = 30) {\n    # $host is required, others have defaults\n    return DBI->connect(\"dbi:Pg:host=$host;port=$port\", undef, undef, {\n        RaiseError => 1,\n        PrintError => 0,\n    });\n}\n\n# Good: Slurpy parameter for variable args\nsub log_message($level, @details) {\n    say \"[$level] \" . join(' ', @details);\n}\n\n# Bad: Manual argument unpacking\nsub connect_db {\n    my ($host, $port, $timeout) = @_;\n    $port    \u002F\u002F= 5432;\n    $timeout \u002F\u002F= 30;\n    # ...\n}\n```\n\n### 3. 上下文敏感性\n\n理解标量上下文与列表上下文——这是 Perl 的核心概念。\n\n```perl\nuse v5.36;\n\nmy @items = (1, 2, 3, 4, 5);\n\nmy @copy  = @items;            # List context: all elements\nmy $count = @items;            # Scalar context: count (5)\nsay \"Items: \" . scalar @items; # Force scalar context\n```\n\n### 4. 后缀解引用\n\n对嵌套结构使用后缀解引用语法以提高可读性。\n\n```perl\nuse v5.36;\n\nmy $data = {\n    users => [\n        { name => 'Alice', roles => ['admin', 'user'] },\n        { name => 'Bob',   roles => ['user'] },\n    ],\n};\n\n# Good: Postfix dereferencing\nmy @users = $data->{users}->@*;\nmy @roles = $data->{users}[0]{roles}->@*;\nmy %first = $data->{users}[0]->%*;\n\n# Bad: Circumfix dereferencing (harder to read in chains)\nmy @users = @{ $data->{users} };\nmy @roles = @{ $data->{users}[0]{roles} };\n```\n\n### 5. `isa` 运算符 (5.32+)\n\n中缀类型检查——替代 `blessed($o) && $o->isa('X')`。\n\n```perl\nuse v5.36;\nif ($obj isa 'My::Class') { $obj->do_something }\n```\n\n## 错误处理\n\n### eval\u002Fdie 模式\n\n```perl\nuse v5.36;\n\nsub parse_config($path) {\n    my $content = eval { path($path)->slurp_utf8 };\n    die \"Config error: $@\" if $@;\n    return decode_json($content);\n}\n```\n\n### Try::Tiny（可靠的异常处理）\n\n```perl\nuse v5.36;\nuse Try::Tiny;\n\nsub fetch_user($id) {\n    my $user = try {\n        $db->resultset('User')->find($id)\n            \u002F\u002F die \"User $id not found\\n\";\n    }\n    catch {\n        warn \"Failed to fetch user $id: $_\";\n        undef;\n    };\n    return $user;\n}\n```\n\n### 原生 try\u002Fcatch (5.40+)\n\n```perl\nuse v5.40;\n\nsub divide($x, $y) {\n    try {\n        die \"Division by zero\" if $y == 0;\n        return $x \u002F $y;\n    }\n    catch ($e) {\n        warn \"Error: $e\";\n        return;\n    }\n}\n```\n\n## 使用 Moo 的现代 OO\n\n优先使用 Moo 进行轻量级、现代的面向对象编程。仅当需要 Moose 的元协议时才使用它。\n\n```perl\n# Good: Moo class\npackage User;\nuse Moo;\nuse Types::Standard qw(Str Int ArrayRef);\nuse namespace::autoclean;\n\nhas name  => (is => 'ro', isa => Str, required => 1);\nhas email => (is => 'ro', isa => Str, required => 1);\nhas age   => (is => 'ro', isa => Int, default  => sub { 0 });\nhas roles => (is => 'ro', isa => ArrayRef[Str], default => sub { [] });\n\nsub is_admin($self) {\n    return grep { $_ eq 'admin' } $self->roles->@*;\n}\n\nsub greet($self) {\n    return \"Hello, I'm \" . $self->name;\n}\n\n1;\n\n# Usage\nmy $user = User->new(\n    name  => 'Alice',\n    email => 'alice@example.com',\n    roles => ['admin', 'user'],\n);\n\n# Bad: Blessed hashref (no validation, no accessors)\npackage User;\nsub new {\n    my ($class, %args) = @_;\n    return bless \\%args, $class;\n}\nsub name { return $_[0]->{name} }\n1;\n```\n\n### Moo 角色\n\n```perl\npackage Role::Serializable;\nuse Moo::Role;\nuse JSON::MaybeXS qw(encode_json);\nrequires 'TO_HASH';\nsub to_json($self) { encode_json($self->TO_HASH) }\n1;\n\npackage User;\nuse Moo;\nwith 'Role::Serializable';\nhas name  => (is => 'ro', required => 1);\nhas email => (is => 'ro', required => 1);\nsub TO_HASH($self) { { name => $self->name, email => $self->email } }\n1;\n```\n\n### 原生 `class` 关键字 (5.38+, Corinna)\n\n```perl\nuse v5.38;\nuse feature 'class';\nno warnings 'experimental::class';\n\nclass Point {\n    field $x :param;\n    field $y :param;\n    method magnitude() { sqrt($x**2 + $y**2) }\n}\n\nmy $p = Point->new(x => 3, y => 4);\nsay $p->magnitude;  # 5\n```\n\n## 正则表达式\n\n### 命名捕获和 `\u002Fx` 标志\n\n```perl\nuse v5.36;\n\n# Good: Named captures with \u002Fx for readability\nmy $log_re = qr{\n    ^ (?\u003Ctimestamp> \\d{4}-\\d{2}-\\d{2} \\s \\d{2}:\\d{2}:\\d{2} )\n    \\s+ \\[ (?\u003Clevel> \\w+ ) \\]\n    \\s+ (?\u003Cmessage> .+ ) $\n}x;\n\nif ($line =~ $log_re) {\n    say \"Time: $+{timestamp}, Level: $+{level}\";\n    say \"Message: $+{message}\";\n}\n\n# Bad: Positional captures (hard to maintain)\nif ($line =~ \u002F^(\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2})\\s+\\[(\\w+)\\]\\s+(.+)$\u002F) {\n    say \"Time: $1, Level: $2\";\n}\n```\n\n### 预编译模式\n\n```perl\nuse v5.36;\n\n# Good: Compile once, use many\nmy $email_re = qr\u002F^[A-Za-z0-9._%+-]+\\@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}$\u002F;\n\nsub validate_emails(@emails) {\n    return grep { $_ =~ $email_re } @emails;\n}\n```\n\n## 数据结构\n\n### 引用和安全深度访问\n\n```perl\nuse v5.36;\n\n# Hash and array references\nmy $config = {\n    database => {\n        host => 'localhost',\n        port => 5432,\n        options => ['utf8', 'sslmode=require'],\n    },\n};\n\n# Safe deep access (returns undef if any level missing)\nmy $port = $config->{database}{port};           # 5432\nmy $missing = $config->{cache}{host};           # undef, no error\n\n# Hash slices\nmy %subset;\n@subset{qw(host port)} = @{$config->{database}}{qw(host port)};\n\n# Array slices\nmy @first_two = $config->{database}{options}->@[0, 1];\n\n# Multi-variable for loop (experimental in 5.36, stable in 5.40)\nuse feature 'for_list';\nno warnings 'experimental::for_list';\nfor my ($key, $val) (%$config) {\n    say \"$key => $val\";\n}\n```\n\n## 文件 I\u002FO\n\n### 三参数 open\n\n```perl\nuse v5.36;\n\n# Good: Three-arg open with autodie (core module, eliminates 'or die')\nuse autodie;\n\nsub read_file($path) {\n    open my $fh, '\u003C:encoding(UTF-8)', $path;\n    local $\u002F;\n    my $content = \u003C$fh>;\n    close $fh;\n    return $content;\n}\n\n# Bad: Two-arg open (shell injection risk, see perl-security)\nopen FH, $path;            # NEVER do this\nopen FH, \"\u003C $path\";        # Still bad — user data in mode string\n```\n\n### 使用 Path::Tiny 进行文件操作\n\n```perl\nuse v5.36;\nuse Path::Tiny;\n\nmy $file = path('config', 'app.json');\nmy $content = $file->slurp_utf8;\n$file->spew_utf8($new_content);\n\n# Iterate directory\nfor my $child (path('src')->children(qr\u002F\\.pl$\u002F)) {\n    say $child->basename;\n}\n```\n\n## 模块组织\n\n### 标准项目布局\n\n```text\nMyApp\u002F\n├── lib\u002F\n│   └── MyApp\u002F\n│       ├── App.pm           # 主模块\n│       ├── Config.pm        # 配置\n│       ├── DB.pm            # 数据库层\n│       └── Util.pm          # 工具集\n├── bin\u002F\n│   └── myapp                # 入口脚本\n├── t\u002F\n│   ├── 00-load.t            # 编译测试\n│   ├── unit\u002F                # 单元测试\n│   └── integration\u002F         # 集成测试\n├── cpanfile                 # 依赖项\n├── Makefile.PL              # 构建系统\n└── .perlcriticrc            # 代码检查配置\n```\n\n### 导出器模式\n\n```perl\npackage MyApp::Util;\nuse v5.36;\nuse Exporter 'import';\n\nour @EXPORT_OK   = qw(trim);\nour %EXPORT_TAGS = (all => \\@EXPORT_OK);\n\nsub trim($str) { $str =~ s\u002F^\\s+|\\s+$\u002F\u002Fgr }\n\n1;\n```\n\n## 工具\n\n### perltidy 配置 (.perltidyrc)\n\n```text\n-i=4        # 4 空格缩进\n-l=100      # 100 字符行宽\n-ci=4       # 续行缩进\n-ce         # else 与右花括号同行\n-bar        # 左花括号与语句同行\n-nolq       # 不对长引用字符串进行反向缩进\n```\n\n### perlcritic 配置 (.perlcriticrc)\n\n```ini\nseverity = 3\ntheme = core + pbp + security\n\n[InputOutput::RequireCheckedSyscalls]\nfunctions = :builtins\nexclude_functions = say print\n\n[Subroutines::ProhibitExplicitReturnUndef]\nseverity = 4\n\n[ValuesAndExpressions::ProhibitMagicNumbers]\nallowed_values = 0 1 2 -1\n```\n\n### 依赖管理 (cpanfile + carton)\n\n```bash\ncpanm App::cpanminus Carton   # Install tools\ncarton install                 # Install deps from cpanfile\ncarton exec -- perl bin\u002Fmyapp  # Run with local deps\n```\n\n```perl\n# cpanfile\nrequires 'Moo', '>= 2.005';\nrequires 'Path::Tiny';\nrequires 'JSON::MaybeXS';\nrequires 'Try::Tiny';\n\non test => sub {\n    requires 'Test2::V0';\n    requires 'Test::MockModule';\n};\n```\n\n## 快速参考：现代 Perl 惯用法\n\n| 遗留模式 | 现代替代方案 |\n|---|---|\n| `use strict; use warnings;` | `use v5.36;` |\n| `my ($x, $y) = @_;` | `sub foo($x, $y) { ... }` |\n| `@{ $ref }` | `$ref->@*` |\n| `%{ $ref }` | `$ref->%*` |\n| `open FH, \"\u003C $file\"` | `open my $fh, '\u003C:encoding(UTF-8)', $file` |\n| `blessed hashref` | `Moo` 带类型的类 |\n| `$1, $2, $3` | `$+{name}` (命名捕获) |\n| `eval { }; if ($@)` | `Try::Tiny` 或原生 `try\u002Fcatch` (5.40+) |\n| `BEGIN { require Exporter; }` | `use Exporter 'import';` |\n| 手动文件操作 | `Path::Tiny` |\n| `blessed($o) && $o->isa('X')` | `$o isa 'X'` (5.32+) |\n| `builtin::true \u002F false` | `use builtin 'true', 'false';` (5.36+, 实验性) |\n\n## 反模式\n\n```perl\n# 1. Two-arg open (security risk)\nopen FH, $filename;                     # NEVER\n\n# 2. Indirect object syntax (ambiguous parsing)\nmy $obj = new Foo(bar => 1);            # Bad\nmy $obj = Foo->new(bar => 1);           # Good\n\n# 3. Excessive reliance on $_\nmap { process($_) } grep { validate($_) } @items;  # Hard to follow\nmy @valid = grep { validate($_) } @items;           # Better: break it up\nmy @results = map { process($_) } @valid;\n\n# 4. Disabling strict refs\nno strict 'refs';                        # Almost always wrong\n${\"My::Package::$var\"} = $value;         # Use a hash instead\n\n# 5. Global variables as configuration\nour $TIMEOUT = 30;                       # Bad: mutable global\nuse constant TIMEOUT => 30;              # Better: constant\n# Best: Moo attribute with default\n\n# 6. String eval for module loading\neval \"require $module\";                  # Bad: code injection risk\neval \"use $module\";                      # Bad\nuse Module::Runtime 'require_module';    # Good: safe module loading\nrequire_module($module);\n```\n\n**记住**：现代 Perl 是简洁、可读且安全的。让 `use v5.36` 处理样板代码，使用 Moo 处理对象，并优先使用 CPAN 上经过实战检验的模块，而不是自己动手的解决方案。\n",{"name":5,"origin":24,"description":7},"ECC","master","d6ca01da0f24a3b0e26e4a8b7b66cbd25d429f5d","docs\u002Fzh-CN\u002Fskills\u002Fperl-patterns",0,"https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills","https:\u002F\u002Fgithub.com\u002FSriramGandhiS","https:\u002F\u002Fsriram.website\u002F","Curious guy who keeps tinkering until something works","2026-05-20 16:21:34",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add SriramGandhiS\u002FSkills --skill perl-patterns",{"tool":40,"command":41},"bunx","bunx skills add SriramGandhiS\u002FSkills --skill perl-patterns",{"tool":43,"command":44},"pnpm","pnpm dlx skills add SriramGandhiS\u002FSkills --skill perl-patterns","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fdocs\u002Fzh-CN\u002Fskills\u002Fperl-patterns\u002FSKILL.md",true,[],[49,57,62,68,75,82],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":56},"01M732609EPJWV13PVTX3GT4TM","webgpu-threejs-tsl","Comprehensive guide for developing WebGPU-enabled Three.js applications using TSL (Three.js Shading Language). Covers WebGPU renderer setup, TSL syntax and node materials, compute shaders, post-processing effects, and WGSL integration. Use this skill when working with Three.js WebGPU, TSL shaders, node materials, or GPU compute in Three.js.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fwebgpu-threejs-tsl\u002Fskills\u002Fwebgpu-threejs-tsl\u002FSKILL.md",[],[],"2026-11-11 15:11:14",{"skillNo":58,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":56},"01M7325XM47AGWB6K6C4VXKE6B","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fwebgpu-threejs-tsl\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":56},"01M7325WP6DES69JKC840VMFEP","verification-loop","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Fverification-loop\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":56},"01M7325TFQF1DZTQ6J3WGQQ1VR","tdd-workflow","Use this skill when writing new features, fixing bugs, or refactoring code. Enforces test-driven development with 80%+ coverage including unit, integration, and E2E tests.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Ftdd-workflow\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":56},"01M7325RGV9AY9PK92D2V8KKPW","strategic-compact","Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Fstrategic-compact\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":56},"01M7325MZC28SE86E7NMCNEFS4","security-review","Use this skill when adding authentication, handling user input, working with secrets, creating API endpoints, or implementing payment\u002Fsensitive features. Provides comprehensive security checklist and patterns.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Fsecurity-review\u002FSKILL.md",[],[]]