用途
domain-context 用于在代码仓库本地维护持久的领域术语和合格的架构决策,避免未来的协作者重复发现本应保留的上下文。它适合在出现重复使用或含义模糊的术语、需要共享词汇表,或需要记录难以逆转的架构决策时使用。
主要能力
- 独立工作:检查仓库说明,搜索已有的术语表、领域指南、决策日志或 ADR 约定。
- 只阅读验证术语或决策所需的相关产物与代码。
- 若已有合适的文档,则更新它;否则提出最小可用的 Markdown 文件及与仓库一致的位置。
- 使用仓库的文档语言与风格书写。
- 报告哪些内容成为持久文档、哪些内容有意保留为任务局部信息。
术语表
仅当术语持久且模糊、含义过载、属于领域特定或反复使用时才添加。每条记录应包含简洁含义、重要边界,以及仅在有用时记录别名。
应排除:实现机制、可能变动的文件路径、临时任务词汇、推测性的未来术语、对话历史。应合并重复条目,而不是创建并行定义。
仅当本地没有既有模式时,才使用 references/glossary-template.md。
ADR 阈值
仅当以下三个条件全部满足时才创建 ADR:
- 该决策逆转成本高或风险大;
- 缺少其背景时结果会令人意外;
- 确实考虑过真正的替代方案。
若任一条件不满足,则在任务、规格、代码注释或现有设计说明中记录简短理由。绝不要把常规选择夸大为 ADR。
对于合格的 ADR,记录背景、决策、重要替代方案、后果和状态。描述持久的约束与理由,而不是按时间顺序的聊天记录。仅当仓库没有 ADR 格式时,才使用 references/adr-template.md。
使用方式
该技能不要求其他技能、docs/ 目录、跟踪器或工作流阶段。聊天可以提供证据,但理解或评审结果所需的事实必须出现在文档产物中。
配套技能
当外部证据很重要时,使用已安装的研究技能。当利益相关者术语或决策权衡需要持续澄清时,使用 grilling。这些配套名称指向 mattpocock/skills;可用以下命令安装其中一个:
npx skills add mattpocock/skills --skill <name>
此处不重复那些协议。
限制
资料未提供关于收费、价格、平台支持范围或具体效果的信息。