SuperAPI AI 工具集

pcr-setup

智能体与模型

查看项目

更新于 10-16 05:53

技能介绍

用途:在当前项目中采用 Project Context Records(PCR),或把已采用的项目更新为随本技能捆绑的规范版本。技能本身是快照,用户需另行更新:npx skills update pcr-setup -g。方法论见 https://github.com/hyfdev/project-context-records。

主要能力与用法:直接用文件工具完成少量可靠编辑,无需脚本。步骤为:定位项目根(git 根,否则当前目录);确保记录文件夹存在,默认为 .agents/docs/,用户指定其他文件夹则用之;选择代理指令文件,AGENTS.md 与 CLAUDE.md 同时存在时用 AGENTS.md,仅 CLAUDE.md 存在则用之,都不存在则创建 AGENTS.md;随后准备并注入带 <!-- PCR:START --> 与 <!-- PCR:END --> 标记的规范区块。标记对缺失、重复、顺序颠倒,或标记区域内存在其他生成/第三方标记时,应停止并报告,不编辑文件。旧版无标记区块需先区分项目专有内容与旧规范措辞,无法明确区分时停止并请用户确认,项目专有文本保留原措辞并移到标记外。无区块时在文件末尾追加,前面留一空行。

记录协调与播种:若记录文件夹已有记录,旧 starter 名 goal.md 现为 intent.md,可提议重命名并同步 map 路由与链接,两者并存时提示重叠。尚无记录时可提议播种。绿地仓库播种方向性内容(intent.md 与 architecture.md),已有代码库从 README、清单、配置、git 历史中取证据,只补空缺,已有文档则登记而非复制;机器可校验约束留给类型、测试、lint 或 CI。提案主题包括 intent.md、technology-stack.md、architecture.md、gotchas.md、DESIGN.md。DESIGN.md 仅用于有视觉界面的项目,遵循 https://github.com/google-labs-code/design.md,可建议将 linter 接入项目检查,例如 npx @google/design.md lint .agents/docs/DESIGN.md。

决策台账:需用户声明某领域记录决策后才建立,位于 <area>-decisions.md,与领域衍生文档相邻,否则放记录文件夹,并确保 map 恰好路由一次;已有旧台账不覆盖、不重构,可提议迁移。

结论与限制:完成后用一两行说明改动。记录位于指定文件夹,人类可用 [VOUCHED @<handle> YYYY-MM-DD] 明确认可一行、一节或整个文件;播种的记录为未盖章草稿,待审阅。收费、价格、平台、效果等资料未提供。