@mison/ag-kit-cn 2.0.1

package/.agent/skills/architecture/examples.md

@@ -0,0 +1,94 @@
+# 架构示例
+
+> 按项目类型给出现实世界的架构决策示例。
+
+---
+
+## 示例 1：MVP（最小可行产品）电商（单人开发）
+
+```yaml
+需求:
+  - 初期 <1000 用户
+  - 单人开发
+  - 快速上线（8 周）
+  - 预算敏感
+
+架构决策:
+  应用结构: Monolith（单体，更适合单人）
+  框架: Next.js（全栈、开发快）
+  数据层: Prisma 直连（避免过度抽象）
+  认证: JWT（JSON Web Token，比 OAuth（授权协议）更轻量）
+  支付: Stripe（托管支付方案）
+  数据库: PostgreSQL（订单场景需要 ACID）
+
+接受的权衡:
+  - Monolith → 无法独立扩缩（团队规模暂不支持）
+  - 不使用 Repository（仓储模式） → 可测性较弱（简单 CRUD 阶段可接受）
+  - JWT → 初期无社交登录（后续可补）
+
+后续迁移路径:
+  - 用户 > 10K → 拆分支付服务
+  - 团队 > 3 → 引入 Repository pattern（仓储模式）
+  - 需要社交登录 → 增加 OAuth（授权协议）
+```
+
+---
+
+## 示例 2：SaaS（软件即服务）产品（5-10 人团队）
+
+```yaml
+需求:
+  - 1K-100K 用户
+  - 5-10 名开发者
+  - 长期（12 个月以上）
+  - 多业务域（计费、用户、核心）
+
+架构决策:
+  应用结构: Modular Monolith（模块化单体，适合团队规模）
+  框架: NestJS（天然模块化）
+  数据层: Repository pattern（仓储模式，利于测试与替换）
+  领域模型: Partial DDD（部分领域驱动）
+  认证: OAuth（授权协议） + JWT（JSON Web Token）
+  缓存: Redis
+  数据库: PostgreSQL
+
+接受的权衡:
+  - Modular Monolith → 模块间仍有耦合（微服务时机未到）
+  - Partial DDD → 不做完整聚合（缺少强领域专家）
+  - RabbitMQ（消息队列）后置 → 初期先同步调用（需求验证后再引入）
+
+迁移路径:
+  - 团队 > 10 → 考虑微服务
+  - 域冲突加剧 → 拆分有界上下文
+  - 读性能问题 → 引入 CQRS（命令查询职责分离）
+```
+
+---
+
+## 示例 3：企业级（100K+ 用户）
+
+```yaml
+需求:
+  - 100K+ 用户
+  - 10+ 开发者
+  - 多业务域
+  - 不同扩缩需求
+  - 7×24 可用性
+
+架构决策:
+  应用结构: Microservices（微服务，独立扩缩）
+  API 网关: Kong/AWS API GW（网关）
+  领域模型: Full DDD（完整领域驱动）
+  一致性: Event-driven（事件驱动，接受最终一致性）
+  消息总线: Kafka
+  认证: OAuth（授权协议） + SAML（企业 SSO）
+  数据库: Polyglot（按场景选数据库）
+  CQRS（命令查询职责分离）: 选定服务
+
+运行要求:
+  - Service mesh（Istio/Linkerd）
+  - Distributed tracing（分布式追踪，Jaeger/Tempo）
+  - Centralized logging（集中日志，ELK/Loki）
+  - Circuit breakers（熔断器，Resilience4j）
+  - Kubernetes/Helm
+```

package/.agent/skills/architecture/pattern-selection.md

