SuperAPI AI 工具集

init-context

办公与效率

查看项目

更新于 10-15 21:12

技能介绍

用途:为项目安装 manifest-dev 所依赖的工作面,让每次会话和每位协作者(无论是否使用 manifest-dev)都基于同一方向、同一词汇和同一决策记录工作。安装分两部分,只有第一部分是必需的。

接线(必装):项目自有的 ADR 约定文件、术语表、北极星(项目长期战略面:面向谁、承诺什么、何为成功),以及项目上下文文件中的一节,使会话读取并维护这三者。任何项目都可运行,包括毫无历史的新项目。

种子(可选):从项目自身历史重建词汇与决策记录,仅在存在可读历史时运行,是接线的补充而非替代。目标是好的起点而非完整记录;项目多数过往推理已不可恢复,诚实说明未能恢复的内容比看似完整更有价值。

标志:--no-mine 跳过种子,仅安装接线。只把顶层选项当作标志;被引号或代码格式包裹的提及视为正文。

已存在者优先:写前先读,绝不覆盖项目已维护的工作面。docs/adr/CONVENTIONS.md 存在则其约定优先,不替换,本次写入遵循它,再按“先比较后提议”处理。CONTEXT.md(或根 CONTEXT-MAP.md 指定的上下文)存在则加载,挖掘出的词汇作为补充提议而非替换。NORTH_STAR.md 存在则加载,种子内容作为补充或证据提议,绝不重写。docs/adr/ 有记录但无 CONVENTIONS.md 时,从记录推断未成文约定并据此编写,而非套用默认。上下文文件已含部分接线时,只补缺失部分。

先比较后提议:本技能生成的约定文件是项目自有的副本,不会被覆盖,因此成为后续改进无法自动到达的分叉。重跑时逐面比较项目副本与本技能当前配方会生成的内容(步骤 2、3、5),按节按义比较而非逐行;差异以“当前默认如此”呈现,逐项由用户接受或拒绝,不视为缺陷或过时,也不打包一次性接受。只写入用户接受的内容。

运行流程:解析项目上下文文件(名称因 CLI 而异,如 CLAUDE.md、AGENTS.md,需检测而非假设);安装 ADR 约定(除非已存在),复制 ADR_FORMAT.md 到 docs/adr/CONVENTIONS.md 并仅改开头;安装北极星(除非已存在),按 NORTH_STAR_FORMAT.md 写 NORTH_STAR.md,只播种仓库产物可证的内容,未答字段留空并注明填充条件;--no-mine 时写空骨架;同时生成 docs/NORTH_STAR_CONVENTIONS.md(除非已存在);除非 --no-mine,加载 MINING.md 执行种子;接线项目上下文文件,按模板适配,不重复已有节,不添加多余内容。最后报告安装、比较与播种结果。

空输入:对无提交、无文档、无代码的仓库,安装接线后停止,说明无内容可播种;这是成功的绿地场景。无项目名或用途时需询问。

注意:术语表每次会话都被读取,应刻意少产;丰富历史并非常态;重建推理是失败模式,记录决策而不编造理由;不要在上下文文件中复述约定细节。