用途：按分类向规范库追加一条规范条目，供工作流智能体（analyze、plan、execute）后续检索与复用。用法：$spec-add "coding Always use named exports for utility functions"。输入格式为 <category> <title> <content>，第一个词为分类，第二个为简短标题（多词需加引号），其余为正文。
主要能力：分类到文件的映射为 coding→coding-conventions.md、arch→architecture-constraints.md、quality→quality-rules.md、debug→debug-notes.md、test→test-conventions.md、review→review-standards.md、learning→learnings.md、tools→tools.md、ui→ui-conventions.md；扩展类型 bug 存入 learnings.md，pattern 存入 coding-conventions.md，decision 存入 architecture-constraints.md，rule 与 validation 存入 quality-rules.md。自动从正文提取 3-5 个小写、连字符分隔的关键词；以 <spec-entry> 闭合标签格式追加条目，标签含 category、keywords、date、title、description 属性。
命令行替代：maestro spec add <category> "<title>" "<content>" --keywords kw1,kw2 --description "<desc>" --source <src>。
限制与门禁：写入目标仅限 .workflow/specs/，不得修改源码或其他路径；E001 缺参数、E002 未初始化、E003 非法分类会阻塞；写入前需经确认，拒绝则中止。支持的分类为 coding、arch、quality、debug、test、review、learning、tools、bug、pattern、decision、rule、validation、ui。