SuperAPI AI 工具集

setup-project-context

智能体与模型

查看项目

更新于 10-15 19:58

技能介绍

用途:为工程插件的钩子准备每个项目的配置文件 .claude/project-context.json。SessionStart 会从项目根读取该文件,并把 <project-context> 块(已注册项目的绝对路径与 openspec 文档目录)注入 Claude 上下文。

主要能力与用法:先检查当前项目是否已有 .claude/project-context.json。若存在,显示其路径与内容,提示用户手动编辑,改动在下次会话启动时生效。若不存在,则按模板创建,模板字段包括 roleBasedDelegation、openspecPath、postToolFormatCommands 和 projects(含 name、path、summary、postToolFormatCommands),需把占位路径替换为真实绝对路径。

字段说明:roleBasedDelegation、openspecPath、postToolFormatCommands、projects 均为可选,省略则相关钩子跳过该部分;文件缺失则不注入任何内容。openspecPath 可留空或指向不存在的目录,钩子会自动解析为工作目录下的 openspec(<project-root>/openspec),之后可用 set-openspec-path 技能切换。roleBasedDelegation 设为 true 会在会话启动时注入角色委派标准(何时及向 code-explore、implementer、heavy-implementer、test-runner 子代理委派)。

目标仓库指引:PreToolUse 钩子(inject-target-rules.mjs)在你读取/编辑/写入已注册项目下的文件时,惰性注入该仓库根指令文件(CLAUDE.md,无则 AGENTS.md)全文,每会话一次,并注入路径匹配的 .claude/rules/*.md;当前工作目录下的文件不注入(其指引原生加载)。

postToolFormatCommands:可全局或写在 projects[] 条目内,项目级覆盖全局默认。钩子在 Claude 对已注册目标项目(当前工作目录之外)的文件执行 Edit/Write 后,按顺序在匹配项目根运行各 shell 命令,失败以 systemMessage 报告且不阻塞主流程。

限制:路径须用当前环境的绝对路径,Windows 与 WSL 形式不同(C:/repos/... 与 /mnt/c/repos/...),同一仓库在两环境运行时取值须与启动环境一致。新上下文在下次会话启动时注入,/reload-plugins 不会重跑 SessionStart,需新开会话或 /clear。输出时若文件已存在,以 json 代码块显示路径与内容;若已创建,说明创建路径并展示 JSON 模板;最后附简短提醒,涵盖可选字段、下次会话生效及 postToolFormatCommands 的用途。