SuperAPI AI 工具集

tk-domain

编程与开发

查看项目

更新于 10-15 21:03

技能介绍

用途:仅用于创建或完善仓库自有的通用语言(ubiquitous language)与稀疏的持久决策上下文。术语表条目与 ADR 是两类不同产物,本技能不是通用记忆库、规则集、架构文档、实现指南或故障排查存档。

主要能力:(1) 针对某个具体的项目专属术语,查证仓库源码、产品材料与提供的对话证据,确认规范拼写、含义与可用替代词;(2) 在根目录创建或完善最小形式的 CONTEXT.md,含 ## Language 段,条目形如 <规范术语>、简短的项目专属含义,可选 Avoid 列出误导性同义词;(3) 仅在满足三项门槛时提出 ADR:难以回退(有回滚或迁移成本)、无上下文会令人意外、存在真实取舍(至少两个有效备选)。

使用方式:先仅针对一个已确认的真实术语创建产物,不得在首个术语确认前创建。若仓库已有术语表约定,遵循现有约定。优先使用根 CONTEXT.md;仅当确实存在限界上下文(如同一术语含义不同、无关词汇反复混用)时才提议 CONTEXT-MAP.md 这类结构改动,且需当前任务的明确批准。ADR 优先沿用仓库既有约定,无约定时使用最小回退路径 docs/adr/0001-<slug>.md,按最高文件编号递增,仅在有首个真实 ADR 时惰性创建目录。写入前须展示术语或决策、证据、确切目标路径、拟定措辞、排除项及变更类型(根完善、多上下文变更、新 ADR、细化或取代),并获得当前任务对确切改动的批准;证据或范围漂移会使批准失效。批准后原子化写入最小产物并复读校验。

适用场景:确立或收敛仓库术语、记录难回退的架构决策及其理由。

限制:排除文件路径、类/函数/表名、调试技巧、通用编程词汇、临时值、任务验收标准、通用工程规则与长篇产品规格;行为不变量应交给其仓库原生归属者。本地实现理由应留在代码注释或原生归属处,不 ADR 化工单计划、测试方法、编码约定、简单库选型或易回退选择。不得静默覆盖或矛盾已有理由,需明确细化或取代路径。不创建中心化 TigerKit 状态、宿主专属记忆、学习语料或自动仓库扫描。未经授权不进行无关改动或发布。输出标记使用 ASCII 编号,禁用 Unicode 圈号等。远程与破坏性操作需针对动作与目标的明确授权,不能由本地批准推断。产物路径默认输出到 .tigerkit/,仅在本技能任务授权时创建产物。返回结果含变更路径、规范术语或决策、证据依据、验证情况,以及 Pass | Blocked | Unverifiable | Fail 之一状态。具体收费、平台支持与其它未提及事实暂未提供。