跳到正文
cccskills
免费在 GitHub 公开

spec-design

Guides interactive module design via Q&A before writing. Use when the user wants to design a module, class, or feature together, or when they say "/spec-design".

中文简介正在准备中。当前显示原文说明。

查看安装方法

包含的文件(1)

  • SKILL.md2.5 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Spec Design

Guides a collaborative, question-first design process. Do not write design docs until ambiguities are clarified.

Process

Phase 1: Clarify First (Required)

Always start with clarifying questions. Do not propose a design or write a doc until the user answers.

Read relevant code (e.g. docs/overview.md, related src/ modules, config) to ground your questions. Then ask questions in categories below.

Phase 2: Question Categories

Ask 1–2 questions per category as needed. Adapt to context; not all apply.

CategoryExamples
Path / terminology"You said directory—do you mean file? resolveX() returns a file path."
Data flow"Where does X come from—caller, config, or generated internally?"
Responsibilities"Is this a factory, a repository, or both? What does it own vs delegate?"
Semantics"Does 'resume' mean load history into context, or just set a flag?"
Concurrency"Same ID—allow multiple instances? Do we need caching?"
Error handling"File missing on resume—throw or return Result? Overwrite on create?"
Injection"Config via constructor injection or direct import?"

If something contradicts existing code or docs, ask immediately.

Phase 3: Iterate

  • Answer user answers; refine or add questions if needed
  • Proceed to writing only when the design is clear enough to implement

Phase 4: Produce

  • Write design doc to docs/designs/{module-name}.md
  • Naming: Use kebab-case from class/module name (e.g. SessionManager → session-manager.md)
  • Language: English only
  • Style: Concise. No filler. Bullets and short sentences.

Output Format

Design doc structure (adjust as needed):

# {ModuleName} Design

One-line summary.

## Dependencies
- Imports, paths, config

## API
- Method signatures and behavior

## Error Handling
- When to throw, no graceful fallback

## Concurrency / Constraints
- Single-writer, no cache, etc.

Anti-Patterns

  • Rushing to write: Asking questions and writing in the same turn
  • Assuming: Filling gaps without asking (e.g. "目录" vs "文件")
  • Over-specifying: Adding details the user did not confirm
  • Chinese in design doc: Keep design docs in English

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

amap

免费

通过脚本直连高德 Web Service API 完成地理编码、逆地理编码、IP 定位、天气、路径规划、距离测量和 POI 查询。用户要求“高德/AMap 查询”“路线规划”“地理编码”“POI 搜索”或需要用命令行脚本调用高德 API 时使用。

中文简介正在准备中。当前显示原文说明。

MagicCube/agentara5172026年5月11日 更新

Generate a beautifully designed infographic poster from an article URL or text content. Trigger when user says "article poster", "文章海报", "infographic", "信息图", "make a poster", "生成海报", "visual summary", or requests to convert an article/blog into a shareable image. NOT for generic poster design.

中文简介正在准备中。当前显示原文说明。

MagicCube/agentara5172026年5月11日 更新

bootstrap

免费

First-time onboarding for new Agentara users. Use when user says "bootstrap", "/bootstrap", "get started", "first time setup", or when memory/USER.md and memory/SOUL.md are empty/missing. Inspired by the movie Her — warm, curious, subtly brilliant. The goal is to make the user feel understood within minutes and want to keep going.

中文简介正在准备中。当前显示原文说明。

MagicCube/agentara5172026年5月11日 更新

Check current Claude usage limits (session and weekly) with ASCII progress bars. Trigger when the user asks about usage, quota, limits, rate limits, how much Claude they've used, remaining capacity, or phrases like "check usage", "usage status", "how much quota left", "am I close to the limit", "用量", "额度", "配额".

中文简介正在准备中。当前显示原文说明。

MagicCube/agentara5172026年5月11日 更新

Use this skill when the user requests to generate, create, or write professional research reports including but not limited to market analysis, consumer insights, brand analysis, financial analysis, industry research, competitive intelligence, investment due diligence, or any consulting-grade analytical report. This skill operates in two phases — (1) generating a structured analysis framework with chapter skeleton, data query requirements, and analysis logic, and (2) after data collection by other skills, producing the final consulting-grade report with structured narratives, embedded charts, and strategic insights.

中文简介正在准备中。当前显示原文说明。

MagicCube/agentara5172026年5月11日 更新

Get the current date (with day of week) and time (HH:MM:SS) in a specified timezone. Auto-trigger when needing to know current time, date, or day of week — including when guessing user's location based on schedule, answering "what time is it", "what day is it", "today is what date", or any context where accurate real-time clock data is needed. Also trigger proactively at the start of conversations to ground yourself in the current time.

中文简介正在准备中。当前显示原文说明。

MagicCube/agentara5172026年5月11日 更新

查看 MagicCube 的全部技能

报告此技能的问题