用途
consult-mytech 用于在编码任务中参考 mytech 的技术偏好,或评估某个项目与 mytech 偏好的一致程度。它把 mytech 作为偏好来源,把使用方项目作为需求与实现证据来源。该技能仅支持显式调用。
主要能力
- 定位 mytech 指引:可通过用户指定、项目说明或 MYTECH_ROOT 找到 mytech 检出;否则检查已知工作区位置和已有仓库缓存中 Git 远程匹配的检出。技能安装目录不假定位于 mytech 内。
- 读取相关决策:从 mytech 的 README.md 开始,沿其指引索引找到与当前决策相关的文档,必要时再检查项目证据以判断适用性;索引无法解决主题时进行窄范围搜索,不加载整个仓库。
- 检查并应用偏好:将每条相关偏好与具体项目证据对比,区分一致、可操作差距、合理偏离和证据不足。若没有已接受的指引覆盖某项决策,会明确说明,而不是编造 mytech 偏好。
- 处理冲突与偏离:项目需求和本地说明优先;偏好可用于打破平局,但本身不足以支撑重写或技术栈迁移。在获得编辑授权时,将有意偏离记录在使用方项目的决策文档中;仅评估任务则报告理由和拟议文档。
- 完成咨询:给出简洁结果,包括检查的 mytech 来源与范围、相关归属文档链接、重大差距、合理偏离和未知项及项目证据,以及在授权实施时所做的更改与验证。
使用方式
该技能需要读取使用方项目和 mytech 仓库。若没有可用检出,则通过可用的 Git 或仓库 API 按环境的外部仓库约定读取,并使用一致修订。若访问失败或来源不明确,报告缺失来源并只询问能解决该问题的信息;继续独立项目工作,但不声称完成了偏好检查。检查本地检出时按现状进行,包括相关未提交指引,记录来源位置、可用修订以及被查阅文件是否有本地更改;不为了读取偏好而更新、重置或切换检出。本地读取不能确立相对远程的新鲜度。
适用场景
适用于需要依据 mytech 技术偏好指导编码任务,或评估项目与 mytech 偏好一致性的场景。聚焦任务对应聚焦检查;明确的项目评估则覆盖其重大决策。
限制
咨询不会扩大底层任务的权限。对于建议或评审,报告评估结果;当已请求实施时,在相关工作中使用适用偏好,保留无关更改,并执行项目对已更改行为的检查。不得把聚焦任务变成仓库范围的整改,也不得作为咨询副作用编辑 mytech。完成条件是范围内决策得到受检指引和项目证据支持的处置;需说明覆盖范围限制,不得暗示聚焦检查认证了整个项目。