@heyai-rules/pilo-masterkit 2.1.0 → 3.1.0

package/.agent/rules/zh/performance.md

@@ -1,55 +1,55 @@
-# 性能优化
-
-## 模型选择策略
-
-**Haiku 4.5**（Sonnet 90% 的能力，3 倍成本节省）：
-- 频繁调用的轻量级代理
-- 结对编程和代码生成
-- 多代理系统中的工作者代理
-
-**Sonnet 4.6**（最佳编码模型）：
-- 主要开发工作
-- 编排多代理工作流
-- 复杂编码任务
-
-**Opus 4.5**（最深度推理）：
-- 复杂架构决策
-- 最大推理需求
-- 研究和分析任务
-
-## 上下文窗口管理
-
-避免在上下文窗口的最后 20% 进行以下操作：
-- 大规模重构
-- 跨多个文件的功能实现
-- 调试复杂交互
-
-上下文敏感度较低的任务：
-- 单文件编辑
-- 独立工具创建
-- 文档更新
-- 简单 bug 修复
-
-## 扩展思考 + 规划模式
-
-扩展思考默认启用，为内部推理保留最多 31,999 个 token。
-
-通过以下方式控制扩展思考：
-- **切换**：Option+T（macOS）/ Alt+T（Windows/Linux）
-- **配置**：在 `~/.claude/settings.json` 中设置 `alwaysThinkingEnabled`
-- **预算上限**：`export MAX_THINKING_TOKENS=10000`
-- **详细模式**：Ctrl+O 查看思考输出
-
-对于需要深度推理的复杂任务：
-1. 确保扩展思考已启用（默认开启）
-2. 启用**规划模式**进行结构化方法
-3. 使用多轮审查进行彻底分析
-4. 使用分角色子代理获得多样化视角
-
-## 构建排查
-
-如果构建失败：
-1. 使用 **build-error-resolver** 代理
-2. 分析错误消息
-3. 增量修复
-4. 每次修复后验证
+# 性能优化
+
+## 模型选择策略
+
+**Haiku 4.5**（Sonnet 90% 的能力，3 倍成本节省）：
+- 频繁调用的轻量级代理
+- 结对编程和代码生成
+- 多代理系统中的工作者代理
+
+**Sonnet 4.6**（最佳编码模型）：
+- 主要开发工作
+- 编排多代理工作流
+- 复杂编码任务
+
+**Opus 4.5**（最深度推理）：
+- 复杂架构决策
+- 最大推理需求
+- 研究和分析任务
+
+## 上下文窗口管理
+
+避免在上下文窗口的最后 20% 进行以下操作：
+- 大规模重构
+- 跨多个文件的功能实现
+- 调试复杂交互
+
+上下文敏感度较低的任务：
+- 单文件编辑
+- 独立工具创建
+- 文档更新
+- 简单 bug 修复
+
+## 扩展思考 + 规划模式
+
+扩展思考默认启用，为内部推理保留最多 31,999 个 token。
+
+通过以下方式控制扩展思考：
+- **切换**：Option+T（macOS）/ Alt+T（Windows/Linux）
+- **配置**：在 `~/.claude/settings.json` 中设置 `alwaysThinkingEnabled`
+- **预算上限**：`export MAX_THINKING_TOKENS=10000`
+- **详细模式**：Ctrl+O 查看思考输出
+
+对于需要深度推理的复杂任务：
+1. 确保扩展思考已启用（默认开启）
+2. 启用**规划模式**进行结构化方法
+3. 使用多轮审查进行彻底分析
+4. 使用分角色子代理获得多样化视角
+
+## 构建排查
+
+如果构建失败：
+1. 使用 **build-error-resolver** 代理
+2. 分析错误消息
+3. 增量修复
+4. 每次修复后验证

package/.agent/rules/zh/readme.md

