Spec Writer
把粗糙想法加简短回答变成一份结构化规格草稿:目标、受众、范围、非目标、需求与验收标准,附 9 项完整度评分,缺项一律列为待答问题。
适用于: Claude Code, Codex, Cursor, Muse · 版本 1.0.0 · 需要: 你的简报:brief.txt(带标签的行——Title、Idea、Audience、Goal,另加 In/Out/Need/Check/Constraint 项)。
预览

示例输出
此 Skill 产出的示例。示例内容,仅供说明。
Spec Writer report — sample Completeness: 100/100 (9/9 required answers) | Gaps: 0 | Errors: 0 | Warnings: 0 Spec: BeanLoop Weekly Digest — Goal: Send one useful digest every Friday without manual assembly. Audience: Solo founders who ship weekly. In scope: Pull shipped items from the changelog; Group items by feature area. Non-goals: No social-media posting. Requirements: 3. Acceptance criteria: 2, including a short note for weeks with no shipped items. Constraint: Must run in under 5 minutes, local only. Open questions: None.
你将获得
- 结构化规格草稿:目标、受众、想法、范围、非目标、需求、验收标准、约束
- 完整度评分:9 个必备项,缺项各对应一个待答问题
- 缺失章节标为“尚未定义”——绝不编造内容填充
- 报告中列出的全部输入错误与警告
关于此 Skill
读取你写的一个纯文本文件——brief.txt,每行一个带标签的回答(Title/Idea/Audience/Goal,另加可重复的 In/Out/Need/Check/Constraint 行)——产出 spec.md:按固定顺序、用你原话写成的规格、完整度评分(9 个必备项中已填项的百分数,四舍五入)、每个缺项作为待答问题并标为“尚未定义”,以及全部输入错误与警告。纯本地运行、仅用标准库;缺项绝不编造填充——100/100 只表示简报齐全,不表示规格写得好,动手建造前仍需人工通读审阅。
试一试
把这个粗糙想法和回答变成一份结构化规格——目标、范围、非目标、需求与验收标准。
适合人群
- 在有人建错东西之前先把想法落到纸上
- 在纸面上、而非会议里议定范围与非目标
- 检查一份只答了一半的简报,确切缺什么
不适合
- 评判规格好不好——齐全不等于优质
- 批准范围或工作量——草稿不是决策
- 编造缺失回答来抬高分数
如何安装
- 把安装提示词复制到你的 Agent:
Read https://skillu.dev/install/agent.md, then install the Spec Writer skill (spec-writer). - 或在上线后从本页下载 Skill 包,把它的文件夹放入你的 Agent 的 skills 目录。
- 用斜杠命令调用它,例如
/spec-writer,然后用大白话描述你想要什么。
常见问题
完整度怎么算?
9 个必备项:Title、Idea、Audience、Goal、至少一项 In、至少一项 Out、至少一项 Need、至少一项 Check、至少一项 Constraint。分数 = 已填项 ÷ 9 × 100,四舍五入。完整简报得 100/100;只有标题加想法的简报得 22/100。
缺项怎么处理?
草稿里保留为“尚未定义”,并作为一个待答问题列出。脚本绝不会为了抬分而猜测受众、需求或约束。