逐日AI微信小程序
21 天手搓一个 Coding Agent
第 2 周 · D9🔒 锁定约 4 小时

项目指令文件:三层加载、导入展开与 system prompt 的合并顺序

让 Agent 一进仓库就知道规矩:实现用户级、项目级、目录级三层指令文件的发现与加载,支持文件之间的导入,定义确定的合并顺序与冲突规则,并让用户能一条命令看清最终 system prompt 是怎么拼出来的。

今日目标 0/3

登录后可以勾选并保存进度。

今日目标

  1. 能实现三层指令文件的发现与加载,并说清各层的作用域与优先级
  2. 能实现带循环检测与深度上限的导入展开
  3. 能定义可解释的合并顺序,并提供一条命令让用户看到最终结果的来源

昨天解决的是「这一次看什么」,今天解决的是「每一次都该知道什么」。读完回到页面顶部把三条目标勾掉。

小白版讲解

团队规章:新人第一天该读哪几页,谁写的算数

那个新人已经能干活了,也知道该看哪个文件了。但你有没有发现,每天早上你都在重复同样几句话:我们不写分号;测试用 node --test 跑,别用 npm test;改代码之前先跑一次确认它是红的;断言只用 node:assert/strict。

说到第五遍你就会明白,这些话不该每天说一遍——它们该写进一份规章,挂在他工位上。

mca 现在的规章只有一句写死在代码里的系统提示。要让它变成「一进仓库就知道规矩」,规章得住在文件里。而一旦规章住进文件,一个问题立刻冒出来:这份规章该由谁写?

答案是三个人都要写,而且他们说的话作用域不一样:

  • 我这个人有偏好:回答用中文,别复述我的问题。这条走到哪个仓库都成立。
  • 这个仓库有规矩:代码风格、测试怎么跑、哪些目录别碰。进这个仓库的人都该遵守。
  • 这一片代码还有特殊规矩:src/ 下面的东西改完必须立刻跑一次那条更窄的测试命令。

三份规章,三个作用域,从宽到窄。于是今天要做的事情就有了形状:三层指令文件,各自被发现,按确定的顺序合并成一段 system prompt。 顺序只有一句话——越具体的越靠后,冲突时后者赢。

这条规则听起来平淡,但它是今天全部工程量的源头。因为「后者赢」意味着前面那条要真的消失,而不是两条都留着让模型自己挑;意味着用户得有办法看到「到底是哪一条赢了」;也意味着这三份文件之间还会互相导入,而导入会带来循环、深度和越界三类麻烦。

登录并关联后阅读全文

请先登录网页,并在账户页关联微信小程序账号。关联后每天可免费阅读 1 篇;额外文章需在小程序看广告解锁。

小程序码

微信扫码打开「逐日AI」,进入相同课程和章节,选择看广告解锁,完成后刷新本页。

面试题库

  • 分层的项目指令文件,优先级怎么定?冲突时谁赢?For layered project instruction files, how do you decide precedence, and who wins on a conflict?
    国内高频海外高频基础#layered-config#system-prompt

    🔒 解锁本章后查看答题要点。

  • 指令文件支持互相导入,你会加哪些安全限制?If instruction files can import one another, what safety limits would you add?
    国内高频海外高频进阶#imports#safety-limits

    🔒 解锁本章后查看答题要点。

  • 怎么让最终的 system prompt 对用户可解释?为什么这件事值得做?How do you make the final system prompt explainable to the user, and why is that worth doing?
    国内高频海外高频深入#observability#prompt-assembly

    🔒 解锁本章后查看答题要点。

评论