hellowind777/hello-arch
skills/hello-arch/SKILL.md
重构代码、调整模块结构、管理依赖、拆分文件、提取组件、设计系统架构或做代码组织决策时使用。
$ install --global
skillsauthnpx skillsauth add hellowind777/helloagents hello-archInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 11, 2026, 2:24 AM4.9s1 file scanned
SKILL.md
- name:
- hello-arch
- description:
- 重构代码、调整模块结构、管理依赖、拆分文件、提取组件、设计系统架构或做代码组织决策时使用。
架构相关变更必须遵循以下规范。
编码前
先画出当前→目标依赖关系和变更路径，再写代码。
SOLID 原则
- 单一职责：一个模块/类只做一件事，变更只有一个原因
- 开闭原则：扩展开放，修改关闭——新功能通过扩展实现
- 依赖倒置：高层不依赖低层，都依赖抽象（接口/协议）
边界与分层
- 清晰的模块边界，通过接口通信
- 依赖方向：外层 → 内层（UI → Service → Repository）
- 循环依赖 = 架构问题，必须解决
- 配置与代码分离，环境变量管理
代码组织
- 按功能分组（feature-based），非按类型分组
- 代码体积控制（同 HelloAGENTS 编码原则）：文件/类预警 300 行、强制拆分 400 行，函数预警 40 行、强制拆分 60 行。例外：生成代码、大型测试夹具、迁移脚本、协议常量表
- 公共逻辑提取到 shared/，但避免过早抽象
- 三次重复才提取——两次相似不够
变更策略
- 评估变更的影响范围（blast radius）
- 大重构分步进行，每步可独立验证和回滚
- 保持向后兼容，除非明确要求破坏性变更
交付检查
- [ ] 无循环依赖
- [ ] 文件/类不超过 400 行，函数不超过 60 行（例外类型除外，非压缩代码）
- [ ] 依赖方向正确（外 → 内）
- [ ] 变更范围可控
- [ ] 技术方案符合 HelloAGENTS 技术选型原则；若当前模式未加载实现要求中的工程质量下限，则至少满足技术选型原则且新项目无过时依赖
Related Skills
hellowind777/hello-subagent
data-ai
VerifiedTrustedCommunity
使用子代理执行任务、并行开发、分派工作时使用。确保子代理有清晰的上下文和验证标准。
600SKILL.mdUpdated May 3, 2026
hellowind777/qa-review
testing
VerifiedTrustedCommunity
统一质量审查、命令验证、阻断修复与交付前质量闭环。
599SKILL.mdUpdated May 22, 2026
hellowind777/~qa
testing
VerifiedTrustedCommunity
统一质量命令 — 审查、命令验证、阻断修复、回归验证与收尾前质量闭环（~qa 命令）
599SKILL.mdUpdated May 22, 2026
hellowind777/helloagents
data-ai
VerifiedTrustedCommunity
按任务类型适用 — 建立质量驱动工作流，通过技能标准、流程纪律和检查清单保障交付质量
599SKILL.mdUpdated May 3, 2026