@@ -1,108 +1,108 @@
-# 规则
-
-## 结构
-
-规则按**通用**层和**语言特定**目录组织：
-
-```
-rules/
-├── common/          # 语言无关的原则（始终安装）
-│   ├── coding-style.md
-│   ├── git-workflow.md
-│   ├── testing.md
-│   ├── performance.md
-│   ├── patterns.md
-│   ├── hooks.md
-│   ├── agents.md
-│   ├── security.md
-│   ├── code-review.md
-│   └── development-workflow.md
-├── zh/              # 中文翻译版本
-│   ├── coding-style.md
-│   ├── git-workflow.md
-│   ├── testing.md
-│   ├── performance.md
-│   ├── patterns.md
-│   ├── hooks.md
-│   ├── agents.md
-│   ├── security.md
-│   ├── code-review.md
-│   └── development-workflow.md
-├── typescript/      # TypeScript/JavaScript 特定
-├── python/          # Python 特定
-├── golang/          # Go 特定
-├── swift/           # Swift 特定
-└── php/             # PHP 特定
-```
-
-- **common/** 包含通用原则 — 无语言特定的代码示例。
-- **zh/** 包含 common 目录的中文翻译版本。
-- **语言目录** 扩展通用规则，包含框架特定的模式、工具和代码示例。每个文件引用其对应的通用版本。
-
-## 安装
-
-### 选项 1：安装脚本（推荐）
-
-```bash
-# 安装通用 + 一个或多个语言特定的规则集
-./install.sh typescript
-./install.sh python
-./install.sh golang
-./install.sh swift
-./install.sh php
-
-# 同时安装多种语言
-./install.sh typescript python
-```
-
-### 选项 2：手动安装
-
-> **重要提示：** 复制整个目录 — 不要使用 `/*` 展开。
-> 通用和语言特定目录包含同名文件。
-> 将它们展开到一个目录会导致语言特定文件覆盖通用规则，
-> 并破坏语言特定文件使用的 `../common/` 相对引用。
-
-```bash
-# 创建目标目录
-mkdir -p ~/.claude/rules
-
-# 安装通用规则（所有项目必需）
-cp -r rules/common ~/.claude/rules/common
-
-# 安装中文翻译版本（可选）
-cp -r rules/zh ~/.claude/rules/zh
-
-# 根据项目技术栈安装语言特定规则
-cp -r rules/typescript ~/.claude/rules/typescript
-cp -r rules/python ~/.claude/rules/python
-cp -r rules/golang ~/.claude/rules/golang
-cp -r rules/swift ~/.claude/rules/swift
-cp -r rules/php ~/.claude/rules/php
-```
-
-## 规则 vs 技能
-
-- **规则** 定义广泛适用的标准、约定和检查清单（如"80% 测试覆盖率"、"禁止硬编码密钥"）。
-- **技能**（`skills/` 目录）为特定任务提供深入、可操作的参考材料（如 `python-patterns`、`golang-testing`）。
-
-语言特定的规则文件在适当的地方引用相关技能。规则告诉你*做什么*；技能告诉你*怎么做*。
-
-## 规则优先级
-
-当语言特定规则与通用规则冲突时，**语言特定规则优先**（特定覆盖通用）。这遵循标准的分层配置模式（类似于 CSS 特异性或 `.gitignore` 优先级）。
-
-- `rules/common/` 定义适用于所有项目的通用默认值。
-- `rules/golang/`、`rules/python/`、`rules/swift/`、`rules/php/`、`rules/typescript/` 等在语言习惯不同时覆盖这些默认值。
-- `rules/zh/` 是通用规则的中文翻译，与英文版本内容一致。
-
-### 示例
-
-`common/coding-style.md` 推荐不可变性作为默认原则。语言特定的 `golang/coding-style.md` 可以覆盖这一点：
-
-> 惯用的 Go 使用指针接收器进行结构体变更 — 参见 [common/coding-style.md](../common/coding-style.md) 了解通用原则，但这里首选符合 Go 习惯的变更方式。
-
-### 带覆盖说明的通用规则
-
-`rules/common/` 中可能被语言特定文件覆盖的规则会被标记：
-
-> **语言说明**：此规则可能会被语言特定规则覆盖；对于某些语言，该模式可能并不符合惯用写法。
+# 规则
+
+## 结构
+
+规则按**通用**层和**语言特定**目录组织：
+
+```
+rules/
+├── common/          # 语言无关的原则（始终安装）
+│   ├── coding-style.md
+│   ├── git-workflow.md
+│   ├── testing.md
+│   ├── performance.md
+│   ├── patterns.md
+│   ├── hooks.md
+│   ├── agents.md
+│   ├── security.md
+│   ├── code-review.md
+│   └── development-workflow.md
+├── zh/              # 中文翻译版本
+│   ├── coding-style.md
+│   ├── git-workflow.md
+│   ├── testing.md
+│   ├── performance.md
+│   ├── patterns.md
+│   ├── hooks.md
+│   ├── agents.md
+│   ├── security.md
+│   ├── code-review.md
+│   └── development-workflow.md
+├── typescript/      # TypeScript/JavaScript 特定
+├── python/          # Python 特定
+├── golang/          # Go 特定
+├── swift/           # Swift 特定
+└── php/             # PHP 特定
+```
+
+- **common/** 包含通用原则 — 无语言特定的代码示例。
+- **zh/** 包含 common 目录的中文翻译版本。
+- **语言目录** 扩展通用规则，包含框架特定的模式、工具和代码示例。每个文件引用其对应的通用版本。
+
+## 安装
+
+### 选项 1：安装脚本（推荐）
+
+```bash
+# 安装通用 + 一个或多个语言特定的规则集
+./install.sh typescript
+./install.sh python
+./install.sh golang
+./install.sh swift
+./install.sh php
+
+# 同时安装多种语言
+./install.sh typescript python
+```
+
+### 选项 2：手动安装
+
+> **重要提示：** 复制整个目录 — 不要使用 `/*` 展开。
+> 通用和语言特定目录包含同名文件。
+> 将它们展开到一个目录会导致语言特定文件覆盖通用规则，
+> 并破坏语言特定文件使用的 `../common/` 相对引用。
+
+```bash
+# 创建目标目录
+mkdir -p ~/.claude/rules
+
+# 安装通用规则（所有项目必需）
+cp -r rules/common ~/.claude/rules/common
+
+# 安装中文翻译版本（可选）
+cp -r rules/zh ~/.claude/rules/zh
+
+# 根据项目技术栈安装语言特定规则
+cp -r rules/typescript ~/.claude/rules/typescript
+cp -r rules/python ~/.claude/rules/python
+cp -r rules/golang ~/.claude/rules/golang
+cp -r rules/swift ~/.claude/rules/swift
+cp -r rules/php ~/.claude/rules/php
+```
+
+## 规则 vs 技能
+
+- **规则** 定义广泛适用的标准、约定和检查清单（如"80% 测试覆盖率"、"禁止硬编码密钥"）。
+- **技能**（`skills/` 目录）为特定任务提供深入、可操作的参考材料（如 `python-patterns`、`golang-testing`）。
+
+语言特定的规则文件在适当的地方引用相关技能。规则告诉你*做什么*；技能告诉你*怎么做*。
+
+## 规则优先级
+
+当语言特定规则与通用规则冲突时，**语言特定规则优先**（特定覆盖通用）。这遵循标准的分层配置模式（类似于 CSS 特异性或 `.gitignore` 优先级）。
+
+- `rules/common/` 定义适用于所有项目的通用默认值。
+- `rules/golang/`、`rules/python/`、`rules/swift/`、`rules/php/`、`rules/typescript/` 等在语言习惯不同时覆盖这些默认值。
+- `rules/zh/` 是通用规则的中文翻译，与英文版本内容一致。
+
+### 示例
+
+`common/coding-style.md` 推荐不可变性作为默认原则。语言特定的 `golang/coding-style.md` 可以覆盖这一点：
+
+> 惯用的 Go 使用指针接收器进行结构体变更 — 参见 [common/coding-style.md](../common/coding-style.md) 了解通用原则，但这里首选符合 Go 习惯的变更方式。
+
+### 带覆盖说明的通用规则
+
+`rules/common/` 中可能被语言特定文件覆盖的规则会被标记：
+
+> **语言说明**：此规则可能会被语言特定规则覆盖；对于某些语言，该模式可能并不符合惯用写法。

package/.agent/rules/zh/security.md

@@ -1,29 +1,29 @@
-# 安全指南
-
-## 强制安全检查
-
-在任何提交之前：
-- [ ] 无硬编码密钥（API 密钥、密码、令牌）
-- [ ] 所有用户输入已验证
-- [ ] SQL 注入防护（参数化查询）
-- [ ] XSS 防护（净化 HTML）
-- [ ] CSRF 保护已启用
-- [ ] 认证/授权已验证
-- [ ] 所有端点启用速率限制
-- [ ] 错误消息不泄露敏感数据
-
-## 密钥管理
-
-- 永远不要在源代码中硬编码密钥
-- 始终使用环境变量或密钥管理器
-- 启动时验证所需的密钥是否存在
-- 轮换任何可能已暴露的密钥
-
-## 安全响应协议
-
-如果发现安全问题：
-1. 立即停止
-2. 使用 **security-reviewer** 代理
-3. 在继续之前修复关键问题
-4. 轮换任何已暴露的密钥
-5. 审查整个代码库中的类似问题
+# 安全指南
+
+## 强制安全检查
+
+在任何提交之前：
+- [ ] 无硬编码密钥（API 密钥、密码、令牌）
+- [ ] 所有用户输入已验证
+- [ ] SQL 注入防护（参数化查询）
+- [ ] XSS 防护（净化 HTML）
+- [ ] CSRF 保护已启用
+- [ ] 认证/授权已验证
+- [ ] 所有端点启用速率限制
+- [ ] 错误消息不泄露敏感数据
+
+## 密钥管理
+
+- 永远不要在源代码中硬编码密钥
+- 始终使用环境变量或密钥管理器
+- 启动时验证所需的密钥是否存在
+- 轮换任何可能已暴露的密钥
+
+## 安全响应协议
+
+如果发现安全问题：
+1. 立即停止
+2. 使用 **security-reviewer** 代理
+3. 在继续之前修复关键问题
+4. 轮换任何已暴露的密钥
+5. 审查整个代码库中的类似问题

package/.agent/rules/zh/testing.md

@@ -1,29 +1,29 @@
-# 测试要求
-
-## 最低测试覆盖率：80%
-
-测试类型（全部必需）：
-1. **单元测试** - 单个函数、工具、组件
-2. **集成测试** - API 端点、数据库操作
-3. **E2E 测试** - 关键用户流程（框架根据语言选择）
-
-## 测试驱动开发
-
-强制工作流：
-1. 先写测试（RED）
-2. 运行测试 - 应该失败
-3. 编写最小实现（GREEN）
-4. 运行测试 - 应该通过
-5. 重构（IMPROVE）
-6. 验证覆盖率（80%+）
-
-## 测试失败排查
-
-1. 使用 **tdd-guide** 代理
-2. 检查测试隔离
-3. 验证模拟是否正确
-4. 修复实现，而非测试（除非测试有误）
-
-## 代理支持
-
-- **tdd-guide** - 主动用于新功能，强制先写测试
+# 测试要求
+
+## 最低测试覆盖率：80%
+
+测试类型（全部必需）：
+1. **单元测试** - 单个函数、工具、组件
+2. **集成测试** - API 端点、数据库操作
+3. **E2E 测试** - 关键用户流程（框架根据语言选择）
+
+## 测试驱动开发
+
+强制工作流：
+1. 先写测试（RED）
+2. 运行测试 - 应该失败
+3. 编写最小实现（GREEN）
+4. 运行测试 - 应该通过
+5. 重构（IMPROVE）
+6. 验证覆盖率（80%+）
+
+## 测试失败排查
+
+1. 使用 **tdd-guide** 代理
+2. 检查测试隔离
+3. 验证模拟是否正确
+4. 修复实现，而非测试（除非测试有误）
+
+## 代理支持
+
+- **tdd-guide** - 主动用于新功能，强制先写测试