项目规划 307.9k 仓库 Star
To Spec
把讨论整理成可实现的规格
To Spec 是把已有讨论转成需求规格的 Skill。它结合当前代码和已经作出的决定,整理用户遇到的问题、解决方式、用户故事、实现与测试决策,并明确范围之外的内容。适合讨论已较充分、准备把需求交给开发或保存到项目任务系统的阶段。
你需要准备:已讨论的需求、项目代码和约束,以及规格文档的保存位置
一桉AI 整理 · 更新 · 查看 GitHub 来源
粘贴到 Codex,它会先检查安装条件,再引导你使用。
To Spec 能帮你做什么?
提炼已有共识
从当前讨论和代码中整理需求,沿用项目术语及已有架构决定,减少重新描述背景。
补齐规格结构
按问题、方案、用户故事、实现与测试决定组织内容,让执行者知道功能应具备哪些行为。
对接任务系统
依据项目配置整理可保存的规格;写入 GitHub、Linear 等系统时使用对应连接和权限。
什么时候适合用?
下面是用法示例,可换成你的材料和目标。
把功能讨论交给开发
例如讨论完会员续费提醒后,整理触发条件、提醒对象、失败情况和验收边界。
整理已有原型的决策
例如从界面原型和讨论中记录状态规则、字段含义与已排除的方案,供后续实现参照。
怎么开始使用?
需求讨论与项目约束
准备这些材料需求规格整理
已讨论的需求、项目代码和约束,以及规格文档的保存位置
规格整理流程
- 01
核对讨论与项目现状
- 02
整理需求与实现决策
- 03
交付规格和待确认项
准备什么,会得到什么?
- 准备的材料
- 已讨论的需求、项目代码和约束,以及规格文档的保存位置
- 交付的结果
- 包含问题、方案、用户故事、实现与测试决定的规格文档。
- 明确的范围之外事项,以及仍缺少依据或需要确认的信息。
使用前要知道
需要已形成的需求背景和完整 Matt 插件设置、关联 helper。它以整理已有讨论为主;未配置任务系统或未获得写入权限时,不能声称已经发布任务。
常见问题
会从头访谈我来找需求吗?
这一项主要综合当前会话已有的信息。背景不足时应先补需求讨论,避免把空白直接补成未经确认的业务规则。
规格里会写死所有代码文件吗?
上游重点保存模块、接口和实现决策,尽量减少容易过时的代码细节。具体文件和执行步骤可在实施计划中继续展开。
GitHub 与官方参考
依据项目说明与参考文档整理。页面中的任务与流程示例用于说明用法。
- to-spec · SKILL.md ↗2026-10-31 核对
- Skills For Real Engineers · Codex 安装与项目说明 ↗2026-10-31 核对
来源与使用条件
- 原始项目
- mattpocock/skills ↗
- Skill 名称
to-spec- Skill 目录
skills/engineering/to-spec- 仓库 Star
- 307,914 · 2026-10-31 核对,仅代表仓库关注度。
- 许可说明
- MIT
- 使用条件
- 上游提供 Codex 插件安装。需完成项目设置,保留关联 helper、领域词汇和 issue tracker 配置;读取源码需要项目访问权限,写入外部任务系统还需对应连接和授权。
- 注意事项
- 原版以当前讨论为基础整理规格,并可提交到配置的任务系统。需按上游整插件检查依赖和宿主工具映射,不能仅复制单一目录就保证完整;本站未运行实测。
查看安装与使用提示词
请帮我准备并使用 To Spec Skill,完成下面的任务。请实际执行当前环境允许的安装与检查,不要只返回一份安装教程。 【来源与目标】 原始仓库:https://github.com/mattpocock/skills 所选目录:skills/engineering/to-spec 参考分支:main 原始目录 frontmatter name:to-spec 安装后的目标调用名:to-spec 来源页面:https://github.com/mattpocock/skills/tree/main/skills/engineering/to-spec 安装路线核对日期:2026-11-01 to-spec:当前源 SKILL.md:https://github.com/mattpocock/skills/blob/main/skills/engineering/to-spec/SKILL.md mattpocock/skills:当前安装说明:https://github.com/mattpocock/skills/blob/main/README.md Matt Pocock:项目初始化助手:https://github.com/mattpocock/skills/blob/main/skills/engineering/setup-matt-pocock-skills/SKILL.md Codex 显式调用策略:https://github.com/mattpocock/skills/blob/main/skills/engineering/to-spec/agents/openai.yaml 【先检查环境,再安装】 先识别操作系统、当前 shell、工作目录、同名 Skill 和已有工具;命令须适配实际平台并正确处理带空格的路径。默认安装到当前项目的 .agents/skills;如果没有可用项目目录,再使用用户目录的 .agents/skills。遵循当前 Codex 实际支持的位置;上游 CLI 或插件有专用目录时使用其正式方案。检查现有安装来源与完整性,能复用就复用,不重复注册相同来源、不覆盖用户修改。系统内置与所选第三方来源同名时保留系统版,明确区分来源和实际目录,不能只凭名称认定装过或选对了。 下文 ~/.agents/skills 是用户级路径示例;已选项目范围时,使用项目的 .agents/skills 并保持相同子目录层级。<SKILL_DIR>、<项目根目录> 等占位符须先换成核对过的真实路径再执行。依赖仓库的存放目录与 Codex 发现入口分别处理,不把缓存目录当作已注册入口。 这是插件安装路线。按下列官方入口安装完整插件;仅复制某个 Skill 目录不能代替插件、连接器或 MCP 配置。若当前 Codex 必须由用户在界面完成插件安装或授权,请给出准确入口和最短步骤,完成后再检查所选 Skill。 所选 Skill 的具体安装步骤: 1. 先检查 Codex 已安装插件与项目已有同名目录;选整插件路线,不再同时用 skills CLI 或手工复制相同条目。 2. 按当前 README 运行 codex plugin marketplace add mattpocock/skills,再运行 codex plugin add mattpocock-skills@mattpocock;保留插件管理的整个包和更新机制,不只复制该 Skill 文件。 3. 在用户选定的项目中显式调用 $setup-matt-pocock-skills(或 Skill 选择器中的同名助手),一次性确认 issue tracker、标签词汇和文档路径;可选本地文件,不要求用户先开通在线项目管理服务。 4. 安装完成先检查可发现状态;Skill 目录变化自动检测,未出现再新聊天或重载。涉及插件配置时按宿主原生提示处理。 必须保留的资源: - skills/engineering/to-spec/(整目录,含 agents/openai.yaml) - skills/engineering/setup-matt-pocock-skills/(含 domain.md、issue-tracker-github.md、issue-tracker-gitlab.md、issue-tracker-local.md、triage-labels.md) - 完整插件中被该流程调用的其他 Skills 与项目配置;由插件管理,不散落复制 已知依赖:上游提供 Codex 插件安装。需完成项目设置,保留关联 helper、领域词汇和 issue tracker 配置;读取源码需要项目访问权限,写入外部任务系统还需对应连接和授权。 原项目许可:MIT 特别条件:原版以当前讨论为基础整理规格,并可提交到配置的任务系统。需按上游整插件检查依赖和宿主工具映射,不能仅复制单一目录就保证完整;本站未运行实测。 需要账号、密钥或服务时先检查现有可用连接;让用户在官方授权或本地配置入口完成,不要求把密钥粘贴到聊天。缺少付费服务或不支持的客户端能力时,明确剩余条件与可完成的范围。 【安装后验收】 读取实际安装位置的 SKILL.md,核对真实 name,并检查它引用的脚本、模板、共享文件与工具是否存在。若上游已迁移路径或更名,先核对正式说明再调整;找不到则报告实际错误,不猜路径或宣称成功。 1. 检查插件来源是 mattpocock/skills,相关 Skill 与 setup-matt-pocock-skills 可发现,初始化配置文件已指向该项目。 2. 检查该目录 agents/openai.yaml 的 policy.allow_implicit_invocation 为 false,并明确需要手动选择 Skill。 3. 检查当前项目 tracker/本地文档目标可读且有明确授权;安装检查不创建、发布或打标签。 Codex 通常自动发现变更;只有未出现时才引导新建聊天或重载。若本轮尚未出现在可用列表,可在允许的范围内读取已安装的完整文件继续准备任务,同时说明自动识别尚待确认。插件依赖的工具未连接时,不能用读取文件代替连接成功。 分别报告“文件已安装”“Codex 已识别”“任务所需能力已就绪”的实际状态和证据;失败时给出卡住的步骤、错误与下一步,不反复执行相同的失败命令。 【接着引导我使用】 请使用实际可用的 $to-spec;若实际名称发生变化,以刚核对的本地 name 为准。存在不同来源同名项时,明确选择所选来源与实际文件路径,避免调用成系统版或另一版本。对于必须由用户显式调用的 Skill,直接给我下一条可复制的调用语句。 - 先提供或保留已经讨论的背景、需求和决定,再显式调用 $to-spec;它整理当前对话,不负责另开一轮完整访谈。 - 首次先形成规格草稿,核对范围、验收与配置目标;只有用户已授权写入对应 tracker/本地目录时才发布并加 ready-for-agent 标签。 我想完成的任务: 根据我们已经讨论的需求和当前项目,整理一份功能规格。明确用户面对的问题、解决方式、用户故事、实现与测试决策,以及范围之外的内容;对未知项作标记。先交付可审阅的规格文本,只有在我指定目标并授权时才写入外部任务系统。 需要我提供的材料: 已讨论的需求、项目代码和约束,以及规格文档的保存位置 期望得到: 一份包含需求、决策、测试边界和待确认项的规格文档。 先查看我在当前聊天中已经提供的目标与材料,只问缺少的关键内容;没有材料时,告诉我第一步提供什么,可给一个简短示例。条件满足后从一个小任务开始,检查输出,再说明怎样继续使用。示例仅用于演示,不充当我的真实数据;没有执行过的步骤、测试或交付物不要写成已经完成。需要发送、发布或修改外部账号内容时,先让我核对具体对象和内容。