@@ -0,0 +1,68 @@
+# 模式选择指南
+
+> 选择架构模式的决策树。
+
+## 主决策树
+
+```
+开始：你的主要关注点是什么？
+
+┌─ 数据访问复杂度？
+│  ├─ 高（复杂查询，需要测试）
+│  │  → Repository Pattern（仓储模式）+ Unit of Work（工作单元）
+│  │  验证：数据源会频繁变化吗？
+│  │     ├─ 是 → Repository（仓储模式）值得增加间接层
+│  │     └─ 否 → 考虑更简单的 ORM（对象关系映射）直连访问
+│  └─ 低（简单 CRUD（增删改查），单一数据库）
+│     → ORM（对象关系映射）直连（Prisma, Drizzle）
+│     越简单 = 越好、越快
+│
+├─ 业务规则复杂度？
+│  ├─ 高（领域逻辑复杂，规则随上下文变化）
+│  │  → Domain-Driven Design（领域驱动设计，DDD）
+│  │  验证：团队里有领域专家吗？
+│  │     ├─ 是 → Full DDD（聚合、值对象）
+│  │     └─ 否 → Partial DDD（富实体、清晰边界）
+│  └─ 低（主要是 CRUD，简单校验）
+│     → Transaction Script（事务脚本）模式
+│     越简单 = 越好、越快
+│
+├─ 需要独立扩缩吗？
+│  ├─ 是（不同组件扩缩方式不同）
+│  │  → Microservices（微服务）值得承担复杂性
+│  │  要求（必须全部满足）：
+│  │    - 清晰的领域边界
+│  │    - 团队 > 10 名开发者
+│  │    - 各服务有不同的扩缩需求
+│  │  未全部满足 → Modular Monolith（模块化单体）
+│  └─ 否（整体一起扩缩）
+│     → Modular Monolith（模块化单体）
+│     以后在确有必要时再拆服务
+│
+└─ 实时性需求？
+   ├─ 高（即时更新，多用户同步）
+   │  → Event-Driven Architecture（事件驱动架构）
+   │  → Message Queue（消息队列）（RabbitMQ, Redis, Kafka）
+   │  验证：你能处理最终一致性（eventual consistency）吗？
+   │     ├─ 是 → 事件驱动可行
+   │     └─ 否 → 同步 + 轮询
+   └─ 低（可接受最终一致性）
+      → 同步（REST/GraphQL）
+      越简单 = 越好、越快
+```
+
+## 三个问题（选择任何模式前）
+
+1. **问题是否被解决**：该模式解决的具体问题是什么？
+2. **更简单的替代方案**：是否存在更简单的方案？
+3. **延迟复杂性**：能否在必要时再引入该模式？
+
+## 红旗（反模式）
+
+| 模式 | 反模式 | 更简单的替代方案 |
+| ---- | ------ | ---------------- |
+| Microservices（微服务） | 过早拆分 | 从单体开始，后续再拆 |
+| Clean/Hexagonal（整洁/六边形） | 过度抽象 | 先写具体实现，后引入接口 |
+| Event Sourcing（事件溯源） | 过度设计 | 追加式审计日志 |
+| CQRS（命令查询职责分离） | 不必要的复杂性 | 单一模型 |
+| Repository（仓储模式） | 对简单 CRUD 的 YAGNI（你不会需要它） | ORM 直连 |

package/.agent/skills/architecture/patterns-reference.md

