spec

A command that requires a staged software-planning process for new features and complex changes. The process covers requirements, acceptance checks, technical design, task breakdown, confirmation, and implementation.

In plain words
What is it for?
Use it for new features, complex architecture, multi-module work, database or interface design, and projects that need detailed written specifications.
Why use it?
It turns an unclear request into agreed requirements and an implementation plan before development begins.

Command

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/tencentcloudbase/cloudbase-ai-toolkit/spec
Clone the repo
git clone --depth 1 https://github.com/TencentCloudBase/CloudBase-AI-Toolkit
Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 681 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.00681
Opus 5 $0.00000 $0.00341
Sonnet 5 $0.00000 $0.00136
Haiku 4.5 $0.00000 $0.00068

Measured yesterday against content hash 814edc7ca59f, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

spec scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

config/source/editor-config/claude/commands/spec.md · 63 lines

What it actually says

/spec - 强制使用完整 spec 流程

命令说明

强制使用完整 spec 流程进行开发,适用于新功能开发、复杂架构设计、多模块集成、涉及数据库/UI设计等场景。

工作流程

0. 重要提醒

请注意!必须遵守以下的规则,每个环节完成后都需要由我进行确认后才可进行下一个环节;

1. 需求澄清

如果你判断我的输入提出的是一个新需求,可以按照下面的标准软件工程的方式独立开展工作,需要时才向我询问,可以采用 interactiveDialog 工具来收集

2. 需求分析

每当我输入新的需求的时候,为了规范需求质量和验收标准,必须首先会搞清楚问题和需求,然后再进入下一阶段

3. 需求文档和验收标准设计

首先完成需求的设计,按照 EARS 简易需求语法方法来描述,如果你判断需求涉及到前端页面,需要在需求中提前确定好设计风格和配色,必须跟我进行确认需求细节,最终确认清楚后,需求定稿,然后再进入下一阶段,保存在 specs/spec_name/requirements.md 中,参考格式如下

# 需求文档

## 介绍

需求描述

## 需求

### 需求 1 - 需求名称

**用户故事:** 用户故事内容

#### 验收标准

1. 采用 ERAS 描述的子句 While <可选前置条件>, when <可选触发器>, the <系统名称> shall <系统响应>,例如 When 选择"静音"时,笔记本电脑应当抑制所有音频输出。
2. ...
...

4. 技术方案设计

在完成需求的设计之后,你会根据当前的技术架构和前面确认好的需求,进行需求的技术方案设计,精简但是能够准确的描述技术的架构(例如架构、技术栈、技术选型、数据库/接口设计、测试策略、安全性),必要时可以用 mermaid 来绘图,必须跟我确认清楚后,保存在 specs/spec_name/design.md 中,然后再进入下一阶段

5. 任务拆分

在完成技术方案设计后,你会根据需求文档和技术方案,细化具体要做的事情,必须跟我确认清楚后,保存在specs/spec_name/tasks.md 中, 然后再进入下一阶段,开始正式执行任务,同时需要及时更新任务的状态,执行的时候尽可能独立自主运行,保证效率和质量

任务参考格式如下

# 实施计划

- [ ] 1. 任务信息
  - 具体要做的事情
  - ...
  - _需求: 相关的需求点的编号

适用场景

  • 新功能开发
  • 复杂架构设计
  • 多模块集成
  • 涉及数据库/UI设计
  • 需要详细规划和文档的项目
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 63 lines · 0 tokens per session scan A 814edc7ca59f

Subscribe to this mod's changes

spec is a command published in the GitHub repository TencentCloudBase/CloudBase-AI-Toolkit (1,087 stars, last pushed yesterday), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 681 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.