High-cla/multi-skilled-repository

AI Agent Skills
为 AI 智能体精心整理的技能合集 — 可复用的知识，经过验证的工作流。

中文：AI 智能体技能合集仓库。每个技能是一个独立的 SKILL.md，封装特定领域的专家知识和最佳实践。

English：A collection of reusable AI agent skills. Each skill is a self-contained SKILL.md with domain-specific knowledge and proven workflows.

📦 Skills

| Skill | Description |
|-------|-------------|
| cmd-powershell-pitfalls | CMD + PowerShell 混合脚本避坑指南 — 35 条规则与代码示例，涵盖编码、引号逃逸、延迟展开、管道编码、权限提权等场景。Use when writing or debugging .cmd/.bat scripts with embedded PowerShell. |
| cli-first-decision | CLI-First 决策矩阵 — 每次 task() 前判断是否可用 CLI 工具更快解决。包含 git-sed, fd-find, rg-search, ast-grep, jq-query 等工具速查表。Use before any agent dispatch to check CLI alternatives. |
| customize-dsh | DeepSeek Harness (DSH) 自定义修改指南 — settings.yaml、profiles//cordis.patch.yml 与 bundles、技能创作与修复、agent preset、MCP server (dsh-mcp-client)、cordis 插件、自定义工具、slash 命令、启动失败与 patch 报错诊断。Use when editing or creating DSH configs/extensions. |
| game-item-spawner | 游戏模组"网页点击生成物品"系统 — 逆向找生成API、提取物品目录(内嵌JSON)、模组内嵌本地HTTP服务器(localhost:PORT)、网页物品浏览器(分类/搜索/点击生成)、GitHub Pages托管+全链路验证。Use when user wants in-game item spawning with a visual web UI (spawn item, item browser, cheat generator). |

🚀 快速入口 | Quick Entry

cmd-powershell-pitfalls

编写 Windows 批处理（.cmd / .bat）并内嵌 PowerShell 命令时，常见的陷阱与解决方案。

17 条核心规则预览:

| # | 类别 | 问题 | 严重性 |
|---|------|------|--------|
| 1 | 🔤 编码 | chcp 65001 破坏 %VAR% 展开 | 🔴 High |
| 2 | 🔄 循环 | for 循环体内 ) 被当作结束符吞掉 | 🔴 High |
| 3 | ❝ 引号 | \" 在 CMD 字符串中无效 | 🔴 High |
| 4 | 🧩 对象类型 | Get-Location 返回 PathInfo 而非字符串 | 🔴 High |
| 5 | ⏳ 延迟展开 | 循环内改变量必须用 !var! | 🔴 High |
| 6 | 📦 重定向 | 括号 () 与输出重定向 > 的优先级问题 | 🟡 Medium |
| 7 | ➖ 续行 | ^ 在双引号内不起作用 | 🟡 Medium |
| 8 | 💲 变量传递 | $ / % 在 CMD → PowerShell 的传递规则 | 🟡 Medium |
| 9 | 📝 文件编码 | Set-Content 在各 PowerShell 版本的默认编码差异 | 🟡 Medium |
| 10 | ❌ 错误处理 | %ERRORLEVEL% 与 $LASTEXITCODE 的正确使用 | 🟡 Medium |
| 11 | 🚪 退出码 | PowerShell 退出码需显式传递回 CMD | 🟡 Medium |
| 12 | 📁 路径 | %~dp0 的正确使用与拼接方式 | 🟢 Low |
| 13 | 🔍 过滤 | findstr 正则语法有限 | 🟢 Low |
| 14 | 🔗 管道 | \| 在 CMD 字符串中不会触发管道解析 | 🟢 Low |
| 15 | ⚡ 性能 | .NET 直调 vs Cmdlet 的性能差距 | 🟢 Low |
| 16 | 📄 追加 vs 重定向 | 循环内 >> 逐个打开文件 vs 一次性 > | 🟢 Low |
| 17 | ✅ 检查清单 | 写完脚本后逐项自查 | — |