@@ -0,0 +1,50 @@
+# 架构模式参考
+
+> 常用模式快速参考及使用指南。
+
+## 数据访问模式
+
+| 模式 | 适用场景 | 不适用场景 | 复杂度 |
+| ---- | -------- | ---------- | ------ |
+| **Active Record（活动记录）** | 简单 CRUD（增删改查），快速原型开发 | 复杂查询，多数据源 | 低 |
+| **Repository（仓储模式）** | 需要测试，多数据源 | 简单 CRUD（增删改查），单一数据库 | 中 |
+| **Unit of Work（工作单元）** | 复杂事务 | 简单操作 | 高 |
+| **Data Mapper（数据映射）** | 复杂领域、性能要求高 | 简单 CRUD（增删改查），快速开发 | 高 |
+
+## 领域逻辑模式
+
+| 模式 | 适用场景 | 不适用场景 | 复杂度 |
+| ---- | -------- | ---------- | ------ |
+| **Transaction Script（事务脚本）** | 简单 CRUD（增删改查），过程式逻辑 | 复杂业务规则 | 低 |
+| **Table Module（表模块）** | 基于记录的逻辑 | 需要丰富领域行为 | 低 |
+| **Domain Model（领域模型）** | 复杂业务逻辑 | 简单 CRUD（增删改查） | 中 |
+| **DDD（完整领域驱动）** | 复杂领域，有领域专家 | 简单领域，无领域专家 | 高 |
+
+## 分布式系统模式
+
+| 模式 | 适用场景 | 不适用场景 | 复杂度 |
+| ---- | -------- | ---------- | ------ |
+| **Modular Monolith（模块化单体）** | 小团队，边界不清晰 | 上下文清晰、扩缩需求不同 | 中 |
+| **Microservices（微服务）** | 不同扩缩需求、大团队 | 小团队、简单领域 | 极高 |
+| **Event-Driven（事件驱动）** | 实时性、松耦合 | 简单工作流、强一致性 | 高 |
+| **CQRS（命令查询职责分离）** | 读写性能分化明显 | 简单 CRUD（增删改查）、同一模型 | 高 |
+| **Saga（补偿事务）** | 分布式事务 | 单一数据库、简单 ACID（事务特性） | 高 |
+
+## API 模式
+
+| 模式 | 适用场景 | 不适用场景 | 复杂度 |
+| ---- | -------- | ---------- | ------ |
+| **REST（表述性状态转移）** | 标准 CRUD（增删改查），资源导向 | 实时性、复杂查询 | 低 |
+| **GraphQL（图查询语言）** | 灵活查询，多客户端 | 简单 CRUD（增删改查）、强缓存需求 | 中 |
+| **gRPC（远程过程调用）** | 内部服务、高性能 | 公共 API、浏览器客户端 | 中 |
+| **WebSocket（全双工通信）** | 实时更新 | 简单请求/响应 | 中 |
+
+---
+
+## 简单原则
+
+**“从简单开始，只有在证明有必要时才增加复杂性。”**
+
+- 你可以随时在以后添加模式。
+- 移除复杂性远比增加复杂性难得多。
+- 有疑问时，选择更简单的选项。

package/.agent/skills/architecture/trade-off-analysis.md

@@ -0,0 +1,77 @@
+# 权衡分析与 ADR
+
+> 为每一个架构决策记录权衡。
+
+## 决策框架
+
+对每一个架构组件，记录：
+
+```markdown
+## 架构决策记录（ADR）
+
+### 背景
+- **问题**： [我们在解决什么问题？]
+- **约束**： [团队规模、量级、时间线、预算]
+
+### 已考虑的选项
+
+| 选项 | 优点 | 缺点 | 复杂度 | 何时有效 |
+|------|------|------|--------|---------|
+| 选项 A | 收益 1 | 成本 1 | 低 | [适用条件] |
+| 选项 B | 收益 2 | 成本 2 | 高 | [适用条件] |
+
+### 决策
+**选择**： [选项 B]
+
+### 理由
+1. [理由 1 - 与约束相关]
+2. [理由 2 - 与需求相关]
+
+### 接受的权衡（trade-offs）
+- [我们放弃了什么]
+- [为什么这是可以接受的]
+
+### 后果
+- **正面**： [我们获得的收益]
+- **负面**： [我们接受的成本/风险]
+- **缓解**： [如何应对负面影响]
+
+### 重新审视触发点
+- [何时需要重新考虑此决策]
+```
+
+## ADR 模板
+
+```markdown
+# ADR-[XXX]: [决策标题]
+
+## 状态
+Proposed（提议） | Accepted（已采纳） | Deprecated（已废弃） | Superseded by（被取代） [ADR-YYY]
+
+## 背景
+[什么问题？什么约束？]
+
+## 决策
+[我们选择了什么 - 具体描述]
+
+## 理由
+[为什么 - 关联需求和约束]
+
+## 权衡
+[我们放弃了什么 - 诚实记录]
+
+## 后果
+- **正面**： [收益]
+- **负面**： [成本]
+- **缓解**： [如何应对]
+```
+
+## ADR 存储结构
+
+```
+docs/
+└── architecture/
+    ├── adr-001-use-nextjs.md
+    ├── adr-002-postgresql-over-mongodb.md
+    └── adr-003-adopt-repository-pattern.md
+```

