SuperAPI AI 工具集

notion-spec-to-implementation

编程与开发

查看项目

更新于 10-16 03:05

技能介绍

用途:把 Notion 里的规格文档(PRD、功能规格)转化为相互关联的实施计划、任务清单和持续状态更新,适合需要按规格推进开发的场景。

主要能力:定位并读取规格页;解析需求、验收标准、约束、优先级并记录缺口与假设;创建实施计划页(简单改动用 quick 模板,多阶段功能/迁移用 standard 模板);在任务数据库中创建任务并设置属性;建立规格↔计划↔任务的关联;用页面更新保持状态同步;按节奏发布进度更新与里程碑总结。

用法要点:先以 Notion:search 定位规格,再用 Notion:fetch 读取;用 Notion:notion-create-pages 创建计划与任务(须显式提供 parent 与 pages 字段,任务数据库需先获取其 collection:// 数据源 ID);用 Notion:notion-update-page 更新内容或属性。追加实施小节时先抓取当前段落文本,再以 command: "update_content"、properties: {} 和精确的 old_str / new_str 修改;仅改属性时用 command: "update_properties" 与 content_updates: []。每次 Notion:search 只用一个字面查询并附 filters: {},替代措辞分开搜索,不要在同一查询字符串中用 or。只把 Notion 页面、数据库或数据源 URL/ID 传给 Notion:fetch。任务规模建议 1–2 天一个。

限制与异常处理:Notion 工具可用性因工作区而异;若某 MCP 调用返回 Tool <name> not found,应在当前任务内视为不可用,不要换参数重试或稍后再调,改用 Notion:search 和 Notion:fetch。若 Notion 工具不可用,需暂停并请用户启用并授权 Notion 应用,必要时新开会话后重试。参考文件(如 spec-parsing.md、task-creation.md、progress-tracking.md)与示例随插件提供。具体模板细节、定价与平台支持暂未提供。