AI Agent Skills
Curated skill collection for AI agents — reusable knowledge, proven workflows.
中文: AI 智能体技能合集仓库。每个技能是一个独立的
SKILL.md，封装特定领域的专家知识和最佳实践。English: A collection of reusable AI agent skills. Each skill is a self-contained
SKILL.mdwith 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. |
🚀 快速入口 | 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
🏗 目录结构 | 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 # 评估用例
🤝 贡献 | Contributing
有新技能想加入合集？欢迎提 Issue 或 PR！
Want to add a new skill? Feel free to open an Issue or PR.
📄 许可 | License
MIT
No comments yet. Be the first to write one.