内容
# Tstack - Claude 代码能力用户配置
我的 Claude 代码设置，适用于软件工程、SOC 操作和产品管理 - 51 种技能，34 种命令，7 个自定义 MCP 服务器，14 个插件，自定义钩子和多代理编排。
> **所有个人身份信息（PII）、API 密钥、密码和服务器 URL 已被删除。** 这是一个参考/灵感仓库，而不是可以直接使用的配置。
---
## 目录
- [MCP 服务器](#mcp-ervers)
- [插件](#插件)
- [技能](#技能)
- [自定义命令](#自定义命令)
- [钩子](#钩子)
- [代理和团队](#代理和团队)
- [设置亮点](#设置亮点)
---
## MCP 服务器
用于外部工具访问的自定义 Python MCP 服务器和第三方服务器：
| 服务器 | 包 / 运行环境 | 目的 |
|--------|-------------------|---------|
| **brave-search** | `@brave/brave-search-mcp-server` (npx) | 通过 Brave API 进行网络搜索 |
| **puppeteer** | `@modelcontextprotocol/server-puppeteer` (npx) | 无头浏览器自动化 |
| **sequential-thinking** | `@modelcontextprotocol/server-sequential-thinking` (npx) | 思维链推理 |
| **opensearch** | 自定义 Python 服务器 | 查询 OpenSearch 集群（日志、错误、跟踪） |
| **atlassian** | `@anthropic/mcp-server-atlassian` (npx) | Jira 工单管理 |
| **prometheus** | 自定义 Python 服务器 | Prometheus 指标查询和警报 |
| **notion** | 自定义 Python 服务器（uv + httpx） | 通过 cookie 身份验证的 Notion API |
| **soc-investigations** | 自定义 Python 服务器（uv + psycopg2） | 示例 SOC 调查查询针对 Postgres DB |
| **soc-infrastructure** | 自定义 Python 服务器（uv + psycopg2） | 示例基础设施健康检查（pod、OOM、磁盘、队列） |
| **soc-integrations** | 自定义 Python 服务器（uv + psycopg2） | 示例集成健康和错误监控 |
| **gmail** | `@gongrzhe/server-gmail-autoauth-mcp` (npx) | 使用 OAuth 读取/发送/草拟 Gmail |
| **computer-use** | Anthropic Computer Use MCP | 本地桌面应用程序自动化 |
| **chrome-devtools** | Chrome DevTools MCP | 浏览器 DOM 交互 |
| **macos-automator** | macOS Automator MCP | AppleScript/JXA 执行 |
| **exa** | Exa 搜索 MCP | AI 原生网络搜索 |
### MCP 服务器架构
```
mcp-servers/
opensearch-direct/ # 直接 OpenSearch 查询（Python）
opensearch-dashboards/ # OpenSearch 仪表盘代理（Python）
prometheus/ # PromQL 查询（Python）
notion/ # Notion 内部 API（Python）
soc-investigations/ # 警报和调查查询
soc-infrastructure/ # Pod 健康状况、OOM、磁盘 IO
soc-integrations/ # 集成状态和错误
shared/ # 共享实用程序（DB、kubectl、Teams webhook）
```
---
## 插件
已安装的 14 个插件（12 个活跃）：
| 插件 | 市场 | 状态 | 目的 |
|--------|-------------|--------|---------|
| **plugin-dev** | claude-code-plugins | 活跃 | 插件开发工具包（创建技能、代理、钩子） |
| **canvas** | claude-canvas | 活跃 | 终端 TUI 画布（日历、文档、航班） |
| **claude-delegator** | jarrodwatts-claude-delegator | 活跃 | 将任务委托给 Codex/其他代理 |
| **pm-toolkit** | pm-skills | 活跃 | NDA 草稿、简历审查、校对、隐私政策 |
| **pm-product-strategy** | pm-skills | 活跃 | SWOT、PESTLE、波特五力分析、定价、商业模式 |
| **pm-product-discovery** | pm-skills | 活跃 | 功能优先级、实验、访谈脚本 |
| **pm-market-research** | pm-skills | 活跃 | 竞争对手分析、角色、旅程图、市场规模 |
| **pm-data-analytics** | pm-skills | 活跃 | 队列分析、A/B 测试、SQL 生成 |
| **pm-marketing-growth** | pm-skills | 活跃 | 北极星指标、定位、产品命名 |
| **pm-go-to-market** | pm-skills | 活跃 | GTM 策略、增长循环、战斗卡、ICP |
| **pm-execution** | pm-skills | 活跃 | PRD、OKR、冲刺、用户故事、利益相关者地图 |
| **ralph-loop** | claude-plugins-official | 禁用 | 循环任务循环 |
| **ralph-wiggum** | claude-code-plugins | 禁用 | 同伴 blob |
| **frontend-design** | claude-code-plugins | 禁用 | 前端设计辅助 |
### 自定义市场
- **pm-skills** 来自 `phuryn/pm-skills`（GitHub）- 完整的 PM 工具包套件
---
## 技能
### 工程和 DevOps
| 技能 | 描述 |
|-------|-------------|
| `/ship` | 完整的交付流程 - 合并基准、测试、审查、版本提升、更改日志、PR |
| `/review` | 预着陆 PR 审查（SQL 安全、LLM 信任边界、副作用） |
| `/review-pr` | 审查 PR 并留下评论 |
| `/review-pr-dual` | 双模型验证（Codex + Opus），具有交叉验证的发现 |
| `/review-pr-codex` | 使用 OpenAI Codex 审查 PR |
| `/check-pr` | 检查 PR 是否有未解决的评论、失败的检查 |
| `/understand-pr` | 系统地导航大型 PR - 文件按文件 |
| `/fix-ci` | 修复 CI/CD 管道问题 |
| `/fix-migrations` | 修复合并主分支后的 Django 迁移冲突 |
| `/investigate` | 系统调试，具有根原因调查（4 个阶段） |
| `/git-pr-bug-attribution` | 确定 bug 是否由特定 PR 引入 |
| `/simplify` | 审查更改的代码以重用、质量、效率 |
| `/greploop` | 循环 Greptile 审查，直到零评论 |
| `/document-release` | 发布后文档更新 |
| `/land-and-deploy` | 合并 PR，等待 CI，验证生产健康状况 |
| `/deploy-staging` | 部署到预发布环境 |
| `/deploy-preprod` | 部署到预生产环境 |
| `/setup-deploy` | 配置部署平台设置 |
| `/prod-verify` | 验证 PR 代码更改与生产数据 |
| `/codex` | OpenAI Codex CLI - 审查、挑战、委托模式 |
| `/codex-swarm` | 为子任务启动并行 Codex 代理 |
| `/orchestrate` | 在 tmux 窗格中编排多个 Claude/Codex 代理 |
| `/swarm-review` | 6 个并行代理 - Docker、前端、Codex、Playwright、Opus、实时 |
| `/retro` | 每周工程回顾与趋势跟踪 |
| `/weekly-report` | 从 GitHub 活动生成每周报告 |
### 浏览器和 QA
| 技能 | 描述 |
|-------|-------------|
| `/browse` | 用于 QA 和站点测试的快速无头浏览器 |
| `/gstack` | 无头浏览器 CLI（基于 Playwright）用于测试 |
| `/gstack-upgrade` | 升级 gstack 到最新版本 |
| `/connect-chrome` | 启动由 gstack 控制的真实 Chrome，并带有侧面板 |
| `/qa` | 系统地 QA 测试 Web 应用程序并修复发现的错误 |
| `/qa-only` | 仅报告 QA 测试，带有健康评分和截图 |
| `/design-review` | 设计师的 QA - 视觉不一致性、间距、层次结构 |
| `/canary` | 部署后 Canary 监控错误和回归 |
| `/benchmark` | 使用浏览守护进程检测性能回归 |
| `/teardown` | 从前端反向工程 Web 应用程序架构 |
| `/setup-browser-cookies` | 将 cookie 从真实浏览器导入无头会话 |
| `/agent-browser` | 通过 agent-browser CLI 进行浏览器自动化 |
| `/electron` | 通过 CDP 自动化 Electron 桌面应用程序 |
### 安全和 SOC
| 技能 | 描述 |
|-------|-------------|
| `/soc` | SOC 代理故障排除 - 调查、基础设施、集成 |
| `/status` | 错误状态报告，带有 RCA、堆栈跟踪和受影响的租户 |
| `/alert-errors` | 检查 OpenSearch 错误，创建 Zenduty 事件 |
| `/cso` | 首席安全官模式 - 基础设施优先的安全审计 |
| `/opensearch` | 查询 OpenSearch 日志，带有灵活的过滤器 |
| `/opensearch-traceback-retrieval` | 从结构化日志中检索完整的 Python 堆栈跟踪 |
| `/prometheus` | 查询 Prometheus 指标、健康检查、PromQL |
| `/langfuse` | Langfuse LLM 可观察性洞察 |
| `/rancher` | Rancher API - 集群、kubeconfig、节点、工作负载 |
### 生产力和沟通
| 技能 | 描述 |
|-------|-------------|
| `/notion` | 与 Notion 的内部 API 交互 |
| `/jira` | 创建/管理 Jira 工单 |
| `/n8n` | 与 n8n 工作流交互 |
| `/tmux` | 在 tmux 中管理 Claude Code 会话 |
| `/find-chat` | 搜索 Claude Code 聊天历史并打开匹配的会话 |
| `/deep-research` | 使用思维图进行深入研究 - 并行探索 |
| `/youtube-to-ebook` | 将 YouTube 视频转换为格式化的电子书文章 |
| `/learn` | 学习技能 |
### 写作和风格
| 技能 | 描述 |
|-------|-------------|
| `/devils-advocate` | 对抗性论证循环 - Steelman 然后摧毁 |
| `/frontend-slides` | 创建富含动画的 HTML 演示文稿 |
### 规划和审查
| 技能 | 描述 |
|-------|-------------|
| `/plan-ceo-review` | CEO/创始人模式计划审查 - 10 星级产品思维 |
| `/plan-eng-review` | 工程经理计划审查 - 架构、数据流、边缘情况 |
| `/plan-design-review` | 设计师视角计划审查 - 每个维度评分 0-10 |
| `/autoplan` | 自动审查管道 - 顺序运行 CEO、设计、工程审查 |
| `/planning-with-files` | 基于文件的规划，类似 Manus - 带有 task_plan.md |
| `/design-consultation` | 完整的设计系统提案（美学、排版、颜色） |
| `/product-management` | 非开发者的 PM 模式 - 桥接设计和工程 |
| `/vibe-coding` | 快速原型设计的 vibe 编码最佳实践 |
### 基础设施和配置
| 技能 | 描述 |
|-------|-------------|
| `/install-mcp` | 安装和配置 MCP 服务器 |
| `/create-command` | 创建 Claude Code 斜杠命令 |
| `/freeze` / `/unfreeze` | 限制/解除对特定目录的文件编辑 |
| `/guard` | 完整的安全模式 - 破坏性警告 + 目录范围 |
| `/careful` | 破坏性命令的安全防护 |
| `/drawio` | 创建图表、流程图、架构图 |
| `/ink` | JSON 规范的 Ink 终端渲染器 |
| `/raycast` | 管理 Raycast 脚本命令 |
| `/inference-profile` | AWS Bedrock 推理配置文件详细信息 |
| `/find-skills` | 发现和安装代理技能 |
### 参考文档（在技能中）
这些是独立的技能文件，作为参考指南，而不是斜杠命令：
| 文件 | 描述 |
|------|-------------|
| `code-review-senior-guidelines.md` | 后端代码的通用高级审查模式 |
| `codex-delegation.md` | 如何将任务委托给 OpenAI Codex |
| `engineering-judgment.md` | “菠菜规则” - 何时抵制有缺陷的假设 |
| `generate-ralph-loop.md` | 自动生成循环任务循环命令 |
| `pr-workflow.md` | PR 创建、审查和提交工作流模板 |
| `ui-testing.md` | UI 测试参考（始终使用隐身模式） |
---
## 自定义命令
`commands/` 中有 34 条斜杠命令：
带有 YAML 前面的 markdown 文件，定义特定工作流的提示、工具权限和行为。类别包括 PR 审查、部署、研究、监控和生产力。
---
## 钩子
带有 shell 自动化的生命周期钩子：
| 事件 | 钩子 | 目的 |
|-------|-------|---------|
| **SessionStart** | peon-ping, iterm2-claude | 声音通知，iTerm2 集成 |
| **Stop** | peon-ping, iterm2-claude | 完成通知 |
| **Notification** | peon-ping, iterm2-claude | 警报通知 |
| **UserPromptSubmit** | hook-handle-use, iterm2-claude | 使用情况跟踪 |
### 包含在仓库中
- **iterm2-claude.sh** - 基于会话状态的 iTerm2 标签颜色/徽章集成
- **peon-ping/scripts/hook-handle-use.sh** - 声音包切换钩子
注意：主要的 `peon.sh` 脚本和声音文件未包含在内（它们引用本地音频资产）。
---
## 代理和团队
### 内置代理类型
- **general-purpose** - 复杂的多步骤任务
- **Explore** - 快速代码库探索（快速/中等/非常彻底）
- **Plan** - 软件架构师，用于实施规划
- **claude-code-guide** - Claude Code / API 文档问题
### 插件代理
- **plugin-dev:skill-reviewer** - 审查技能质量
- **plugin-dev:plugin-validator** - 验证插件结构
- **plugin-dev:agent-creator** - 创建新代理
### 多代理编排
- `/orchestrate` - 在 tmux 窗格中运行多个 Claude/Codex 代理
- `/codex-swarm` - 将任务分解为并行 Codex 代理的子任务
- `/swarm-review` - 6 个并行审查代理同时运行
- 通过 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` 使用代理团队
---
## 设置亮点
### 权限模型
```json
{
"defaultMode": "auto",
"allow": [
"Bash(xargs cat:*)",
"Bash(git pull:*)",
"Bash(git show:*)"
]
}
```
### 加载器自定义
自定义梵文咒语加载器动词（108 个咒语）替换默认加载消息。
### 状态栏
用于 iTerm2 状态栏集成的自定义 bash 脚本。
### 内存系统
`~/.claude/projects/<project>/memory/` 中基于文件的持久内存，类型：
- **user** - 角色、目标、偏好
- **feedback** - 纠正和确认的方法
- **project** - 正在进行的上下文工作
- **reference** - 指向外部系统的指针
---
## 目录结构
```
tstack/
README.md # 此文件
mcp.json.example # MCP 服务器配置模板
settings.json.example # Claude Code 设置模板
skills/ # 45 个技能目录 + 6 个参考文档
ship/SKILL.md
review/SKILL.md
investigate/SKILL.md
...
code-review-senior-guidelines.md
engineering-judgment.md
pr-workflow.md
...
commands/ # 34 条斜杠命令定义
deploy-staging.md
review-pr.md
soc.md
...
hooks/ # 生命周期 shell 脚本
iterm2-claude.sh
peon-ping/scripts/hook-handle-use.sh
mcp-servers/ # 7 个自定义 MCP 服务器实现
shared/ # DB、kubectl、Teams webhook 实用程序
opensearch-direct/ # OpenSearch 查询服务器
opensearch-dashboards/ # OpenSearch 仪表盘代理
prometheus/ # PromQL 服务器
notion/ # Notion API 服务器
soc-investigations/ # 示例调查查询
soc-infrastructure/ # 示例 pod 健康状况、OOM、磁盘 IO
soc-integrations/ # 示例集成健康监控
```
---
## 如何使用此灵感
1. **从 MCP 服务器开始** - 它们为 Claude 提供现实世界的访问。从 `sequential-thinking` 和 `puppeteer` 开始，根据需要添加特定领域的服务器。
2. **逐步构建技能** - 每个技能只是一个带有提示的 markdown 文件。从最重复的工作流开始。
3. **钩子被低估了** - `UserPromptSubmit` 钩子允许你在每个提示上注入行为。使用它们进行自动日志记录或安全检查。
4. **插件扩展系统** - 仅 PM 技能套件就添加了 80+ 个产品管理功能。
5. **内存持续上下文** - 使用它进行用户偏好和项目上下文，而不必每次会话重新发现它们。
---
## 许可证
MIT
