SuperAPI AI 工具集

dokumentera

写作与研究

查看项目

更新于 10-15 23:31

技能介绍

用途:DOKUMENTERA 是 DTC 套件中的文档层(“D”),负责在代码存在前编写意图文档、为已有代码生成文档、随项目演进维护文档,并对照实现验证文档。

主要能力:提供创建与更新两种模式,按上下文自动判断:功能尚不存在时采用意图优先(对话式);代码已存在但无文档时探索并生成;文档可能过时时进行审计驱动的更新与验证;也可执行完整审计。首次运行会先做约定调查,生成三层 DOCS.md(约定、产物映射、索引)。

使用方式:读取或写入任何产物前,先检查 .agentera/DOCS.md 是否存在及其 Artifact Mapping;无映射时使用默认布局:VISION.md、TODO.md、CHANGELOG.md 位于项目根目录,其余产物在 .agentera/。开始前需阅读 references/contract.md 获取权威值。各模式按步骤标记执行,并在写入前进行自审计(最多 3 次修订,仍失败则标记 [post-audit-flagged])。

适用场景:需要先写规格再实现、为遗留代码补文档、检查文档是否与代码漂移、维护文档索引与覆盖率。

限制:绝不未经用户明确批准修改文档;绝不把文档改成与错误代码一致(按 DTC,代码偏离文档时是代码错);绝不写时间性文档;绝不跨文档重复信息;绝不写通用填充内容;更新模式绝不跳过验证步骤;绝不未读代码就自动生成文档。完成时报告 complete、flagged、stuck 或 waiting 状态。

跨技能集成:dokumentera 为 /planera 提供意图文档作为规格,为 /realisera 提供目标状态,并接收 /inspektera 的 HEALTH.md 文档缺口发现。

其余细节(如具体 token 预算、严重级别、格式契约)以 references/contract.md 为准,资料未提供完整数值。