SuperAPI AI 工具集

writing-specs

写作与研究

查看项目

更新于 10-15 17:18

技能介绍

用途:writing-specs 用于为功能创建规格说明(Spec),定义“做什么、为什么”,而非实现计划或任务拆分。通常在 /spectacular:spec 命令中调用,用于从零编写新功能规格,并完成 Run ID、worktree、头脑风暴、spec 编写与校验的完整流程。不适合实现计划、API 文档或运维手册。

主要能力与流程:先检测工作区模式,多仓库模式在 workspace 根目录存储 spec 且不创建 worktree,单仓库模式生成 Run ID 并创建隔离 worktree。随后安装依赖,进入三步头脑风暴:理解目的约束与成功标准、探索2-3种架构方案、分段呈现设计并验证。之后生成 spec,引用 docs/constitutions/current/ 下的 architecture、patterns、schema-rules、tech-stack、testing 等约束,遵循“引用而非复制、链接而非嵌入代码、不做实现计划、保持精简(<300行)”的原则,并写入 frontmatter 后提交到 worktree 分支。最后执行架构质量校验,检查 constitution 合规、spec 质量、需求完整性、可测试性、边界条件、文件路径与安全等内容;失败时生成 clarifications.md,最多3轮校验,超出则升级给用户。

使用方式:由 /spectacular:spec 调用,命令形式为 /spectacular:spec {feature-description};spec 输出到单仓库的 .worktrees/{run-id}-main/specs/{run-id}-{feature-slug}/spec.md 或多仓库的 specs/{run-id}-{feature-slug}/spec.md。完成报告后停止,不自动进入 plan,需用户审阅后自行运行 /spectacular:plan。

限制:依赖项目 CLAUDE.md 中定义的安装与 postinstall 命令,缺失时需先补充;依赖 docs/constitutions/current/ 下的 constitution 文档;需要 git 与 worktree 支持。资料未说明具体收费、价格、平台支持范围、性能指标或效果数据。