Skip to main content
ClaudeWave
Skill1k repo starsupdated 11d ago

design

结构化技术设计工作流,适用于显式 design doc 或 checklist 生成;不负责需求盘问、bug 修复或正式代码审查。

Install in Claude Code
Copy
git clone --depth 1 https://github.com/doccker/cc-use-exp /tmp/design && cp -r /tmp/design/.codex/skills/cc-design ~/.claude/skills/design
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# Design

当用户明确要求 design、design doc 或 design checklist 时,使用本技能。

不要用于:

- 需求挖掘或需求拷问
- bug 修复
- 正式 code review
- 语言实现细节

## 核心方式

1. 明确目标、边界和约束。
2. 先识别关键 tradeoff,再组织方案。
3. 需要输出文档时使用 doc 模板。
4. 需要结构化检查时使用 checklist 模板。

## 按需展开

- 设计范围:`references/design-scope.md`
- Tradeoff 思考:`references/tradeoff-thinking.md`
- Checklist 用法:`references/checklist-usage.md`
api-design-safetySkill

当设计或修改 REST API 响应结构、处理 API 返回值,或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义,以及生成产物时关键字段缺失但静默成功的问题。

api-proxy-safetySkill

网关/代理/WAF/CDN 中间件的安全关键词匹配实现规范,防止纯子串匹配误判正常响应内容中的技术术语(如 Cloudflare、502、error)

async-task-patternSkill

当 API/任务可能执行超过 10 秒(批量数据处理、远程 API 批量调用、全表扫描、跨租户聚合)时触发。防止同步接口被网关 30s 超时切断、用户重复点击触发并发、状态缓存内存泄漏等问题。提供异步任务状态机标准模板。

bash-styleSkill

当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件,或在 Markdown 中编写 bash 代码块时触发。提供 Bash 编写规范。

code-quality-principlesSkill

当编写新模块、设计接口、重构代码或代码审查时触发。提供经典模块化六原则检查清单(大小适中/调用深度/扇入扇出/边界清晰/作用域内聚/可预测性),适用于 PR/Review/新模块设计场景。

external-system-debuggingSkill

涉及浏览器、编辑器、CDN/WAF、IM 平台、操作系统剪贴板、第三方 SaaS 等"外部黑盒系统"的代码编写或 bug 调试时触发。强制先抓真实环境数据再推理,避免连续 2 轮"凭代码推理"的修复 no-op。关键词:粘贴/复制异常、跨平台显示不一致、第三方 API 怪结果、CDN/WAF 拦截、本地复现失败、HTML→MD 转换丢属性。

field-mapping-safetySkill

当重构涉及字段映射(dataIndex、枚举映射、类型转换)时触发。防止字段名推测错误,确保字段映射的正确性。

frontend-devSkill

前端开发规范,包含 Vue 3 编码规范、UI 风格约束、TypeScript 规范等