工程技能代理预设dsh-mixxed/dsh-preset-grilling

Grilling Agent Preset (DSH)

本仓库为 mattpocock/skills（Skills For Real Engineers）的 DSH agent 预设版本（DSH = DeepSeek Harness）。

具备 mattpocock/skills 全部能力的 DeepSeek Harness agent 预设，基于 DSH 官方 standard 预设构建，并适配 Windows / Linux 双平台。

English docs: README.md

安装 / 使用方式

将本仓库克隆到 DSH 的 agent-presets 目录下的 grilling 文件夹即可（DSH 会按目录名挂载该预设）：

Linux / macOS

git clone git@github.com:dragons96/dsh-grilling.git ~/.dsh/.agent-presets/grilling

Windows（PowerShell）

git clone git@github.com:dragons96/dsh-grilling.git $HOME\.dsh\.agent-presets\grilling

如果 grilling 目录已存在（例如 DSH 初始化时自动创建），可先删除或备份再克隆：

rm -rf ~/.dsh/.agent-presets/grilling   # 或 Windows: Remove-Item -Recurse $HOME\.dsh\.agent-presets\grilling
git clone git@github.com:dragons96/dsh-grilling.git ~/.dsh/.agent-presets/grilling

若环境变量 DSH_HOME 已设置，请将上面的 ~/.dsh 替换为 $DSH_HOME。

克隆完成后，在 DSH GUI / CLI 中即可选择名为 Grilling 的 agent preset 使用。首次进入某个仓库时，可先让 Agent 运行一次 setup-matt-pocock-skills（配置该仓库的 issue tracker、triage 标签与领域文档布局，为工程流程做准备）。

升级

本仓库以 git 管理，升级只需拉取最新内容：

git -C ~/.dsh/.agent-presets/grilling pull

卸载

直接删除该目录即可：

rm -rf ~/.dsh/.agent-presets/grilling   # 或 Windows: Remove-Item -Recurse $HOME\.dsh\.agent-presets\grilling

包含内容

全部 35 项 mattpocock/skills 技能（位于 skills/，由 agent.cordis.yml 中的 skill-filesystem 行以 customSkillDirs 注册）：

| 技能 | 分类 | 用途 |
| --- | --- | --- |
| ask-matt | engineering | 路由器：判断当前情境该用哪个技能或流程 |
| code-review | engineering | 对某固定点以来的改动做双轴评审（Standards 与 Spec），并行子代理执行 |
| codebase-design | engineering | 深模块共享词汇：设计/改进模块接口、接缝与可测试性 |
| diagnosing-bugs | engineering | 疑难 bug 与性能回退的紧密反馈环——先有证据，再有假设 |
| domain-modeling | engineering | 构建并打磨项目领域模型（CONTEXT.md 词汇表 + ADR） |
| grill-with-docs | engineering | 无情的访谈，同时产出文档（ADR 与词汇表） |
| implement | engineering | 基于 spec 或一组 tickets 实现一项工作 |
| improve-codebase-architecture | engineering | 扫描代码库寻找加深机会，输出 HTML 报告，再就所选项访谈 |
| prototype | engineering | 构建一次性原型以回答设计问题 |
| research | engineering | 后台子代理对高可信一手资料的调研，结果落为 Markdown |
| resolving-merge-conflicts | engineering | 解决进行中的 git merge/rebase 冲突 |
| setup-matt-pocock-skills | engineering | 每仓库一次性配置——issue tracker、triage 标签词汇、领域文档布局 |
| tdd | engineering | 测试驱动开发（red-green-refactor） |
| to-spec | engineering | 把当前对话综合成 spec 并发布到 issue tracker |
| to-tickets | engineering | 把计划/spec 拆成带阻塞边的 tracer-bullet tickets，发布到 tracker |
| triage | engineering | 让 issue/PR 流经一组 triage 状态机角色，最终产出 agent-ready briefs |
| wayfinder | engineering | 把超大工作量规划为决策 tickets 地图，逐个解决直至路径清晰 |
| wizard | engineering | 生成交互式 bash/PowerShell 向导脚本，处理只有人才能完成的步骤 |
| grill-me | productivity | 无状态的无情访谈，用来打磨计划或设计 |
| grilling | productivity | 就某个计划、决策或想法对用户进行无情拷问 |
| handoff | productivity | 把当前对话压缩成交接文档，交给另一个 agent |
| teach | productivity | 在 workspace 内教用户一项新技能或概念 |
| to-questionnaire | productivity | 把无法完全回答的决策变成问卷，交给他人填写 |
| wait-what | productivity | 停下：上一条消息没传达到——换个说法重讲 |
| writing-for-agents | productivity | 撰写供 agent 消费的文档（技能、AGENTS.md/CLAUDE.md） |
| git-guardrails-claude-code | misc | Claude Code hooks：执行前拦截危险 git 命令 |
| migrate-to-shoehorn | misc | 把测试中的 as 断言迁移到 @total-typescript/shoehorn |
| scaffold-exercises | misc | 生成练习题目录结构（sections、problems、solutions） |
| setup-pre-commit | misc | 配置 Husky pre-commit hooks：lint-staged、类型检查与测试 |
| claude-handoff | in-progress | 把对话交接给新的后台 agent，立即接手继续 |
| loop-me | in-progress | 在 workspace 内就你想构建的工作流 spec 进行访谈 |
| setup-ts-deep-modules | in-progress | 接入 dependency-cruiser，让每个包成为深模块（仅入口文件可达） |
| writing-beats | in-progress | 把原始素材组装成一段节拍之旅，逐步奠定术语 |
| writing-fragments | in-progress | 开采原始碎片——探索阶段，尚无结构 |
| writing-shape | in-progress | 把原始素材逐段塑造成文章 |

