我筛了 5 个值得装进 Skillshare 的工程化 Skills：grill-with-docs、tdd、diagnose、to-prd、improve-codebase-architecture。

筛选思路

从 mattpocock/skills 里，只挑出 5 个能补位、不过度重复的工程化 Skill，装进 Skillshare 统一源，再同步到 Codex、Claude Code、OpenCode。

核心原则：不是"装得越多越好"，而是"只装补位最明显的"。

不筛选会怎样

问题	说明
Skill 名字很多	一堆 Skill 不知道用哪个
职责重叠	触发时不知道该用哪个
重复指令	同一个问题有多种做法
选择困难	用久了反而不知道该调用哪个

已有能力清单

假设你已经有这些基础 Skill：

Skill	功能
clean-code	代码整洁
refactoring	重构
code-qc	代码质量检查
tech-debt-tracker	技术债务追踪
skillshare	Skill 管理

推荐的 5 个 Skills

速查表

Skill	核心功能	定位
grill-with-docs	需求澄清	需求层
tdd	测试驱动开发	开发层
diagnose	问题诊断	诊断层
to-prd	上线检查	上线层
improve-codebase-architecture	架构优化	重构层

Skill 详解

1. grill-with-docs

最推荐装的一个。

维度	说明
核心价值	不是简单地"多问你几个问题"，而是把需求澄清、上下文整理、术语统一一起做掉
解决问题	AI 协作里常见问题：你以为说明白了，模型也以为听懂了，但双方其实没有形成同一个问题定义

它会逼你说明白这些：

问题	说明
到底要解决什么问题	核心目标
当前系统的边界是什么	上下文
领域词汇是什么意思	术语统一
为什么这个决策成立	决策依据
有没有需要沉淀的内容	文档沉淀

适合场景：

• 改一个中大型功能前
• 新项目启动
• 需求不清晰时

2. tdd

维度	说明
核心价值	测试驱动开发，先写测试再写代码
解决问题	代码测试覆盖率低、Bug 多

工作流：

① 写一个失败的测试
② 写最少的代码让测试通过
③ 重构
④ 重复

适合场景：

• 新功能开发
• 重构前写保护网
• 关键逻辑测试

3. diagnose

维度	说明
核心价值	系统性问题诊断
解决问题	Bug 定位困难、问题反复出现

诊断维度：

维度	内容
症状分析	什么现象
原因定位	为什么发生
影响评估	影响范围多大
解决方案	怎么修复
预防措施	怎么避免

适合场景：

• 复杂 Bug 定位
• 性能问题诊断
• 系统性问题排查

4. to-prd

维度	说明
核心价值	上线前检查清单
解决问题	上线后发现问题、回滚频繁

检查清单：

检查项	说明
代码审查	是否经过 review
测试覆盖	关键路径是否测试
文档更新	文档是否同步
配置检查	配置文件是否正确
回滚方案	能否快速回滚

适合场景：

• 新功能上线
• 配置变更
• 重大版本发布

5. improve-codebase-architecture

维度	说明
核心价值	架构层面优化
解决问题	技术债务、架构腐化

优化方向：

方向	说明
模块化	解耦、职责分离
层次清晰	分层架构是否合理
依赖管理	依赖方向是否正确
可扩展性	新功能是否容易添加

适合场景：

• 大型重构
• 技术债务清理
• 架构升级

Skill 三层分工

┌─────────────────────────────────────────────────────────────┐
│                 Skillshare 能力分层                          │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│   需求层                                                    │
│   └── grill-with-docs：澄清需求                             │
│                                                             │
│   开发层                                                    │
│   ├── tdd：测试驱动                                        │
│   ├── diagnose：问题诊断                                    │
│   └── improve-codebase-architecture：架构优化               │
│                                                             │
│   上线层                                                    │
│   └── to-prd：上线检查                                      │
│                                                             │
└─────────────────────────────────────────────────────────────┘

安装方法

基础安装

# 克隆 Skillshare 仓库
git clone https://github.com/yourusername/skillshare.git

# 进入目录
cd skillshare

# 安装所有推荐 Skill
skillshare install grill-with-docs
skillshare install tdd
skillshare install diagnose
skillshare install to-prd
skillshare install improve-codebase-architecture

同步到多个工具

# 同步到 Codex
skillshare sync --to codex

# 同步到 Claude Code
skillshare sync --to claude-code

# 同步到 OpenCode
skillshare sync --to opencode

# 全部同步
skillshare sync --all

验证安装

# 查看已安装的 Skills
skillshare list

# 查看特定 Skill
skillshare show grill-with-docs

适用场景对比

场景	推荐 Skill
需求不清晰	grill-with-docs
TDD 开发	tdd
Bug 定位	diagnose
上线前检查	to-prd
技术债务	improve-codebase-architecture
代码重构	tdd + improve-codebase-architecture
新功能开发	grill-with-docs + tdd + to-prd

最小清单建议

如果只能装 3 个，推荐：

优先级	Skill	原因
1	grill-with-docs	需求澄清是很多问题的根源
2	tdd	测试是代码质量的保障
3	to-prd	上线前最后一道防线

常见问题

问题	解答
Skill 冲突怎么办？	明确每个 Skill 的使用场景，避免同时触发
哪个 Skill 最值得装？	grill-with-docs，解决需求层问题
Skill 装多了有影响吗？	会导致选择困难，建议只装最需要的
能否自定义 Skill？	可以，参考 Skillshare 的模板

一句话总结

Skillshare 筛选原则：不是装得多，是装得准。

5 个推荐 Skill：

• grill-with-docs：需求澄清
• tdd：测试驱动
• diagnose：问题诊断
• to-prd：上线检查
• improve-codebase-architecture：架构优化

最小清单：grill-with-docs + tdd + to-prd。