[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AM5RPG42NH2W4EJZGKP9QJ":3,"skill-same:01M7AM5RPG42NH2W4EJZGKP9QJ":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},"01M7AM5RPG42NH2W4EJZGKP9QJ","perl-patterns",null,"现代 Perl 5.36+ 的惯用法、最佳实践和约定，用于构建稳健、可维护的 Perl 应用程序。","Cyrilthetecchieee\u002Fcyril-code-","Cyrilthetecchieee","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F219787998?v=4","01M7AF0MMMKRAA0H61XMJPV92H","Julian Cyril D ","01M7AF0MQ10AVG6QJQ1C2BC0F5",2,"MIT","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Fzh-CN\u002Fskills\u002Fperl-patterns\u002FSKILL.md",[],[],"2026-11-15 14:19:17",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","main","57e7aa6b6e03bce1a7d7862ba9c2ec312f7f19b5","src\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Fzh-CN\u002Fskills\u002Fperl-patterns",0,"https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee","https:\u002F\u002Fwithcyril.me\u002F","Hi, I’m Julian Cyril D, a Computer Science and Business Systems student at PSNACET.\r\nI’m passionate about full-stack development, UI\u002FUX design, and building sma","2026-11-04 23:28:50",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add Cyrilthetecchieee\u002Fcyril-code- --skill perl-patterns",{"tool":40,"command":41},"bunx","bunx skills add Cyrilthetecchieee\u002Fcyril-code- --skill perl-patterns",{"tool":43,"command":44},"pnpm","pnpm dlx skills add Cyrilthetecchieee\u002Fcyril-code- --skill perl-patterns","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Fzh-CN\u002Fskills\u002Fperl-patterns\u002FSKILL.md",true,[],[49,58,65,73,80,87],{"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":53,"licenseFileUrl":54,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":19},"01M7AQV6CYX8RMC78420V9WZ62","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fwebapp-testing\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M7AQV2895N3S1MEX6K76G6G2","youtube-downloader","Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fvideo-downloader\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":53,"licenseFileUrl":69,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M7AQTRNX62DNKVZ5GXEHRBKB","theme-factory","Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors\u002Ffonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftheme-factory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftheme-factory\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7AQTNNVHAAN9H6DA8T6ZVE0","template-skill","Replace with description of the skill and when Claude should use it.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftemplate-skill\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7AQTJ3MQ6AKX152MEX2MYCC","tailored-resume-generator","Analyzes job descriptions and generates tailored resumes that highlight relevant experience, skills, and achievements to maximize interview chances","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftailored-resume-generator\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":53,"licenseFileUrl":91,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M7AQTD7D5MYET2YWG7HG9WM3","slack-gif-creator","Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives. This skill applies when users request animated GIFs or emoji animations for Slack from descriptions like \"make me a GIF for Slack of X doing Y\".","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fslack-gif-creator\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fslack-gif-creator\u002FSKILL.md",[],[]]