package/.agent/skills/bash-linux/SKILL.md

@@ -0,0 +1,201 @@
+---
+name: bash-linux
+description: Bash/Linux terminal patterns（终端模式）。Critical commands, piping, error handling, scripting（核心命令/管道/错误处理/脚本编写）。Use when working on macOS or Linux systems（适用于 macOS 或 Linux 系统）。
+allowed-tools: Read, Write, Edit, Glob, Grep, Bash
+---
+
+# Bash Linux Patterns（Bash/Linux 实践模式）
+
+> Essential patterns for Bash on Linux/macOS（适用于 Linux/macOS 的 Bash 核心模式）。
+
+---
+
+## 1. Operator Syntax（操作符语法）
+
+### Chaining Commands（链式命令）
+
+| Operator（操作符） | Meaning（含义） | Example（示例） |
+| ------ | ---- | ---- |
+| `;` | Run sequentially（顺序执行） | `cmd1; cmd2` |
+| `&&` | Run if previous succeeded（前一命令成功后执行） | `npm install && npm run dev` |
+| `||` | Run if previous failed（前一命令失败后执行） | `npm test || echo "Tests failed"` |
+| `|` | Pipe output（管道输出） | `ls | grep ".js"` |
+
+---
+
+## 2. File Operations（文件操作）
+
+### Essential Commands（核心命令）
+
+| Task（任务） | Command（命令） |
+| ---- | ---- |
+| List all（列出所有） | `ls -la` |
+| Find files（查找文件） | `find . -name "*.js" -type f` |
+| File content（查看内容） | `cat file.txt` |
+| First N lines（前 N 行） | `head -n 20 file.txt` |
+| Last N lines（后 N 行） | `tail -n 20 file.txt` |
+| Follow log（跟踪日志） | `tail -f log.txt` |
+| Search in files（文件内搜索） | `grep -r "pattern" --include="*.js"` |
+| File size（文件大小） | `du -sh *` |
+| Disk usage（磁盘占用） | `df -h` |
+
+---
+
+## 3. Process Management（进程管理）
+
+| Task（任务） | Command（命令） |
+| ---- | ---- |
+| List processes（列出进程） | `ps aux` |
+| Find by name（按名查找） | `ps aux | grep node` |
+| Kill by PID（按 PID 终止） | `kill -9 <PID>` |
+| Find port user（查占用端口） | `lsof -i :3000` |
+| Kill port（释放端口） | `kill -9 $(lsof -t -i :3000)` |
+| Background（后台运行） | `npm run dev &` |
+| Jobs（作业列表） | `jobs -l` |
+| Bring to front（切回前台） | `fg %1` |
+
+---
+
+## 4. Text Processing（文本处理）
+
+### Core Tools（核心工具）
+
+| Tool（工具） | Purpose（用途） | Example（示例） |
+| ---- | ---- | ---- |
+| `grep` | Search（搜索） | `grep -rn "TODO" src/` |
+| `sed` | Replace（替换） | `sed -i 's/old/new/g' file.txt` |
+| `awk` | Extract columns（列提取） | `awk '{print $1}' file.txt` |
+| `cut` | Cut fields（字段切割） | `cut -d',' -f1 data.csv` |
+| `sort` | Sort lines（排序） | `sort -u file.txt` |
+| `uniq` | Unique lines（去重） | `sort file.txt | uniq -c` |
+| `wc` | Count（计数） | `wc -l file.txt` |
+
+---
+
+## 5. Environment Variables（环境变量）
+
+| Task（任务） | Command（命令） |
+| ---- | ---- |
+| View all（查看全部） | `env` or `printenv` |
+| View one（查看单个） | `echo $PATH` |
+| Set temporary（临时设置） | `export VAR="value"` |
+| Set in script（命令内设置） | `VAR="value" command` |
+| Add to PATH（追加 PATH） | `export PATH="$PATH:/new/path"` |
+
+---
+
+## 6. Network（网络操作）
+
+| Task（任务） | Command（命令） |
+| ---- | ---- |
+| Download（下载） | `curl -O https://example.com/file` |
+| API request（API 请求） | `curl -X GET https://api.example.com` |
+| POST JSON（发送 JSON） | `curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL` |
+| Check port（检查端口） | `nc -zv localhost 3000` |
+| Network info（网络信息） | `ifconfig` or `ip addr` |
+
+---
+
+## 7. Script Template（脚本模板）
+
+```bash
+#!/bin/bash
+set -euo pipefail  # Exit on error, undefined var, pipe fail（报错即退出、禁用未定义变量、管道错误传播）
+
+# Colors (optional)（配色选项）
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+NC='\033[0m'
+
+# Script directory（脚本所在目录）
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Functions（日志函数）
+log_info() { echo -e "${GREEN}[INFO]${NC} $1"; }
+log_error() { echo -e "${RED}[ERROR]${NC} $1" >&2; }
+
+# Main（主逻辑）
+main() {
+    log_info "Starting..."
+    # Your logic here
+    log_info "Done!"
+}
+
+main "$@"
+```
+
+---
+
+## 8. Common Patterns（通用模式）
+
+### Check if command exists（检查命令是否存在）
+
+```bash
+if command -v node &> /dev/null; then
+    echo "Node is installed"
+fi
+```
+
+### Default variable value（变量默认值）
+
+```bash
+NAME=${1:-"default_value"}
+```
+
+### Read file line by line（逐行读取文件）
+
+```bash
+while IFS= read -r line; do
+    echo "$line"
+done < file.txt
+```
+
+### Loop over files（循环处理文件）
+
+```bash
+for file in *.js; do
+    echo "Processing $file"
+done
+```
+
+---
+
+## 9. Differences from PowerShell（与 PowerShell 的差异）
+
+| Task（任务） | PowerShell | Bash |
+| ---- | ---------- | ---- |
+| List files（列出文件） | `Get-ChildItem` | `ls -la` |
+| Find files（查找文件） | `Get-ChildItem -Recurse` | `find . -type f` |
+| Environment（环境变量） | `$env:VAR` | `$VAR` |
+| String concat（字符串拼接） | `"$a$b"` | `"$a$b"` (same) |
+| Null check（空值检查） | `if ($x)` | `if [ -n "$x" ]` |
+| Pipeline（管道） | Object-based（对象） | Text-based（文本） |
+
+---
+
+## 10. Error Handling（错误处理）
+
+### Set options（设置选项）
+
+```bash
+set -e          # Exit on error（遇错退出）
+set -u          # Exit on undefined variable（未定义变量即退出）
+set -o pipefail # Exit on pipe failure（管道失败即退出）
+set -x          # Debug: print commands（调试模式）
+```
+
+### Trap for cleanup（资源清理）
+
+```bash
+cleanup() {
+    echo "Cleaning up..."
+    rm -f /tmp/tempfile
+}
+trap cleanup EXIT
+```
+
+---
+
+> **Remember:** Bash is text-based. Use `&&` for success chains, `set -e` for safety, and quote your variables!（Bash 基于文本处理，使用 `&&` 做成功链式调用，使用 `set -e` 保证安全，并始终对变量加引号。）
+
+---