xiehuan123/coding-coach

编程教练（Coding Coach）

面向非开发人员的「从想法到上线」全流程产品教练：一套固定编排流水线 + 三套技能，覆盖产品 → 界面 → 实现 → 上线。

⚠️ 一个仓库，两个分发物，别搞混：
- Agent 预设「编程教练」（dsh/coding-coach/）→ 一个完整的 agent：中文教练人设 + 自动编排引导 + 35 技能。GUI 里能选到它。
- profile bundle 插件（根目录 package.json + cordis.patch.yml，已发到 npm 包 coding-coach）→ 只是把 35 个技能装进某 profile，不含人设、不会新增 agent。

想用「编程教练」这个 agent：装 Agent 预设；只想把技能塞进自己已有的 agent：装 bundle。

给非开发人员的体验：不需要懂编程术语。直接说「我想做个记账小工具，帮我一步步来」，
AI 会先按 coach-playbook 选模式走八段流水线（澄清 → 用户路径 → 配色 → UI → 原型验证 → 实现 → 验收 → 上线），
每步产出让你确认后再继续，全程用你能听懂的话汇报，并可以随时要求它讲解（teach）或重讲（wait-what）。

技能清单（35 个）

编排流水线

| 技能 | 作用（大白话） |
| --- | --- |
| coach-playbook | 产品编排：从 0 到 1 的八段流水线 + 5 种模式（落地页 / 应用 / 看板 / 小程序 / 内容站） |

工程技能（改编自 mattpocock/skills，MIT）

| 技能 | 作用（大白话） |
| --- | --- |
| ask-matt | 路由：不知道该用哪个流程时先问它 |
| grill-me / grilling | 追问澄清：把模糊想法问清楚再动手 |
| grill-with-docs | 追问澄清（带文档）：边问边沉淀 CONTEXT.md / ADR，边界条件由 AI 推荐 |
| to-spec | 需求转规格：对话整理成需求文档 |
| to-tickets | 任务拆解：拆成可一步步完成的小任务 |
| implement | 实现：按规格写代码（内部走 tdd，完成后 code-review） |
| tdd | 测试驱动开发：先写测试再写实现 |
| prototype | 原型：快速做一次性原型验证想法 |
| diagnosing-bugs | 诊断：系统化排查报错 / 慢 / 行为不对 |
| code-review | 评审：对照规范和需求检查改动质量 |
| research | 调研：派后台子代理查一手资料 |
| domain-modeling | 领域建模：统一术语、记录决策 |
| codebase-design | 代码库设计：深模块设计词汇 |
| teach | 教学：系统化教一个新概念 |
| handoff | 交接：生成交接文档给另一个 AI / 同事 |
| to-questionnaire | 问卷：把缺的信息变成给别人填的问卷 |
| wait-what | 重说：用大白话重新讲一遍 |

产品技能（改编自 Codex product agent）

| 技能 | 作用（大白话） |
| --- | --- |
| product-manager | 产品经理：需求发现 → PRD → 路线图 → 发布 |
| product-feedback-synthesizer | 反馈综合：把用户反馈提炼成改进建议 |
| product-sprint-prioritizer | 优先级排序：RICE 框架排需求优先级 |
| product-trend-researcher | 趋势研究：判断赛道/方向值不值得做 |
| product-behavioral-nudge-engine | 行为助推：提升激活/留存/转化 |

界面与上线技能

| 技能 | 作用（大白话） |
| --- | --- |
| product-designer | 产品体验设计：用户流程、转化路径、功能取舍 |
| ui-designer | 视觉 UI：布局、组件、设计系统、无障碍状态 |
| ui-ux-pro-max | UI/UX 设计智能：风格、配色、字体、组件 |
| design-taste-frontend | 反模板设计品味：落地页/作品集/改版 |
| frontend-architect | 前端架构：组件边界、状态、路由 |
| motion-designer | 动效设计：微交互、转场、缓动 |
| web-design-guidelines | 界面规范评审：无障碍、可用性 |
| vercel-react-view-transitions | 页面切换/过渡动效 |
| vercel-react-best-practices | React 前端性能规则 |
| writing-guidelines | 文案/文档写作规范评审 |
| deploy-to-vercel | 部署到 Vercel 上线 |

安装方式

1. Claude Code 官方插件（推荐）

claude plugin install xiehuan123/coding-coach

或在会话内：/plugin install xiehuan123/coding-coach

也可以通过 skills.sh 安装：npx skills@latest add xiehuan123/coding-coach

2. DeepSeek Harness（DSH）Agent 预设（推荐给非开发人员）

把本仓库的 dsh/coding-coach 目录复制到本机 DSH 预设目录：

mkdir -p ~/.dsh/.agent-presets
cp -R dsh/coding-coach ~/.dsh/.agent-presets/coding-coach

然后在新会话的 Agent 选择器中选中「编程教练」。

3. DeepSeek Harness（DSH）profile 插件（bundle）

把 35 个技能装进某个 profile 的全局技能目录，该 profile 下所有 Agent 都能用：

从 npm（推荐，已发布 coding-coach@1.0.0）
dsh plugin --profile web add coding-coach

或从 GitHubmarkdown
dsh plugin --profile web add github:xiehuan123/coding-coach

安装后可用 dsh --profile web --dump-config 看到新增的 skill-filesystem-coding-coach 行。
npm 包：https://www.npmjs.com/package/coding-coach

4. 手动拷贝 skills

直接把 skills/ 下的任意技能目录拷到你的 agent 技能目录（如 ~/.claude/skills/、~/.agents/skills/）。

仓库结构

coding-coach/
├── README.md                 # 本文件
├── LICENSE                   # MIT（含 mattpocock/skills 原始版权声明）
├── package.json              # DSH bundle 清单（dsh.bundle.patch → cordis.patch.yml）
├── cordis.patch.yml          # DSH bundle patch：插入独立 skill-filesystem 行
├── .claude-plugin/
│   ├── plugin.json           # Claude Code 插件清单（官方格式）
│   └── marketplace.json      # 插件市场清单
├── skills/                   # 35 个技能（SKILL.md，供插件 / 手动安装）
└── dsh/
└── coding-coach/         # DSH Agent 预设（agent.cordis.yml + preset.yml + skills/）

致谢与许可

- 工程技能改编自 mattpocock/skills，
Copyright (c) 2026 Matt Pocock，MIT License。
- 产品技能改编自本机 Codex product agent（~/.codex/agents/product-.toml）。
- 界面/上线技能来自全局 skills（ui-ux-pro-max、web-design-guidelines、writing-guidelines、
deploy-to-vercel 及 Vercel 官方 vercel-react-；其中 vercel-react-* 为 MIT）。
- 本仓库：MIT License（见 LICENSE）。
- 改编内容：双语描述、删除 Claude Code / Codex 专属配置，新增中文路由技能 ask-matt。
如需再分发非 MIT 来源的技能，请自行确认其许可条款。