SuperAPI AI 工具集

domain-context

写作与研究

查看项目

更新于 10-15 08:31

技能介绍

用途

domain-context 用于在代码仓库本地维护持久的领域术语和合格的架构决策,避免未来的协作者重复发现本应保留的上下文。它适合在出现重复使用或含义模糊的术语、需要共享词汇表,或需要记录难以逆转的架构决策时使用。

主要能力

  • 独立工作:检查仓库说明,搜索已有的术语表、领域指南、决策日志或 ADR 约定。
  • 只阅读验证术语或决策所需的相关产物与代码。
  • 若已有合适的文档,则更新它;否则提出最小可用的 Markdown 文件及与仓库一致的位置。
  • 使用仓库的文档语言与风格书写。
  • 报告哪些内容成为持久文档、哪些内容有意保留为任务局部信息。

术语表

仅当术语持久且模糊、含义过载、属于领域特定或反复使用时才添加。每条记录应包含简洁含义、重要边界,以及仅在有用时记录别名。

应排除:实现机制、可能变动的文件路径、临时任务词汇、推测性的未来术语、对话历史。应合并重复条目,而不是创建并行定义。

仅当本地没有既有模式时,才使用 references/glossary-template.md。

ADR 阈值

仅当以下三个条件全部满足时才创建 ADR:

  1. 该决策逆转成本高或风险大;
  2. 缺少其背景时结果会令人意外;
  3. 确实考虑过真正的替代方案。

若任一条件不满足,则在任务、规格、代码注释或现有设计说明中记录简短理由。绝不要把常规选择夸大为 ADR。

对于合格的 ADR,记录背景、决策、重要替代方案、后果和状态。描述持久的约束与理由,而不是按时间顺序的聊天记录。仅当仓库没有 ADR 格式时,才使用 references/adr-template.md。

使用方式

该技能不要求其他技能、docs/ 目录、跟踪器或工作流阶段。聊天可以提供证据,但理解或评审结果所需的事实必须出现在文档产物中。

配套技能

当外部证据很重要时,使用已安装的研究技能。当利益相关者术语或决策权衡需要持续澄清时,使用 grilling。这些配套名称指向 mattpocock/skills;可用以下命令安装其中一个:

npx skills add mattpocock/skills --skill <name>

此处不重复那些协议。

限制

资料未提供关于收费、价格、平台支持范围或具体效果的信息。