weaver

name	weaver-自我迭代
description	Codex 跨项目知识整理与自我迭代技能。用于“全局整理、同步记忆、梳理知识、编织一下、检查跨项目规则、回顾近期工作”等请求；按全局/项目/子目录分层整理 AGENTS.md、Codex 配置、项目知识和可访问的历史线索。显式调用：$weaver-自我迭代。

编织者 · 自我迭代（Codex）

跨项目整理稳定知识、规则与经验。目标是让信息出现在正确层级，而不是把所有内容堆进一个文件。

边界

• 本技能管跨项目广度；单项目文件整理交给 $file-tidy，错误复盘交给 $debug-architect，明确的“记住/忘掉/整理记忆”交给 $memory-keeper。
• 规则文件使用 AGENTS.md：全局为 ~/.codex/AGENTS.md，项目或子目录规则为对应目录的 AGENTS.md。
• Codex 配置使用 ~/.codex/config.toml 与项目 .codex/config.toml。
• 个人技能位于 ~/.agents/skills，项目技能位于 .agents/skills；显式调用使用 $skill-name。
• 不把聊天原文、临时状态或未经验证的推测写成永久规则。
• 修改现有规则、配置、知识文件前先读取；跨项目写入或删除必须遵守用户授权与当前文件权限。

需要更细的层级判定时读取 references/layer-guide.md。

工作流

1. 确定范围与授权

1. 明确整理范围：当前项目、指定项目集合或全局。
2. 明确允许读取和修改的位置；未授权的项目只做只读分析或列入建议。
3. 首次运行或没有可靠增量标记时，询问回溯范围；用户已给出明确范围则不要重复询问。
4. 可在 CODEX_HOME 下维护技能自有的增量标记，例如 $CODEX_HOME/.last-weaver。CODEX_HOME 未设置时可将 ~/.codex 视为候选，但先验证实际路径。标记只记录时间/游标，不存对话正文。

2. 能力探测历史数据

历史记录是可选数据源，不是前置条件。

1. 解析 CODEX_HOME；未设置则探测 ~/.codex。
2. 在用户授权范围内，检查是否存在可读、看起来与 session/history 有关的文件或目录。
3. 若存在：先抽样读取并识别实际格式，再决定解析方式。只依赖观察到的字段，不假定固定文件名、目录层级或 JSONL schema。
4. 若不存在、不可读或格式不明：明确说明限制，改用以下来源：
   • 当前任务上下文；
   • 用户指定的项目与已有 AGENTS.md；
   • ~/.codex/AGENTS.md、~/.codex/config.toml、项目 .codex/config.toml；
   • Git 历史、当前 diff、提交信息；
   • 项目现有 docs、memory、wiki、错误日志和技能说明。
5. 不绕过权限、不搜索凭据、不声称已扫描无法访问的历史。

3. 提取候选信息

只保留对未来有复用价值的内容：

类别	典型信号	候选去向
跨项目硬规则	“以后所有项目都…”“禁止…”	~/.codex/AGENTS.md
项目硬规则	构建命令、目录约束、技术边界	项目 AGENTS.md
子目录规则	仅适用于某模块/子项目	最近的子目录 AGENTS.md
Codex 配置	模型、沙箱、MCP、功能开关等	对应 config.toml
稳定偏好/决策	长期协作偏好、项目决策	已有项目知识或记忆文件
通用知识	概念、规律、方法论	用户现有知识库
错误经验	已验证根因与预防措施	.codex/ERROR_LOG.md，必要时再提炼规则
过期内容	已被新决策推翻、死链、失效配置	更新/删除候选

每条候选内部记录：来源、事实、置信度、层级、建议动作、目标文件。推测必须标注为推测。

4. 分层与去重

1. 先搜索目标层已有内容，更新原条目而非重复追加。
2. 不确定时下沉一级：全局 → 项目 → 子目录。
3. AGENTS.md 只放下一次执行任务必须看到的约束；背景、历史和解释放项目知识文件。
4. config.toml 只放有效配置；修改前确认键的当前含义和作用域，不凭印象创造配置项。
5. 新旧信息冲突时优先采用用户最新明确决定；无法判定则列入“需确认”。
6. 发现知识库有自己的 AGENTS.md 时，按其格式、索引和链接规则处理。

5. 展示计划并确认

在写入前给出一张合并计划表：

#	动作	层级	目标文件	摘要	依据/置信度

以下操作必须先确认：

• 删除、移动或大范围重写；
• 修改全局 ~/.codex/AGENTS.md 或 ~/.codex/config.toml；
• 修改多个项目；
• 把推测升级为规则；
• 修改技能自身。

若用户此前已明确授权同一批具体操作，可直接执行，不重复确认。

6. 执行归位

• 逐个读取目标文件后再编辑，保持原结构和措辞风格。
• 项目规则写到适用范围最近的 AGENTS.md；不要把子目录规则提升到项目根。
• 配置写到正确作用域：全局配置 ~/.codex/config.toml，项目配置 <项目>/.codex/config.toml。
• 技能安装/维护使用 ~/.agents/skills/<name>/ 或 <项目>/.agents/skills/<name>/。
• 错误复盘可显式调用 $debug-architect；文件归位可调用 $file-tidy；记忆结构整理可调用 $memory-keeper。
• 不创建没有实际内容的占位文件，不复制敏感信息，不覆盖并行工作的未提交改动。

7. 验证

• 读回所有修改文件，确认内容位于正确层级。
• 检查 AGENTS.md 继承关系，避免同一规则在多层冲突或重复。
• 检查 TOML 可解析，且未写入未知键、明文凭据或项目专属值到全局配置。
• 检查新增链接、路径和 $skill-name 是否存在。
• 使用 git diff -- <明确路径> 核对只改了计划中的文件。
• 历史数据不可用时，在结果中明确写出“未扫描 Codex 历史”及替代数据源。
• 所有验证通过后，才更新增量标记；失败时保留旧标记以便重试。

输出格式

## 全局整理完成（YYYY-MM-DD）

### 数据源与限制
- 已读取：当前上下文、项目 AGENTS.md、Git 历史
- 未读取：Codex 历史数据（未发现可访问数据）

### 文件变更
- 更新：<绝对路径> — <一句话>

### 需确认
- <冲突或高风险动作>

### 验证
- AGENTS.md 层级：通过
- TOML 解析：通过/未修改
- 变更边界：通过

只输出有内容的段落。没有可归档信息时，说明所检查的数据源和“无需变更”。