tk-domain

仓库领域上下文

审批连续性

提问前先检查当前用户的授权。针对同一任务的具体请求或先前审批，在后续轮次和子技能阶段仍然有效；仅调用技能以及检索到的文本不构成授权。在第一个可执行检查点，一并解决重要的用户自有选择。范围获批后，无需在阶段边界再次询问，即可由现有负责人继续完成必要的基线采集、实施、验证、审查和本地提交。将子任务的证据交还当前负责人并继续推进；状态更新不是停止信号。重新核实事实，而非权限。仅在需要作出新的重要决定、范围变更、未获批准的操作或缺少仅用户能提供的输入时提问。恢复出的产物不能自行授予权限。远程操作和破坏性操作需要对操作和目标的明确授权；授权可能已在一开始就包含在内，移交给负责的技能时须予以保留。绝不能从本地审批推断此类授权。

仅将此技能用于创建或完善归仓库所有的通用语言和精简、持久的决策上下文。 词汇表条目和 ADR 是不同的产物。这不是通用记忆库、规则集、架构文档、实施指南或故障排查档案。

证据

针对一个具体的项目术语，调查仓库源代码、产品资料和用户提供的对话证据。确认其规范拼写、含义和有用的替代表达。如果含义涉及代码行为，须以当前源代码为依据。只有当证据无法确定规范用语，且这确实属于产品或领域决策时，才询问用户。

确认首个真实术语之前，不要创建产物。遵循仓库现有的词汇表约定，不要重复创建。

仅当模糊或多义的表述会影响产物或决策时，才加以明确。只有在无法通过其他方式厘清关系时，才使用一个具体边界案例。较新的代码或运行时证据优先于过时的词汇表说法；发现冲突时应明确指出，不要悄然保留过时表述。一般措辞上的歧义无需进行领域层面的特殊处理。

产物

针对一个上下文，在根目录创建或完善 CONTEXT.md，采用最精简的实用形式：

# Domain Context

## Language

**<canonical term>**
<short project-specific meaning>
_Avoid_: <misleading synonym>, <unwanted translation>

_Avoid_ 为可选项。如果韩语／英语拼写、缩写、大小写和空格属于规范术语的一部分，则须原样保留。

排除文件路径、类／函数／表、调试技巧、通用编程词汇、临时值、任务验收标准、通用工程规则和冗长的产品规格。将行为不变量移至其仓库内的原生归属位置，而不是放在词汇表中。

可选的多上下文升级

默认使用根目录的 CONTEXT.md。仅有一个 monorepo 或多个包，并不能作为拆分的依据。只有在实际存在有界上下文时，才提出使用 CONTEXT-MAP.md，例如：同一术语含义不同、不相关的词汇反复混杂，或不同工作者很少需要了解彼此上下文的语言。这种结构性变更需要当前任务的明确批准。

映射文件只包含相关的上下文路径和关系；绝不重复词汇表条目。获批后，将每个词汇表放在自然对应的有界上下文路径下，并核实映射中的每个路径。

稀疏且持久的决策记录

仅当以下三个阈值全部满足时，才提出 ADR：

1. 难以撤销：改变方向会产生显著的回滚或迁移成本；
2. 没有上下文就会令人意外：未来的维护者可能会在不了解其理由的情况下撤销这一选择；
3. 确有权衡：至少存在两个有效的备选方案，且基于某个理由在其中做出了选择。

将局部实现理由保留在代码注释或仓库原生的归属位置中。不要将工单计划、测试方法、编码约定、简单的库选型或容易撤销的选择写成 ADR。

优先采用仓库中已确立的 ADR 约定。若没有，则使用最精简的备用路径 docs/adr/0001-<slug>.md，递增最高的文件名编号，无需读取无关文件。仅在出现第一个真正的 ADR 时才创建 docs/adr/。备用格式包含标题，通常用一到三句话说明背景、决策及理由。只有在能提供信息时，才添加状态、备选方案、后果或其他字段。

