SuperAPI AI 工具集

specsfy-aux-database

数据与分析

查看项目

更新于 10-15 09:22

技能介绍

用途

specsfy-aux-database 是一个用于维护数据持久化地图的辅助技能。它的目标是在 .specsfy/DATABASE.md 中持续记录并保持项目持久化层的完整文档,包括以表格形式盘点的数据库、schema、表、字段和关系。

主要能力

  • 读取并维护 .specsfy/DATABASE.md,保留 specsfy:database 块之外的全部内容。
  • 检查 schema、迁移、持久化模型和配置,记录盘点信息而不泄露环境值或凭据。
  • 运行 node scripts/update_database.mjs --project <根目录> 来更新文档。
  • 将检测到的盘点结果与可执行来源核对。
  • 补全无法安全推断的关系、索引、约束、归属、保留策略和用途;对未知项进行标记,而不是编造。
  • 当 $specsfy-data-discovery 记录了已确认的回答时,保留“Informações a guardar confirmadas”章节,并将其与代码揭示的内容进行对照。
  • 使用 Markdown 表格便于搜索和比较。
  • 不复制生产数据、连接字符串、密码、令牌或 .env 值。

使用方式

  1. 执行此技能前,必须在项目根目录加载 $specsfy-setup。若为自动交接,则在本次步骤前重新加载它。复用对话中已确认的根目录;若 setup 指出存在待办,则不得继续。
  2. 交互模式为“无提问”:不在此技能中提出问题。当缺少已确认的信息时,标记该字段为待处理,交由负责对话的环节处理。
  3. 读取本地指令、PROJECT.md、STACK.md 以及全部 DATABASE.md。
  4. 检查 schema、迁移、持久化模型和配置(不暴露环境值或凭据)。
  5. 执行 node scripts/update_database.mjs --project <根目录>。
  6. 将检测到的盘点结果与可执行来源核对。
  7. 补全无法安全推断的关系、索引、约束、归属、保留策略和用途;未知项标记,不编造。
  8. 保留 specsfy:database 块之外的所有内容。
  9. 只有在 DATABASE.md 反映新结构且相关测试通过后,才认为数据变更已完成。
  10. 在返回交接前,以监控模式执行 $specsfy-setup,并要求 .specsfy/DATABASE.md 不再显示为待办。

适用场景

适用于需要持续维护数据持久化文档的项目,尤其是需要以表格形式盘点数据库结构、并在数据变更时同步更新 .specsfy/DATABASE.md 的工作流。

限制

  • 不主动提问;缺失信息标记为待处理。
  • 不得复制生产数据、连接字符串、密码、令牌或 .env 值。
  • 无法安全推断的信息应标记未知,不得编造。
  • 执行前必须完成 $specsfy-setup,且根目录已确认、无待办。
  • 数据变更完整性的判定依赖 DATABASE.md 的更新与相关测试通过。
  • 更多收费、价格、平台或效果信息暂未提供。