framework-context

框架上下文

概述

提供一致且以源文件为依据的框架模型，让 Agent 无需猜测即可推理系统级行为。

适用场景

• 系统级反思或元认知评估
• 依赖路由／记忆／工作流架构的任务规划
• 在建议生态演进之前分析能力缺口

铁律

1. 始终在进行任何系统级反思、规划或能力缺口分析之前加载框架上下文——未以事实为依据的架构推理会产生臆造的路径和虚构的 Agent。
2. 绝不编造未经阅读权威来源确认的文件路径或 Agent 名称——虚构路径会破坏下游尝试使用这些路径的 Agent。
3. 始终根据使用该上下文的任务，仅加载所需范围（memory、agents、workflows、hooks 或 all）——狭窄任务加载全部来源会浪费 token，并淹没相关信息。
4. 绝不在此技能中编写或修改框架文件——framework-context 仅供读取；修改需要使用相应的创建者／更新者技能。
5. 始终明确报告缺失的来源，格式为 missing source: <path>，而不是默默省略相应部分——默默省略会导致下游 Agent 基于不完整的上下文做出决策。

反模式

反模式	失败原因	正确做法
反思前跳过上下文加载	反思会采用过时或臆造的路由／记忆假设	始终先调用 framework-context；绝不要只凭记忆进行反思
狭窄任务却加载完整的 all 范围	token 预算被无关部分占用；关键信息被淹没	传入 --scope memory 或 --scope agents，将输出限制为所需内容
根据命名约定推断文件路径	路径会变更；推断出的路径会破坏 Agent 流水线	始终读取权威来源，并报告找到的实际路径
在此技能中写入框架文件	绕过创建者工作流和创建后的集成步骤	任何写入操作都使用相应的创建者／更新者技能
来源缺失时默默省略部分内容	使用者会误以为上下文完整，并基于信息缺口做出决策	对每个无法解析的部分明确报告 missing source: <path>

用于为记忆架构、路由、工作流、钩子和目录布局提供框架依据的技能。 - 生成范围限定的上下文摘要（`memory`、`agents`、`workflows`、`hooks`、`all`） - 将每个部分锚定到具体的代码库路径 - 为反思／规划使用者规范框架上下文输出

步骤 0：确定范围

• 接受 scope 参数：memory | agents | workflows | hooks | all
• 默认为 all

步骤 1：加载权威来源

仅阅读范围所需的内容：

• 记忆：.claude/docs/MEMORY_SYSTEM.md
• Agent 注册表／路由：.claude/context/agent-registry.json、.claude/lib/routing/routing-table.cjs
• 反思流程钩子：.claude/hooks/reflection/reflection-queue-processor.cjs、.claude/hooks/reflection/reflection-step0-guard.cjs
• 工作流目录：.claude/docs/@ENTERPRISE_WORKFLOWS.md
• 全局框架参考：.claude/CLAUDE.md

第 2 步：输出结构化上下文

按以下确切顺序输出各部分：

1. 记忆系统
2. Agent 与路由
3. 工作流
4. 钩子
5. 目录布局

每个部分必须包含：

• 2-6 条简洁的项目符号
• 至少一处具体路径引用
• 行为说明（什么会触发什么）

第 3 步：范围筛选

• 如果 scope != all，则只返回相关部分
• 切勿编造未知路径或流程
• 如果缺少来源，请注明 missing source: <path>

第 3 步：输出

仅返回 Markdown；不要通过此技能编写框架文件。

**调用示例**：

// Full framework model
Skill({ skill: 'framework-context' });

// Memory-only context for reflection prep
Skill({ skill: 'framework-context', args: '--scope memory' });

// Workflow/hook-only context for integration analysis
Skill({ skill: 'framework-context', args: '--scope workflows' });

</usage_example>

记忆协议（强制）

开始之前：

Get-Content .claude/context/memory/learnings.md -TotalCount 120

完成之后：

• 新的框架上下文模式 -> .claude/context/memory/learnings.md
• 框架映射存在错误或歧义 -> .claude/context/memory/issues.md
• 架构解读决策 -> .claude/context/memory/decisions.md

假设任务可能中断：你的上下文可能会重置。如果内容未写入记忆，就等于从未发生。