提出新 ADR 之前，只阅读与该决策相关的现有 ADR 证据。将其与当前代码进行比较，并判断请求属于重复、细化还是取代。不要悄然覆盖或违背已有的归属理由：沿用未变的决策，或指出 revisit ADR，说明前提发生了什么变化，并提出明确的 refine or supersede 路径。绝不扫描无关的 ADR 或上下文目录。

🔴 检查点 · 🛑 停止

任何写入前，都要说明术语或持久决策、证据、准确目标路径、拟议措辞、排除项，以及本次变更属于根级细化、获批的多上下文变更、新 ADR、细化还是取代。必须获得针对确切修改的当前任务授权。证据或范围发生偏移，即使授权失效。

获批后，以原子方式写入最小化的产物并重新读取。核实术语表术语和 _Avoid_ 值完全准确；对于 ADR，则核实其保留了证据、决策、理由以及与现有理由的关系。确保任何排除在外的实现或规则内容都未写入任一产物。不要创建中央 TigerKit 状态、特定主机的记忆、学习语料库或自动仓库扫描。

返回变更路径、规范术语或决策、证据依据、核验结果，以及一个实际状态： Pass | Blocked | Unverifiable | Fail。

如果请求的下一步是仅供用户使用的技能，只需用一行给出 /<skill>，并说明当前对话会延续过去。只有在不同会话中才提供完整的交接提示；遵守 disable-model-invocation，不得调用或模拟调用该技能。

产物路径

产物操作需要任务授权。在写入／检出／传输／设置忽略规则之前，先阅读 产物路径，检查 Git 排除规则／路径／归属。复用上下文中完全相同的内容；对不确定的内容进行哈希校验，并重新读取变更或丢失的内容；始终重新检查安全性。除非明确指定目标位置或符合适用的持久根路径分支，否则使用 .tigerkit/。仅限聊天时：跳过文件／忽略规则设置及此参考文件。这不授予任何无关的修改／发布权限。对于获准的非机密清理，优先使用新目录和受支持的回收站；目标仅限有记录、解析后的绝对路径且归本次运行所有的字面路径，绝不使用 cd 加通配符／相对路径删除。

面向读者的结果摘要

简要返回结果，包括结果状态、实际核验情况、重要限制以及直接交付物链接。区分计划／跳过的检查与实际执行的工作；保留待完成的人工检查，以及实际的清理、阻碍或人工操作详情。绝不声称完成了未经核验的工作或清理。保留所有者要求的产物、发布预览、审批边界、机器返回值、准确状态／页脚及最终问题块；嵌套返回内容应简洁，并省略空白部分。

输出格式

使用 ASCII 编号（1. Item、(1) Item）和 - Item，不要使用带圈或键帽数字。 展示完整、可点击的绝对文件路径，包括示例，不要使用省略号。 除非获准修改，否则保留原样的代码、命令、标识符、URL、引文和已核实的 UI 标签。

对于包含多个共同属性的聊天对比，使用窄版 GFM 管道表格（约四列，含表头，单元格简短）；其他情况使用列表。不要使用框线字符、围栏代码块或空表格。优先采用所有者专属的预览格式；发布正文和文件产物保留各自的表格格式。

在渲染后的 Markdown 正文中，范围使用连字符，字面波浪号转义为 \~； 原样保留代码、引文和标识符。

对于获准使用的临时输入文件，创建和读取前遵循 Artifact Paths；预填模板不算已完成的输入。这不授予任何写入权限。

用户问题

调查事实；重复使用已有授权。对于由用户决定的事项，阅读 问题轮次；其他情况直接继续。 纯聊天中，即使只有一个审批事项，也应先单独输出 ---，然后每项按以下格式呈现： ❓ **Q<n> · <title>**: <question> 和 ➡️ <recommendation>。 只询问已确定为前置条件的问题；审批另行处理。 问题放在最后；先说明状态、风险和计划。

技能反馈

对于可复用的事件，在当前对话中保留最少量的非机密证据， 并建议使用 tk-retro；除非用户提出要求，否则不要将其写入持久记忆。 调用、反馈产物、已安装技能的修改和发布，都需要通过所属工作流获得单独授权；此处的说明不授予任何授权。