用途
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 值。
使用方式
- 执行此技能前,必须在项目根目录加载 $specsfy-setup。若为自动交接,则在本次步骤前重新加载它。复用对话中已确认的根目录;若 setup 指出存在待办,则不得继续。
- 交互模式为“无提问”:不在此技能中提出问题。当缺少已确认的信息时,标记该字段为待处理,交由负责对话的环节处理。
- 读取本地指令、PROJECT.md、STACK.md 以及全部 DATABASE.md。
- 检查 schema、迁移、持久化模型和配置(不暴露环境值或凭据)。
- 执行 node scripts/update_database.mjs --project <根目录>。
- 将检测到的盘点结果与可执行来源核对。
- 补全无法安全推断的关系、索引、约束、归属、保留策略和用途;未知项标记,不编造。
- 保留 specsfy:database 块之外的所有内容。
- 只有在 DATABASE.md 反映新结构且相关测试通过后,才认为数据变更已完成。
- 在返回交接前,以监控模式执行 $specsfy-setup,并要求 .specsfy/DATABASE.md 不再显示为待办。
适用场景
适用于需要持续维护数据持久化文档的项目,尤其是需要以表格形式盘点数据库结构、并在数据变更时同步更新 .specsfy/DATABASE.md 的工作流。
限制
- 不主动提问;缺失信息标记为待处理。
- 不得复制生产数据、连接字符串、密码、令牌或 .env 值。
- 无法安全推断的信息应标记未知,不得编造。
- 执行前必须完成 $specsfy-setup,且根目录已确认、无待办。
- 数据变更完整性的判定依赖 DATABASE.md 的更新与相关测试通过。
- 更多收费、价格、平台或效果信息暂未提供。