➡️ 完整内容: skills/cmd-powershell-pitfalls/SKILL.md

cli-first-decision
核心规则：每次 task() 前，先问有没有现成的 CLI 工具能更快解决。

| 场景 | 首选工具 | 耗时 |
|------|---------|------|
| 批量文本替换 | git-sed | <1s |
| 文件查找 | fd-find | <1s |
| 内容搜索 | rg-search | <1s |
| AST 搜索替换 | ast-grep | <1s |
| JSON 查询 | jq-query | <1s |
| HTTP API 测试 | git-curl | <1s |
| 模糊过滤 | fzf-filter | <1s |
| 打包解压 | git-tar | <1s |
| 换行符转换 | git-dos2unix | <1s |
| ✅ 语义/决策 | 派代理 | 数十秒+ |

➡️ 完整内容: skills/cli-first-decision/SKILL.md

customize-dsh

编辑或创建 DeepSeek Harness (DSH) 自身配置与扩展时的权威参考：

| 定制面 | 关键文件/机制 |
|--------|--------------|
| 配置 | settings.yaml（默认模型/权限预设/主题） |
| Profile/Patch | profiles//cordis.patch.yml、package.json (dsh.profile.bundles) |
| 技能 | ~/.dsh/skills、~/.agents/skills、项目 .dsh/skills（6 层 rank） |
| MCP | @deepseek-ai/dsh-mcp-client（stdio / streamable-http） |
| 插件/工具/命令 | cordis 插件包、defineTool、ctx.commands.register |

涵盖配置生效时机（HMR/热重载）、Profiles 层叠与 patch 语义（insert/disable/整体替换）、反直觉陷阱（空/仅注释 patch 文件 throws 须用 []）、逃生舱（dev_fix_patch/dev_heal_links/dev_clear_routes/dev_uninject_plugin）等。附带 evals/evals.json（6 个评估用例）。

➡️ 完整内容: skills/customize-dsh/SKILL.md

game-item-spawner

为游戏模组搭建"网页点击生成物品"系统——网页物品浏览器点"生成"→ 物品进游戏背包。

核心架构: 网页只用 HTTP，与游戏解耦；模组是本机服务。

| 环节 | 说明 |
|------|------|
| 逆向 | 找游戏生成API（DirectoryMaster.Item 类）+ 主背包入口 |
| 提取 | 内嵌资源 JSON → items_data.js（ID/名称/分类） |
| 服务器 | 模组内嵌 HttpListener (localhost:26880)，HTTP线程只入队、主线程OnUpdate消费（IL2CPP防跨线程崩） |
| 网页 | 分类侧栏+搜索+卡片+生成按钮+状态点+Toast，可托管 GitHub Pages |
| 验证 | mock 服务器模拟 /api/health+/api/spawn，无游戏也能全链路测 |

换游戏复用: 骨架 100% 通用，仅改 3 处（创建API/主背包/入包API）。附带 evals/evals.json（3 个评估用例）。

➡️ 完整内容: skills/game-item-spawner/SKILL.md

🏗 目录结构 | Directory Structure

.
├── .gitignore
├── README.md                          # 本文件
└── skills/
├── cmd-powershell-pitfalls/
│   └── SKILL.md                   # CMD + PowerShell 混合脚本避坑指南
├── cli-first-decision/
│   └── SKILL.md                   # CLI-First 决策矩阵
├── customize-dsh/
│   ├── SKILL.md                   # DSH 自定义修改指南
│   └── evals/evals.json           # 评估用例
└── game-item-spawner/
├── SKILL.md                   # 游戏模组"网页点击生成物品"系统
├── scripts/                   # spawn_server.cs / mock_spawn_server.py / extract_catalog.py
├── assets/                    # items_browser.html / items_data.example.js
└── evals/evals.json           # 评估用例

🤝 贡献 | Contributing

有新技能想加入合集？欢迎提 Issue 或 PR！

Want to add a new skill? Feel free to open an Issue or PR.

📄 许可 | License

MIT