SuperAPI AI 工具集

setup-project-context

智能体与模型

查看项目

更新于 10-15 22:41

技能介绍

用途:该技能在尚无 skills/internal/project-context/ 的仓库中运行一次,用于从代码中挖掘并建立项目上下文,产出 CONTRIBUTING.md、一个 /project-context 路由技能,以及每个领域一个参考文件。

前提:前提是先安装 /context-engineering,否则停止并提示用户安装;若 skills/internal/project-context/ 已存在则停止,说明上下文已存在,后续决策走 /context-engineering,/audit-project-context 保持其一致,此技能不重复运行。

主要步骤:

  1. 调查:读取 README.md、CONTRIBUTING.md、AGENTS.md、CLAUDE.md、CONTEXT.md、docs/、package.json、skills/ 与 skills-lock.json,运行 git remote -v,并阅读锁文件中列出的每个 *-landscape 技能。
  2. 挖掘:从 git log、rg -n 'TODO|HACK|FIXME|workaround|deliberately|intentionally|on purpose'、跳过的测试(.skip、xit、it.todo、test.todo)、注释代码、死标志、非默认配置、关闭的 issue 与合并的 PR(远程为 GitHub 时用 gh)等处挖掘;每个候选围栏记录 file:symbol。
  3. 提议领域:技能不自带领域列表,需读取仓库后提出领域清单并等待用户批准。
  4. 访谈:代码给出 what,所有者给出 why;逐领域进行,跳过代码已回答的问题,应用准入测试,记录被丢弃的候选,并让每个领域有一个所有者选择的置信度词。
  5. 写入:按 context-engineering 的 TEMPLATES.md 写 CONTRIBUTING.md、skills/internal/project-context/SKILL.md、glossary.md、domains/<domain>.md(每领域一个)、README.md,并为 skills-lock.json 中每个 *-landscape 在路由中加一行;将分散文档迁移而非复制,docs/adr/ 与 docs/research/ 保留原位,docs/design/ 文件按其实质归为 ADR 或领域文件。
  6. 归并:AGENTS.md/CLAUDE.md 保留行为,项目相关内容移入领域文件;编辑已存在者,加入 ## Project context 段落。
  7. 链接:请用户运行 /link-skills project-context,然后通过每个新符号链接读回 SKILL.md 确认解析。
  8. 报告:说明写了哪些领域及各自围栏数、哪些领域偏薄、丢弃了哪些围栏及原因、代码与所有者决策冲突的草稿及其 file:line、尚未被已安装 landscape 覆盖的连接、AGENTS.md 减少的行数。

限制:仅运行一次;一切以代码为草稿,需所有者确认才成为上下文;未提供收费、价格或平台信息。