
关于
审计项目并推荐最有价值的待添加或更新技能。
name: project-skill-audit description: 审计项目并推荐最有价值的技能进行添加或更新。 risk: safe source: "Dimillian/Skills (MIT)" date_added: "2026-03-25"
项目技能审计
概述
在推荐技能之前,先审计项目的真实重复工作流。优先使用来自记忆、发布摘要、现有技能文件夹和当前仓库约定的证据,而非泛泛的头脑风暴。
当现有项目技能已经接近所需行为时,优先推荐更新而非新技能。
适用场景
- 当用户询问项目需要什么技能或哪些现有技能应该更新时。
- 当推荐应基于项目历史、记忆文件和本地约定时。
工作流程
-
映射当前项目表面。 识别仓库根目录,首先阅读最相关的项目指导文件,如
AGENTS.md、README.md、路线图/账本文件,以及定义工作流或验证期望的本地文档。 -
首先构建记忆/会话路径。 将记忆基础路径解析为
$CODEX_HOME(如已设置),否则默认为~/.codex。 使用以下位置:- 记忆索引:
$CODEX_HOME/memories/MEMORY.md或~/.codex/memories/MEMORY.md - 发布摘要:
$CODEX_HOME/memories/rollout_summaries/ - 原始会话:
$CODEX_HOME/sessions/或~/.codex/sessions/
- 记忆索引:
-
按此顺序阅读项目过往会话。 如果运行时提示已包含记忆摘要,从那里开始。 然后在
MEMORY.md中搜索:- 仓库名称
- 仓库基础名
- 当前
cwd - 重要的模块或文件名 首先只打开 1-3 个最相关的发布摘要。 仅当摘要缺少所需的确切证据时,才回退到原始会话 JSONL。
-
在建议任何新内容之前扫描现有项目本地技能。 检查相对于当前仓库根目录的以下位置:
.agents/skills.codex/skillsskills同时阅读SKILL.md和agents/openai.yaml(如存在)。
-
将项目本地技能与重复工作进行比较。 在过往会话中寻找重复模式:
- 重复的验证序列
- 重复的故障防护
- 反复出现的所有权边界
- 重复的根因类别
- 反复需要相同仓库特定上下文的工作流 如果模式反复出现且尚未被很好地捕获,则为候选技能。
-
区分"新技能"和"更新现有技能"。 当现有技能已经是正确的分类但触发器过时、缺少防护栏、路径过时、验证指令薄弱或范围不完整时,推荐更新。 仅当工作流足够独特,以至于扩展现有技能会使其变得模糊或混乱时,才推荐新技能。
-
仅在审查项目本地技能之后才检查与全局技能的重叠。 使用
$CODEX_HOME/skills和$CODEX_HOME/skills/public来避免为已被通用共享技能很好解决的工作流提议项目本地技能。 不要仅因为全局技能存在就拒绝项目本地技能;项目特定的防护栏仍然可以证明本地专业化的合理性。
会话分析
1. 首先搜索记忆索引
- 使用
rg在MEMORY.md中搜索仓库名称、基础名和cwd。 - 优先选择已引用具有相同仓库路径的发布摘要的条目。
- 捕获:
- 重复的工作流
- 验证命令
- 故障防护
- 所有权边界
- 里程碑或路线图耦合
2. 打开目标发布摘要
- 打开
memories/rollout_summaries/下最相关的摘要文件。 - 优先选择文件名、
cwd或keywords与当前项目匹配的摘要。 - 提取:
- 用户反复要求的内容
- 持续重复的步骤
- 反复出现的故障
- 证明正确性的命令
- 必须重新发现的项目特定上下文
3. 仅将原始会话作为后备
- 仅当发布摘要缺少具体细节时才搜索
sessions/JSONL 文件。 - 搜索依据:
- 精确的
cwd - 仓库基础名
- 来自发布摘要的线程 ID
- 特定文件路径或命令
- 精确的
- 使用原始会话恢复确切的提示、命令序列、差异或故障文本,而非替代摘要过程。
4. 将会话证据转化为技能候选
- 候选"新技能"应对应重复的工作流,而非仅仅是重复的主题。
- 候选"技能更新"应对应已被本地技能覆盖但其触发器、防护栏或验证指令不再匹配记录会话的工作流。
- 优先使用具体证据,如:
- "此验证序列出现在 4 个会话中"
- "此所有权混淆在提取器和运行时修复中反复出现"
- "相同的本地脚本和遥测探针必须反复重新发现"
推荐规则
- 在以下情况推荐新技能:
- 相同的仓库特定工作流或故障模式反复出现
兼容工具
Claude CodeCursor
标签
AI与机器学习