用途:该技能为编码智能体提供预生成的项目知识,帮助更快理解项目并更高效地工作。适用于在本项目中开始新编码会话、需要理解设计原因、或用户询问项目架构、设计决策与约束时。纯机械操作(重命名、格式化)或已有足够上下文时不应激活。
主要能力:按稳定性将知识分为四层。Tier 0为PROJECT-ESSENCE.md,稳定性高,季度或大版本更新;Tier 1为ARCHITECTURE.md,每月或每个迭代更新;Tier 2为DECISIONS.md,随决策变化更新;Tier 3为DYNAMICS.md,动态更新,涉及问题、事件等。
使用方式:推荐阅读顺序为PROJECT-ESSENCE.md、ARCHITECTURE.md、DECISIONS.md、DYNAMICS.md。会话开始协议:始终阅读PROJECT-ESSENCE.md,扫描DYNAMICS.md中的活跃问题,跨子项目工作时阅读ARCHITECTURE.md,然后进行动态代码探索。遇到意外行为或错误参考DYNAMICS.md,规划结构变更参考references/DECISIONS.md,需要高层概览参考references/PROJECT-ESSENCE.md,需要组件关系参考references/ARCHITECTURE.md。
该知识应与实际代码验证,使用grep和find_path定位真实实现。更改既定模式前检查DECISIONS.md,新决策实施后需记录。更新规则:项目目的或范围根本变化、新增主要能力、核心用户流程变化时更新PROJECT-ESSENCE.md;新增组件、职责转移、数据流或API契约变化时更新ARCHITECTURE.md;新设计决策、重新审视已有决策、权衡结果变化时更新DECISIONS.md;发现阻碍正常流程的新问题、找到变通方法、问题解决、临时约束增删时更新DYNAMICS.md。
限制与原则:知识是指南而非真理,必须对照实际代码验证;过时知识比没有知识更糟;保持高层级,细节属于代码注释;信任动态探索。该技能与项目根目录的AGENTS.md互补:AGENTS.md由维护者编写,说明如何工作;.ai-context/为系统或自动生成,说明项目是什么。两者都应在会话开始时阅读。本技能由ai-context-generator技能生成。具体安装命令、平台支持与收费信息暂未提供。