外加 standard 预设的完整工具集（文件系统、Shell、文件/网页检索、Skills、计划模式、目标、后台任务、子代理、工作流、Ralph 循环、压缩等）与方法论人设：主流程为 grill（访谈）→ spec → tickets → TDD → implement → code-review，含 triage / diagnosing-bugs / wayfinder 入口与 domain-modeling / codebase-design 词汇层。

Windows / Linux 适配

- Shell：Linux 用 bash 工具（技能中的 bash 片段直接可用）；Windows 用 pwsh 工具（技能中的 bash 片段需译为 PowerShell，git 命令两平台一致）。两条行在 agent.cordis.yml 中按平台互斥启用。
- 辅助脚本双形态（.sh 供 Linux / Git Bash，.ps1 供 Windows PowerShell，参数与输出一致）：
- skills/wizard/template.sh + template.ps1
- skills/diagnosing-bugs/scripts/hitl-loop.template.sh + .ps1
- skills/git-guardrails-claude-code/scripts/block-dangerous-git.sh + .ps1
- 打开文件/URL：Linux xdg-open，Windows start，macOS open；临时目录：Linux $TMPDIR//tmp、Windows %TEMP%。
- 其余技能正文保持上游原文（平台无关的 markdown）。

与上游的差异（DSH 没有 ask-matt 斜杠路由）

上游仓库通过 Claude Code 里的 ask-matt 斜杠命令在技能间路由；DSH 没有斜杠命令路由，但其 Web 界面原生支持技能提及：

1. DSH Web 界面支持 /技能 提及——ui-skill 插件在输入框注册了 / 触发的 skill source：输入 / 会弹出所有用户可调用技能（含本预设的 35 项）的选择菜单，选中（或手动键入 /name）会把字面文本 /name 落进消息。宿主侧 dsh-tool-skill 的 pre-step 手势边界会识别用户消息中任意位置、以空白为界、指名用户可调用技能的 /name token，并把渲染后的技能内容注入该轮次——因此 /grilling、/tdd、/code-review 会直接加载对应技能，无需调用 skill 工具。
2. 命令名优先：与宿主命令同名的 /name（如 /compact）解析为命令而非技能。
3. 路由器的核心规则（1% 规则、先技能后行动、技能优先级流程、跨平台规则、工具映射指引）仍直接写入 agent.cordis.yml 的 persona 段落，等价于每次会话启动即生效；模型也可随时用 skill 工具按需加载技能，ask-matt 仍作为可加载技能保留。

维护

- 预设根目录：${DSH_HOME:-$HOME/.dsh}/.agent-presets/grilling/
- 升级技能：重新从上游 mattpocock/skills 仓库复制 skills/（注意保留 .ps1 适配文件）。
- 校验：dsh-agent-presets 的 standingKeyFor('grilling') 挂载校验通过即为可用。