<?xml version="1.0"?>
<rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/">
	<channel>
		<title>jwjp-Just Wiki Join Portal  - 最近更改 [zh]</title>
		<link>https://wiki.jwjp.com/index.php?title=Special:RecentChanges</link>
		<description>用这个订阅源跟踪本wiki的最近更改。</description>
		<language>zh</language>
		<generator>MediaWiki 1.45.1</generator>
		<lastBuildDate>Sat, 29 Aug 2026 10:27:01 GMT</lastBuildDate>
		<item>
			<title>别想大象</title>
			<link>https://wiki.jwjp.com/index.php?title=%E5%88%AB%E6%83%B3%E5%A4%A7%E8%B1%A1&amp;diff=121&amp;oldid=0</link>
			<guid isPermaLink="false">https://wiki.jwjp.com/index.php?title=%E5%88%AB%E6%83%B3%E5%A4%A7%E8%B1%A1&amp;diff=121&amp;oldid=0</guid>
			<description>&lt;p&gt;创建页面，内容为“{{Infobox 概念 | 名称 = 别想大象效应 | 英文名 = Don&amp;#039;t Think of an Elephant Effect | 别名 = AI白熊效应、反向指令失效、J-space概念激活 | 领域 = &lt;a href=&quot;/index.php?title=%E4%BA%BA%E5%B7%A5%E6%99%BA%E8%83%BD&quot; title=&quot;人工智能&quot;&gt;人工智能&lt;/a&gt;、&lt;a href=&quot;/index.php?title=%E6%8F%90%E7%A4%BA%E8%AF%8D%E5%B7%A5%E7%A8%8B&amp;amp;action=edit&amp;amp;redlink=1&quot; class=&quot;new&quot; title=&quot;提示词工程（页面不存在）&quot;&gt;提示词工程&lt;/a&gt;（Prompt Engineering）、&lt;a href=&quot;/index.php?title=%E8%AE%A4%E7%9F%A5%E5%BF%83%E7%90%86%E5%AD%A6&amp;amp;action=edit&amp;amp;redlink=1&quot; class=&quot;new&quot; title=&quot;认知心理学（页面不存在）&quot;&gt;认知心理学&lt;/a&gt; }}  &amp;#039;&amp;#039;&amp;#039;别想大象&amp;#039;&amp;#039;&amp;#039;（英语：Don&amp;#039;t Think of an Elephant）在人工智能（AI）与&lt;a href=&quot;/index.php?title=%E5%A4%A7%E8%AF%AD%E8%A8%80%E6%A8%A1%E5%9E%8B&amp;amp;action=edit&amp;amp;redlink=1&quot; class=&quot;new&quot; title=&quot;大语言模型（页面不存在）&quot;&gt;大语言模型&lt;/a&gt;（LLM）领域中，是指&amp;#039;&amp;#039;&amp;#039;模型难以正确处理否定句、或反向提示词（Negative P…”&lt;/p&gt;
&lt;p&gt;&lt;b&gt;新页面&lt;/b&gt;&lt;/p&gt;&lt;div&gt;{{Infobox 概念&lt;br /&gt;
| 名称 = 别想大象效应&lt;br /&gt;
| 英文名 = Don&amp;#039;t Think of an Elephant Effect&lt;br /&gt;
| 别名 = AI白熊效应、反向指令失效、J-space概念激活&lt;br /&gt;
| 领域 = [[人工智能]]、[[提示词工程]]（Prompt Engineering）、[[认知心理学]]&lt;br /&gt;
}}&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;别想大象&amp;#039;&amp;#039;&amp;#039;（英语：Don&amp;#039;t Think of an Elephant）在人工智能（AI）与[[大语言模型]]（LLM）领域中，是指&amp;#039;&amp;#039;&amp;#039;模型难以正确处理否定句、或反向提示词（Negative Prompts）容易引发反向效果的现象&amp;#039;&amp;#039;&amp;#039;。&lt;br /&gt;
&lt;br /&gt;
该术语源自认知语言学家乔治·莱考夫（George Lakoff）的经典心理学政治学著作《别想那只大象》，在 AI 时代被广泛用于描述大模型“越不让干什么，越要干什么”的逻辑困境。&lt;br /&gt;
&lt;br /&gt;
== 现象表现 ==&lt;br /&gt;
&lt;br /&gt;
在与文本或图像 AI 交互时，该效应通常表现为以下几种形式：&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;文本生成中的“越界”&amp;#039;&amp;#039;&amp;#039;：当用户给出口令如“请直接给出答案，&amp;#039;&amp;#039;不要&amp;#039;&amp;#039;附带任何解释和客套话”时，AI 往往在生成答案后，仍旧会输出一段解释。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;图像生成中的“凭空出现”&amp;#039;&amp;#039;&amp;#039;：在 [[Midjourney]] 或 [[Stable Diffusion]] 等生图工具中，如果输入提示词 &amp;lt;code&amp;gt;A living room, no elephants&amp;lt;/code&amp;gt;（一个没有大象的客厅），AI 的画作中大概率会出现一只大象。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;越狱（Jailbreak）防御失效&amp;#039;&amp;#039;&amp;#039;：在安全对齐中，如果系统提示词硬性规定“严禁提及密码 X”，攻击者通过巧妙的绕过诱导，反而更容易激发 AI 提取出密码 X。&lt;br /&gt;
&lt;br /&gt;
== 核心技术原理 ==&lt;br /&gt;
&lt;br /&gt;
大语言模型频繁落入“别想大象”陷阱，主要由其底层架构和训练机制决定：&lt;br /&gt;
&lt;br /&gt;
=== 1. 注意力机制（Attention Mechanism）的语义偏重 ===&lt;br /&gt;
基于 [[Transformer]] 架构的模型依赖[[注意力机制]]来捕捉上下文相关性。在处理“不要包含[[政治]]内容”时，“不要”作为逻辑虚词，其注意力权重（Attention Weight）往往远低于“政治”这一实体高频词。AI 的特征向量在计算时，会不自觉地向高权重词汇倾斜。&lt;br /&gt;
&lt;br /&gt;
=== 2. 认知黑板（J-space）的提前激活 ===&lt;br /&gt;
根据人工智能研究机构 [[Anthropic]] 的内部探测研究，大模型在处理输入时存在一个类似“认知黑板”的内在空间（J-space）。&lt;br /&gt;
# 当用户输入“不要想粉红大象”时。&lt;br /&gt;
# AI 为了理解这个句子，必须先在 J-space 中激活“粉红大象”的概念特征。&lt;br /&gt;
# 一旦概念被提前激活（Primed），它在接下来的自回归（Autoregressive）文本预测中，被采纳并输出的概率就会呈现指数级上升。&lt;br /&gt;
&lt;br /&gt;
=== 3. 扩散模型的正向标签绑定 ===&lt;br /&gt;
多模态生图模型（[[Diffusion Models]]）在训练时，图片与标签（Tag）是正向绑定的（如“大象的图片”对应词标签“大象”）。模型无法理解“没有大象”的视觉特征，它只识别到了词流中的“大象”，进而将其绘制出来。&lt;br /&gt;
&lt;br /&gt;
== 提示词工程的解决方案 ==&lt;br /&gt;
&lt;br /&gt;
在[[提示词工程]]中，解决“别想大象”的标准范式是&amp;#039;&amp;#039;&amp;#039;“用正面肯定代替反面禁止”&amp;#039;&amp;#039;&amp;#039;。&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot; style=&amp;quot;width:100%;&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
! width=&amp;quot;15%&amp;quot; | 类型&lt;br /&gt;
! width=&amp;quot;42%&amp;quot; | ❌ 错误示范（引发大象效应）&lt;br /&gt;
! width=&amp;quot;43%&amp;quot; |  正确示范（正面行为对齐）&lt;br /&gt;
|-&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;文本控制&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
| &amp;lt;code&amp;gt;&amp;#039;&amp;#039;&amp;#039;不要&amp;#039;&amp;#039;&amp;#039;给出多余的解释。&amp;lt;/code&amp;gt;&lt;br /&gt;
| &amp;lt;code&amp;gt;请&amp;#039;&amp;#039;&amp;#039;仅输出&amp;#039;&amp;#039;&amp;#039;最终的 JSON 数据，严格禁止任何解释。&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;字数限制&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
| &amp;lt;code&amp;gt;&amp;#039;&amp;#039;&amp;#039;别写太多&amp;#039;&amp;#039;&amp;#039;，不要长篇大论。&amp;lt;/code&amp;gt;&lt;br /&gt;
| &amp;lt;code&amp;gt;请将字数&amp;#039;&amp;#039;&amp;#039;严格控制在 50 字以内&amp;#039;&amp;#039;&amp;#039;。&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;图像生成&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
| &amp;lt;code&amp;gt;一个房间，里面&amp;#039;&amp;#039;&amp;#039;没有&amp;#039;&amp;#039;&amp;#039;大象。&amp;lt;/code&amp;gt;&lt;br /&gt;
| &amp;lt;code&amp;gt;一个干净的北欧风现代客厅。&amp;lt;/code&amp;gt;（或使用专属的 Negative Prompt 框）&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== 参见 ==&lt;br /&gt;
* [[提示词工程]]&lt;br /&gt;
* [[大语言模型]]&lt;br /&gt;
* [[白熊效应]]&lt;br /&gt;
* [[Transformer模型]]&lt;br /&gt;
* [[Don&amp;#039;t Think of an Elephant]]&lt;br /&gt;
* [[Boardline]]&lt;br /&gt;
&lt;br /&gt;
[[Category:人工智能]]&lt;br /&gt;
[[Category:提示词工程]]&lt;br /&gt;
[[Category:认知科学]]&lt;/div&gt;</description>
			<pubDate>Thu, 27 Aug 2026 15:34:30 GMT</pubDate>
			<dc:creator>Admin</dc:creator>
			<comments>https://wiki.jwjp.com/index.php?title=Talk:%E5%88%AB%E6%83%B3%E5%A4%A7%E8%B1%A1</comments>
		</item>
		<item>
			<title>Don&#039;t Think of an Elephant</title>
			<link>https://wiki.jwjp.com/index.php?title=Don%27t_Think_of_an_Elephant&amp;diff=120&amp;oldid=0</link>
			<guid isPermaLink="false">https://wiki.jwjp.com/index.php?title=Don%27t_Think_of_an_Elephant&amp;diff=120&amp;oldid=0</guid>
			<description>&lt;p&gt;创建页面，内容为“{{Infobox concept | name = &amp;quot;Don&amp;#039;t Think of an Elephant&amp;quot; Effect | image =  | alt =  | caption =  | synonyms = AI White Bear Effect, Negative Prompt Failure, Concept Priming in LLMs | field = &lt;a href=&quot;/index.php?title=Artificial_Intelligence&amp;amp;action=edit&amp;amp;redlink=1&quot; class=&quot;new&quot; title=&quot;Artificial Intelligence（页面不存在）&quot;&gt;Artificial Intelligence&lt;/a&gt;, &lt;a href=&quot;/index.php?title=Prompt_Engineering&amp;amp;action=edit&amp;amp;redlink=1&quot; class=&quot;new&quot; title=&quot;Prompt Engineering（页面不存在）&quot;&gt;Prompt Engineering&lt;/a&gt;, &lt;a href=&quot;/index.php?title=Cognitive_Science&amp;amp;action=edit&amp;amp;redlink=1&quot; class=&quot;new&quot; title=&quot;Cognitive Science（页面不存在）&quot;&gt;Cognitive Science&lt;/a&gt; }}  In the fields of &lt;a href=&quot;/index.php?title=Artificial_Intelligence&amp;amp;action=edit&amp;amp;redlink=1&quot; class=&quot;new&quot; title=&quot;Artificial Intelligence（页面不存在）&quot;&gt;Artificial Intelligence&lt;/a&gt; (AI) and &lt;a href=&quot;/index.php?title=Large_Language_Models&amp;amp;action=edit&amp;amp;redlink=1&quot; class=&quot;new&quot; title=&quot;Large Language Models（页面不存在）&quot;&gt;Large Language Models&lt;/a&gt; (LLMs), the_&amp;#039;&amp;#039;&amp;#039;&amp;quot;Don&amp;#039;t Think of an Elephant&amp;quot; Effect&amp;#039;&amp;#039;&amp;#039; refers to the phenomenon where &amp;#039;&amp;#039;&amp;#039;models struggle to correctly…”&lt;/p&gt;
&lt;p&gt;&lt;b&gt;新页面&lt;/b&gt;&lt;/p&gt;&lt;div&gt;{{Infobox concept&lt;br /&gt;
| name = &amp;quot;Don&amp;#039;t Think of an Elephant&amp;quot; Effect&lt;br /&gt;
| image = &lt;br /&gt;
| alt = &lt;br /&gt;
| caption = &lt;br /&gt;
| synonyms = AI White Bear Effect, Negative Prompt Failure, Concept Priming in LLMs&lt;br /&gt;
| field = [[Artificial Intelligence]], [[Prompt Engineering]], [[Cognitive Science]]&lt;br /&gt;
}}&lt;br /&gt;
&lt;br /&gt;
In the fields of [[Artificial Intelligence]] (AI) and [[Large Language Models]] (LLMs), the_&amp;#039;&amp;#039;&amp;#039;&amp;quot;Don&amp;#039;t Think of an Elephant&amp;quot; Effect&amp;#039;&amp;#039;&amp;#039; refers to the phenomenon where &amp;#039;&amp;#039;&amp;#039;models struggle to correctly process negative commands, or where negative prompts inadvertently trigger the generation of forbidden content&amp;#039;&amp;#039;&amp;#039;.&lt;br /&gt;
&lt;br /&gt;
The term originates from the classic cognitive linguistics book &amp;#039;&amp;#039;Don&amp;#039;t Think of an Elephant!&amp;#039;&amp;#039; by George Lakoff. In the AI era, it is widely used to describe the semantic dilemma where the model does opposite to what it is restricted from doing.&lt;br /&gt;
&lt;br /&gt;
== Manifestations ==&lt;br /&gt;
&lt;br /&gt;
When interacting with text or image generation AI, this effect typically manifests in the following scenarios:&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Overstepping in Text Generation&amp;#039;&amp;#039;&amp;#039;: When given instructions such as &amp;quot;Provide the answer, but do &amp;#039;&amp;#039;not&amp;#039;&amp;#039; include any extra explanations&amp;quot;, LLMs often still output a paragraph of explanation after the core answer.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Unexpected Artifacts in Image Generation&amp;#039;&amp;#039;&amp;#039;: In tools like [[Midjourney]] or [[Stable Diffusion]], inputting a prompt like &amp;lt;code&amp;gt;A cozy living room, no elephants&amp;lt;/code&amp;gt; will highly likely result in an elephant appearing in the generated image.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Failure in Safety Alignment Defense&amp;#039;&amp;#039;&amp;#039;: If a system prompt strictly mandates &amp;quot;Do not mention the secret password X&amp;quot;, attackers often find it easier to extract password X through jailbreak prompts because the concept has already been primed.&lt;br /&gt;
&lt;br /&gt;
== Core Technical Principles ==&lt;br /&gt;
&lt;br /&gt;
This issue is not intentional defiance by the AI, but rather a direct result of its underlying architecture and training mechanisms:&lt;br /&gt;
&lt;br /&gt;
=== 1. Semantic Bias of the Attention Mechanism ===&lt;br /&gt;
Models based on the [[Transformer]] architecture rely on the [[Attention Mechanism]] to capture contextual relevance. When processing &amp;quot;Do not include politics&amp;quot;, the logical negator &amp;quot;Do not&amp;quot; typically receives a much lower attention weight compared to the high-frequency entity noun &amp;quot;Politics&amp;quot;. The AI&amp;#039;s feature vectors naturally lean toward words with higher weights.&lt;br /&gt;
&lt;br /&gt;
=== 2. Concept Priming in J-space ===&lt;br /&gt;
According to mechanistic interpretability research by [[Anthropic]], LLMs utilize an internal representational space (often referred to as a &amp;quot;cognitive blackboard&amp;quot; or J-space) when processing inputs.&lt;br /&gt;
# When a user inputs &amp;quot;Don&amp;#039;t think of a pink elephant&amp;quot;.&lt;br /&gt;
# To parse and understand the semantics of the sentence, the AI must first activate the concept features of &amp;quot;pink elephant&amp;quot; within its J-space.&lt;br /&gt;
# Once a concept is pre-activated (primed), its probability of being selected and outputted in the subsequent autoregressive token prediction increases exponentially.&lt;br /&gt;
&lt;br /&gt;
=== 3. Positive Tag Binding in Diffusion Models ===&lt;br /&gt;
Multimodal text-to-image models ([[Diffusion Models]]) are trained on datasets where images are positively mapped to tags (e.g., an image of an elephant is tagged with the word &amp;quot;elephant&amp;quot;). The model cannot visually conceptualize &amp;quot;the absence of an elephant&amp;quot;; it only recognizes the word token &amp;quot;elephant&amp;quot; in the text stream and renders it.&lt;br /&gt;
&lt;br /&gt;
== Solutions in Prompt Engineering ==&lt;br /&gt;
&lt;br /&gt;
In [[Prompt Engineering]], the standard paradigm to eliminate the elephant effect is to &amp;#039;&amp;#039;&amp;#039;&amp;quot;Use Positive Affirmation over Negative Prohibition&amp;quot;&amp;#039;&amp;#039;&amp;#039;.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot; style=&amp;quot;width:100%;&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
! width=&amp;quot;15%&amp;quot; | Type&lt;br /&gt;
! width=&amp;quot;42%&amp;quot; | ❌ Incorrect Practice (Triggers Elephant Effect)&lt;br /&gt;
! width=&amp;quot;43%&amp;quot; |  Correct Practice (Positive Behavior Alignment)&lt;br /&gt;
|-&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;Text Control&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
| &amp;lt;code&amp;gt;Do &amp;#039;&amp;#039;&amp;#039;not&amp;#039;&amp;#039;&amp;#039; give any explanation.&amp;lt;/code&amp;gt;&lt;br /&gt;
| &amp;lt;code&amp;gt;Output &amp;#039;&amp;#039;&amp;#039;only&amp;#039;&amp;#039;&amp;#039; the raw JSON data.&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;Length Constraint&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
| &amp;lt;code&amp;gt;&amp;#039;&amp;#039;&amp;#039;Don&amp;#039;t&amp;#039;&amp;#039;&amp;#039; write too much or be wordy.&amp;lt;/code&amp;gt;&lt;br /&gt;
| &amp;lt;code&amp;gt;Keep the response &amp;#039;&amp;#039;&amp;#039;under 50 words&amp;#039;&amp;#039;&amp;#039;.&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;Image Generation&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
| &amp;lt;code&amp;gt;A room with &amp;#039;&amp;#039;&amp;#039;no&amp;#039;&amp;#039;&amp;#039; elephants.&amp;lt;/code&amp;gt;&lt;br /&gt;
| &amp;lt;code&amp;gt;A clean and minimalist Scandinavian living room.&amp;lt;/code&amp;gt; (Or place &amp;quot;elephant&amp;quot; in the designated Negative Prompt box)&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== See Also ==&lt;br /&gt;
* [[Prompt Engineering]]&lt;br /&gt;
* [[Large Language Models]]&lt;br /&gt;
* [[Ironic Process Theory]]&lt;br /&gt;
* [[Transformer Model]]&lt;br /&gt;
* [[Boardline]]&lt;br /&gt;
&lt;br /&gt;
[[Category:Artificial Intelligence]]&lt;br /&gt;
[[Category:Prompt Engineering]]&lt;br /&gt;
[[Category:Cognitive Science]]&lt;/div&gt;</description>
			<pubDate>Thu, 27 Aug 2026 15:33:50 GMT</pubDate>
			<dc:creator>Admin</dc:creator>
			<comments>https://wiki.jwjp.com/index.php?title=Talk:Don%27t_Think_of_an_Elephant</comments>
		</item>
		<item>
			<title>AI智能体分层长期记忆引擎</title>
			<link>https://wiki.jwjp.com/index.php?title=AI%E6%99%BA%E8%83%BD%E4%BD%93%E5%88%86%E5%B1%82%E9%95%BF%E6%9C%9F%E8%AE%B0%E5%BF%86%E5%BC%95%E6%93%8E&amp;diff=119&amp;oldid=0</link>
			<guid isPermaLink="false">https://wiki.jwjp.com/index.php?title=AI%E6%99%BA%E8%83%BD%E4%BD%93%E5%88%86%E5%B1%82%E9%95%BF%E6%9C%9F%E8%AE%B0%E5%BF%86%E5%BC%95%E6%93%8E&amp;diff=119&amp;oldid=0</guid>
			<description>&lt;p&gt;创建页面，内容为“== TencentDB Agent Memory 核心架构与演进指南 == TencentDB Agent Memory（腾讯云智能体分层长期记忆引擎）是由腾讯云数据库团队面向 AI Agent 长周期任务、超长 Session 开发的开源企业级记忆中枢系统（采用 MIT 开源协议）。该引擎旨在通过本地分层存储与符号化压缩，化解长业务场景中的信息遗忘问题，在标准基准测试中，可为大模型减免 50% 以上的 Token 消耗…”&lt;/p&gt;
&lt;p&gt;&lt;b&gt;新页面&lt;/b&gt;&lt;/p&gt;&lt;div&gt;== TencentDB Agent Memory 核心架构与演进指南 ==&lt;br /&gt;
[[TencentDB Agent Memory]]（腾讯云智能体分层长期记忆引擎）是由腾讯云数据库团队面向 AI Agent 长周期任务、超长 Session 开发的开源企业级记忆中枢系统（采用 MIT 开源协议）。该引擎旨在通过本地分层存储与符号化压缩，化解长业务场景中的信息遗忘问题，在标准基准测试中，可为大模型减免 50% 以上的 Token 消耗。&lt;br /&gt;
&lt;br /&gt;
=== 1. 四层长期记忆架构 (4-Tier Memory Architecture) ===&lt;br /&gt;
为了防止上下文窗口（Context Window）出现过载或污染，引擎将 Agent 交互产生的数据流严格划分为四个递进的数据层级：&lt;br /&gt;
&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;L0: 会话层 (Conversation Tier - 动态记忆)&amp;#039;&amp;#039;&amp;#039;: 实时接收并完整保留最原始的、未经加工的对话轮次（Raw Turns）。负责在当前活跃窗口内进行无损的 Token 跟踪，并建立局部状态变量，供 Agent 进行毫秒级的状态更新。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;L1: 原子层 (Atom Tier - 结构化记忆)&amp;#039;&amp;#039;&amp;#039;: 通过后台异步提取流水线，自动将散乱的对话语料提炼为相互独立的原子事实（Atomic Facts）、键值对实体（KV Entities）、承诺事件以及关系陈述。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;L2: 场景层 (Scenario Tier - 上下文记忆)&amp;#039;&amp;#039;&amp;#039;: 按照具体的任务流或用户流，将相关的原子事实组织成动态的执行拓扑。场景会被序列化为具备版本控制的 Markdown 配置文件，以便进行状态固化与跨会话恢复。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;L3: 用户画像层 (Persona Tier - 全局配置)&amp;#039;&amp;#039;&amp;#039;: 跨越数百个独立历史会话，对用户的行为偏好、跨项目知识资产进行最终的全局融合与提炼，自动淘汰过期或冲突的运行时变量。&lt;br /&gt;
&lt;br /&gt;
=== 2. 核心拦截与治理机制 ===&lt;br /&gt;
为防止自主智能体在长期运行中由于幻觉或长尾 Session 导致的内存退化，系统在运行层设置了三道核心安全红线：&lt;br /&gt;
&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;上下文卸载机制 (Context Offloading)&amp;#039;&amp;#039;&amp;#039;: 持续监控当前活跃窗口的 Token 饱和度。当窗口水位触发 80% 的临界值时，引擎自动对历史片段进行摘要提炼，将其推入 L1/L2 存储层，并在主干中保留显式的内存指针（Pointers）。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;钩子管控与命令白名单 (Hook Gating)&amp;#039;&amp;#039;&amp;#039;: 在智能体执行层实施强隔离。Agent 对全局共享的配置和历史资产仅具备只读权限。任何试图无人类多因素认证（MFA）而直接改写根 Schema 或系统配置的行为，将直接触发会话阻断。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Mermaid 任务画布追踪 (Execution Tracer)&amp;#039;&amp;#039;&amp;#039;: 自动将 Agent 的工具调用路径、依赖节点及错误堆栈实时转化为标准的 Mermaid 关系依赖图，将黑盒的执行轨迹透明化，以便开发人员进行安全审计与故障复盘。&lt;br /&gt;
&lt;br /&gt;
=== 3. 安装、部署与网关集成 ===&lt;br /&gt;
&lt;br /&gt;
==== 3.1 基于 OpenClaw 插件接入 ====&lt;br /&gt;
如需在您的 OpenClaw 或基于此的自动化研发流中启用记忆服务，请先在终端安装官方供应端插件：&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
openclaw plugins install @tencentdb-agent-memory/memory-tencentdb&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
随后打开位于 &amp;lt;code&amp;gt;~/.openclaw/openclaw.json&amp;lt;/code&amp;gt; 的核心配置文件，在 plugins 列表中追加以下元数据，并将激活状态（enabled）设为 true：&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;quot;memory-tencentdb&amp;quot;: {&lt;br /&gt;
    &amp;quot;enabled&amp;quot;: true,&lt;br /&gt;
    &amp;quot;storage&amp;quot;: &amp;quot;sqlite-vec&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
系统默认开启嵌入式 SQLite 及本地向量扩展（sqlite-vec）进行局部缓存，若需分布式或多智能体协同，则需额外配置显式槽位（slots）参数。&lt;br /&gt;
&lt;br /&gt;
==== 3.2 Hermes 网关独立部署 ====&lt;br /&gt;
针对企业级的生产级独立接入，推荐使用 Docker 单独部署 Hermes 网关镜像，实现网络调用与主干核心的物理隔离：&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
docker run -d --name hermes-gateway -p 8420:8420 tencentcloud/hermes-gateway:latest&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Hermes 网关默认在本地 8420 端口暴露标准化 API 路由，请确保企业内部防火墙已将该端口放行给合规的内网服务。&lt;br /&gt;
&lt;br /&gt;
[[Boardline]]&lt;br /&gt;
[[TencentDB_Agent_Memory]]&lt;br /&gt;
[[分类:技术架构]]&lt;br /&gt;
[[分类:AI基础设施]]&lt;/div&gt;</description>
			<pubDate>Thu, 27 Aug 2026 11:24:35 GMT</pubDate>
			<dc:creator>Admin</dc:creator>
			<comments>https://wiki.jwjp.com/index.php?title=Talk:AI%E6%99%BA%E8%83%BD%E4%BD%93%E5%88%86%E5%B1%82%E9%95%BF%E6%9C%9F%E8%AE%B0%E5%BF%86%E5%BC%95%E6%93%8E</comments>
		</item>
		<item>
			<title>TencentDB Agent Memory</title>
			<link>https://wiki.jwjp.com/index.php?title=TencentDB_Agent_Memory&amp;diff=118&amp;oldid=0</link>
			<guid isPermaLink="false">https://wiki.jwjp.com/index.php?title=TencentDB_Agent_Memory&amp;diff=118&amp;oldid=0</guid>
			<description>&lt;p&gt;创建页面，内容为“== TencentDB Agent Memory Core Specification &amp;amp; Architecture Framework == TencentDB Agent Memory is a hierarchical long-term memory engine open-sourced by the Tencent Cloud Database Team. It is explicitly architected for AI Agents handling long-running sessions, multi-turn tool calling, and cross-session knowledge persistence. Under standard benchmarks, it reduces token usage by over 50% compared to brute-force vector memory retrieval.  === 1. The 4-Tier Memory…”&lt;/p&gt;
&lt;p&gt;&lt;b&gt;新页面&lt;/b&gt;&lt;/p&gt;&lt;div&gt;== TencentDB Agent Memory Core Specification &amp;amp; Architecture Framework ==&lt;br /&gt;
TencentDB Agent Memory is a hierarchical long-term memory engine open-sourced by the Tencent Cloud Database Team. It is explicitly architected for AI Agents handling long-running sessions, multi-turn tool calling, and cross-session knowledge persistence. Under standard benchmarks, it reduces token usage by over 50% compared to brute-force vector memory retrieval.&lt;br /&gt;
&lt;br /&gt;
=== 1. The 4-Tier Memory Architecture ===&lt;br /&gt;
The engine structures context into a rigorous four-layer data hierarchy to guarantee structured, predictable retrieval without context window flooding.&lt;br /&gt;
&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;L0: Conversation Tier (Dynamic Memory)&amp;#039;&amp;#039;&amp;#039;: Captures raw, unfiltered conversation turns in real-time. It provides lossless token tracking within the active window and isolates state variables for rapid state updates.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;L1: Atom Tier (Structured Memory)&amp;#039;&amp;#039;&amp;#039;: Automatically distills loose dialogue turns into independent atomic facts, key value entities, promises, and relational statements via background extraction pipelines.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;L2: Scenario Tier (Contextual Memory)&amp;#039;&amp;#039;&amp;#039;: Groups atomic facts into dynamic execution topologies based on specific tasks or user flows. Scenarios are serialized into version-controlled markdown artifacts for easy state persistence.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;L3: Persona Tier (Global Profile)&amp;#039;&amp;#039;&amp;#039;: Synthesizes a persistent profile of the user across hundreds of independent historical sessions. It automatically updates long-term behavioural preferences and cross-project knowledge assets.&lt;br /&gt;
&lt;br /&gt;
=== 2. Core Gatekeeping Mechanics ===&lt;br /&gt;
To prevent agents from polluting the persistent data layer with hallucinations or out-of-date runtime execution variables, the system executes three critical operational boundaries.&lt;br /&gt;
&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Context Offloading Engine&amp;#039;&amp;#039;&amp;#039;: Monitors the current token density of the live context window. When the window nears 80% saturation, it automatically summarizes active histories, offloads historical segments to L1/L2 tiers, and references them via explicit memory pointers.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Hook Gating &amp;amp; Command Whitelisting&amp;#039;&amp;#039;&amp;#039;: Operates at the runtime interface to block unauthorized write commands to the root database schema. Agents can read globally shared profiles but cannot write back to system files or alter shared memories without manual Multi-Factor Authentication.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Mermaid Canvas Execution Tracer&amp;#039;&amp;#039;&amp;#039;: Automatically logs tool invocation paths and error stack parameters into standard Mermaid dependency trees. This converts complex execution graphs into human-readable visual layouts for rapid debugging and security reviews.&lt;br /&gt;
&lt;br /&gt;
=== 3. Installation, Deployment &amp;amp; Gateway Orchestration ===&lt;br /&gt;
&lt;br /&gt;
==== 3.1 OpenClaw Integration via Plugin ====&lt;br /&gt;
To enable memory services within your OpenClaw or OpenClaw-based deployment workflows, install the official provider extension:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
openclaw plugins install @tencentdb-agent-memory/memory-tencentdb&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Update your core configuration file located at &amp;lt;code&amp;gt;~/.openclaw/openclaw.json&amp;lt;/code&amp;gt;. Append the provider metadata directly inside the plugins block and switch the active state property to true:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;quot;memory-tencentdb&amp;quot;: {&lt;br /&gt;
    &amp;quot;enabled&amp;quot;: true,&lt;br /&gt;
    &amp;quot;storage&amp;quot;: &amp;quot;sqlite-vec&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
By default, the engine utilizes embedded SQLite with native vector extensions for localized caching. For distributed or collaborative environments, explicit slot properties must be configured.&lt;br /&gt;
&lt;br /&gt;
==== 3.2 Hermes Gateway Deployment ====&lt;br /&gt;
For independent, production-grade enterprise access, deploy the standalone gateway image via Docker to isolate network calls from the main core:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
docker run -d --name hermes-gateway -p 8420:8420 tencentcloud/hermes-gateway:latest&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The Hermes Gateway exposes localized API routing endpoints on port 8420. Ensure your enterprise firewall configurations whitelist traffic to this port for authorized internal services.&lt;br /&gt;
[[Boardline]]&lt;br /&gt;
[[Category:Technical Architecture]]&lt;br /&gt;
[[Category:AI Infrastructure]]&lt;/div&gt;</description>
			<pubDate>Thu, 27 Aug 2026 11:23:08 GMT</pubDate>
			<dc:creator>Admin</dc:creator>
			<comments>https://wiki.jwjp.com/index.php?title=Talk:TencentDB_Agent_Memory</comments>
		</item>
		<item>
			<title>AI-Native SDLC</title>
			<link>https://wiki.jwjp.com/index.php?title=AI-Native_SDLC&amp;diff=117&amp;oldid=116</link>
			<guid isPermaLink="false">https://wiki.jwjp.com/index.php?title=AI-Native_SDLC&amp;diff=117&amp;oldid=116</guid>
			<description>&lt;p&gt;&lt;/p&gt;
&lt;table style=&quot;background-color: #fff; color: #202122;&quot; data-mw=&quot;interface&quot;&gt;
				&lt;col class=&quot;diff-marker&quot; /&gt;
				&lt;col class=&quot;diff-content&quot; /&gt;
				&lt;col class=&quot;diff-marker&quot; /&gt;
				&lt;col class=&quot;diff-content&quot; /&gt;
				&lt;tr class=&quot;diff-title&quot; lang=&quot;zh&quot;&gt;
				&lt;td colspan=&quot;2&quot; style=&quot;background-color: #fff; color: #202122; text-align: center;&quot;&gt;←上一版本&lt;/td&gt;
				&lt;td colspan=&quot;2&quot; style=&quot;background-color: #fff; color: #202122; text-align: center;&quot;&gt;2026年8月27日 (四) 19:16的版本&lt;/td&gt;
				&lt;/tr&gt;&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot; id=&quot;mw-diff-left-l1&quot;&gt;第1行：&lt;/td&gt;
&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;第1行：&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;== 1. Executive Summary &amp;amp; Philosophical Shift ==&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;With the deployment of advanced software engineering agents, code generation speed has accelerated exponentially, shifting the delivery bottleneck downstream to evaluation, specification gating, and deployment reviews. This framework re-architects the software engineering lifecycle to safely operationalize autonomous agents within the repository.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;=== 1.1 Legacy SDLC vs AI-Native SDLC ===&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;{| class=&quot;wikitable&quot; style=&quot;width:100%;&quot;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;|-&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;! style=&quot;background:#f2f2f2;&quot; | Dimension&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;! style=&quot;background:#f2f2f2;&quot; | Legacy SDLC&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;! style=&quot;background:#f2f2f2;&quot; | AI-Native SDLC&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;|-&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;| &#039;&#039;&#039;Delivery Medium&#039;&#039;&#039;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;| Cross-team meetings, Jira tickets, manual handoffs&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;| Version-controlled markdown artifact chains&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;|-&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;| &#039;&#039;&#039;Primary Author&#039;&#039;&#039;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;| Human engineers writing all code and tests manually&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;| AI automated generation; humans perform review &amp;amp; tuning&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;|-&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;| &#039;&#039;&#039;Quality Gating&#039;&#039;&#039;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;| Manual Code Review, sequential QA testing&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;| Automated continuous evaluation (Evals) &amp;amp; hard hooks&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;|}&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;== 2. The 6-Stage Artifact-Driven Loop ==&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;AI-Native SDLC replaces traditional ticketing handoffs with a chain of continuous, version-controlled markdown documents:&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;* &#039;&#039;&#039;1. Plan&#039;&#039;&#039; -&amp;gt; Artifact: &amp;lt;code&amp;gt;intent.md&amp;lt;/code&amp;gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;** &#039;&#039;&#039;AI Role&#039;&#039;&#039;: Interrogates requirements dynamically to structure ambiguous business goals.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;** &#039;&#039;&#039;Human Role&#039;&#039;&#039;: Defines the high-level business intent and scope boundaries.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;* &#039;&#039;&#039;2. Design&#039;&#039;&#039; -&amp;gt; Artifact: &amp;lt;code&amp;gt;spec.md&amp;lt;/code&amp;gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;** &#039;&#039;&#039;AI Role&#039;&#039;&#039;: Reads project architecture context to generate compliant technical specifications.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;** &#039;&#039;&#039;Human Role&#039;&#039;&#039;: Audits architectural alignment and resolves cross-system dependencies.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;* &#039;&#039;&#039;3. Build&#039;&#039;&#039; -&amp;gt; Artifact: &amp;lt;code&amp;gt;plan.md&amp;lt;/code&amp;gt; + Code Base&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;** &#039;&#039;&#039;AI Role&#039;&#039;&#039;: &#039;&#039;&#039;Plan Mode Mandate.&#039;&#039;&#039; Generates target files to alter and local validation strategies before modifying code.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;** &#039;&#039;&#039;Human Role&#039;&#039;&#039;: &#039;&#039;&#039;Approves or Rejects plan.md.&#039;&#039;&#039; AI is blocked from file modifications without explicit human unlock.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;* &#039;&#039;&#039;4. Test&#039;&#039;&#039; -&amp;gt; Artifact: Automated Test Logs&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;** &#039;&#039;&#039;AI Role&#039;&#039;&#039;: Autonomously writes, executes, and fixes unit/integration tests in sandboxed runtimes.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;** &#039;&#039;&#039;Human Role&#039;&#039;&#039;: Audits edge cases and defines the absolute safety baseline.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;* &#039;&#039;&#039;5. Deploy&#039;&#039;&#039; -&amp;gt; Artifact: Audited Pull Request&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;** &#039;&#039;&#039;AI Role&#039;&#039;&#039;: Runs automated SAST security analysis, lints, and prepares environment deployment logs.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;** &#039;&#039;&#039;Human Role&#039;&#039;&#039;: &#039;&#039;&#039;Executes final manual merge (MFA verification)&#039;&#039;&#039; as the absolute gatekeeper.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;* &#039;&#039;&#039;6. Maintain&#039;&#039;&#039; -&amp;gt; Artifact: Sandboxed Diagnostics&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;** &#039;&#039;&#039;AI Role&#039;&#039;&#039;: Monitors production health and auto-generates isolated fault diagnosis reports.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;** &#039;&#039;&#039;Human Role&#039;&#039;&#039;: Feedback systemic constraints to Stage 1 to prevent future regression.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;== 3. Repository Governance Architecture (The Control Stack) ==&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;To maintain systemic stability and prevent unauthorized file modifications or security leaks, all modern repositories must enforce a three-layer boundary structure.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;=== 3.1 Base Layer (Base): CLAUDE.md Specification ===&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;This root-level configuration dictates the runtime context for the agent. &#039;&#039;&#039;AI is strictly forbidden from altering this file without a manual human commit override.&#039;&#039;&#039;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&amp;lt;pre&amp;gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;# CLAUDE.md - Engineering Standards for Agent Session&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;## 1. Build &amp;amp; Test Infrastructure&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;- Build Command: npm run build or make compile&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;- Test Execution: pytest tests/unit/ or npm run test&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;## 2. Code Style &amp;amp; Constraints&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;- Language Standard: TypeScript (ES2022), Strict Null Checks enabled.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;- State Management: Functional purity preferred. Side effects must be isolated in service domains.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;## 3. Scar Tissue (Anti-Patterns to Avoid)&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;- FIX-001: Do NOT batch write to /api/v1/auth without resolving local token validation contexts.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;- FIX-002: Avoid nested async blocks in repository drivers; use explicit sequential wrappers.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&amp;lt;/pre&amp;gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;=== 3.2 Specification Layer (Specification): Domain Skills ===&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;Guidelines for high-frequency or high-risk tasks defined programmatically:&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;* &#039;&#039;&#039;Database Schema Migrations&#039;&#039;&#039;: AI-generated migrations must include full down (rollback) scripts.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;* &#039;&#039;&#039;API Versioning Protocol&#039;&#039;&#039;: Enforces breaking change analysis prior to altering public interfaces.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;=== 3.3 Hard Constraints Layer (Hard Constraints): Hooks ===&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;* &#039;&#039;&#039;File Level Isolation&#039;&#039;&#039;: Git hooks (pre-commit) must intercept agent access to .env, private keys, or master configurations without explicit human Multi-Factor Authentication (MFA).&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;* &#039;&#039;&#039;Command Whitelisting&#039;&#039;&#039;: Execution targets are restricted to non-destructive development commands. Destructive targets (e.g., rm -rf, raw DB drops) trigger immediate process termination.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;== 4. Operational Transition Roadmap ==&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;The evolution follows a strict phased approach: &quot;Control, then Acceleration, then Full Autonomy.&quot;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;# &#039;&#039;&#039;Phase 1: Regulated Build (Weeks 1-4)&#039;&#039;&#039;: Enforce mandatory CLAUDE.md and plan.md interactive gates globally to eliminate unauthorized multi-file sweeping regressions.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;# &#039;&#039;&#039;Phase 2: Continuous Evaluation (Months 2-3)&#039;&#039;&#039;: Deploy &#039;&#039;&#039;Evals (Continuous Evaluation suites)&#039;&#039;&#039; to programmatically score agent output accuracy and prevent system regression during model upgrades.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;# &#039;&#039;&#039;Phase 3: Upstream Shift-Left (Months 4+)&#039;&#039;&#039;: Integrate the entire loop from product intent (intent.md) to autonomous technical specs and real-time production self-healing.&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;[[Category:Technical Architecture]] [[Category:R&amp;amp;D Efficiency]]&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-side-deleted&quot;&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&lt;/ins&gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&amp;#039;&amp;#039;&amp;#039;AI-Native SDLC（AI原生软件开发生命周期）&amp;#039;&amp;#039;&amp;#039;是针对大语言模型（LLM）和Agent（智能体）时代对传统软件开发流程的一次&amp;#039;&amp;#039;&amp;#039;重构与革新&amp;#039;&amp;#039;&amp;#039;。&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&amp;#039;&amp;#039;&amp;#039;AI-Native SDLC（AI原生软件开发生命周期）&amp;#039;&amp;#039;&amp;#039;是针对大语言模型（LLM）和Agent（智能体）时代对传统软件开发流程的一次&amp;#039;&amp;#039;&amp;#039;重构与革新&amp;#039;&amp;#039;&amp;#039;。&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br&gt;&lt;/td&gt;&lt;/tr&gt;

&lt;!-- diff cache key jwjp:diff:1.41:old-116:rev-117:php=table --&gt;
&lt;/table&gt;</description>
			<pubDate>Thu, 27 Aug 2026 11:16:02 GMT</pubDate>
			<dc:creator>Admin</dc:creator>
			<comments>https://wiki.jwjp.com/index.php?title=Talk:AI-Native_SDLC</comments>
		</item>
		<item>
			<title>AI-Native SDLC</title>
			<link>https://wiki.jwjp.com/index.php?title=AI-Native_SDLC&amp;diff=116&amp;oldid=0</link>
			<guid isPermaLink="false">https://wiki.jwjp.com/index.php?title=AI-Native_SDLC&amp;diff=116&amp;oldid=0</guid>
			<description>&lt;p&gt;创建页面，内容为“&amp;#039;&amp;#039;&amp;#039;AI-Native SDLC（AI原生软件开发生命周期）&amp;#039;&amp;#039;&amp;#039;是针对大语言模型（LLM）和Agent（智能体）时代对传统软件开发流程的一次&amp;#039;&amp;#039;&amp;#039;重构与革新&amp;#039;&amp;#039;&amp;#039;。  随着工程智能体的普及，写代码（Build）的速度大幅提升，研发交付的瓶颈已全面转移至下游的评审、拦截、安全与发布。本规范旨在将 AI 从单纯的“辅助编码工具”升级为“研发流程的自驱动核心”，人类工程师…”&lt;/p&gt;
&lt;p&gt;&lt;b&gt;新页面&lt;/b&gt;&lt;/p&gt;&lt;div&gt;&amp;#039;&amp;#039;&amp;#039;AI-Native SDLC（AI原生软件开发生命周期）&amp;#039;&amp;#039;&amp;#039;是针对大语言模型（LLM）和Agent（智能体）时代对传统软件开发流程的一次&amp;#039;&amp;#039;&amp;#039;重构与革新&amp;#039;&amp;#039;&amp;#039;。&lt;br /&gt;
&lt;br /&gt;
随着工程智能体的普及，写代码（Build）的速度大幅提升，研发交付的瓶颈已全面转移至下游的评审、拦截、安全与发布。本规范旨在将 AI 从单纯的“辅助编码工具”升级为“研发流程的自驱动核心”，人类工程师角色全面转变为&amp;#039;&amp;#039;&amp;#039;意图定义者（Intent Definer）&amp;#039;&amp;#039;&amp;#039;与&amp;#039;&amp;#039;&amp;#039;最终红线守门人（Gatekeeper）&amp;#039;&amp;#039;&amp;#039;。&lt;br /&gt;
&lt;br /&gt;
== 1. 传统 SDLC vs AI-Native SDLC 核心对比 ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot; style=&amp;quot;width:100%;&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
! style=&amp;quot;background:#f2f2f2;&amp;quot; | 维度&lt;br /&gt;
! style=&amp;quot;background:#f2f2f2;&amp;quot; | 传统 SDLC&lt;br /&gt;
! style=&amp;quot;background:#f2f2f2;&amp;quot; | AI-Native SDLC&lt;br /&gt;
|-&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;流转介质&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
| 跨团队会议、Jira 工单、口头交付&lt;br /&gt;
| 具备版本控制的文档链&lt;br /&gt;
|-&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;编写主体&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
| 人类手动编写所有代码与测试&lt;br /&gt;
| AI 自动化生成，人类执行微调与审批&lt;br /&gt;
|-&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;质量关卡&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
| 人工 Code Review、手动 QA 测试&lt;br /&gt;
| 自动化持续评测与硬拦截钩子&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== 2. 六阶段制品驱动闭环 (The 6-Stage Loop) ==&lt;br /&gt;
&lt;br /&gt;
AI-Native SDLC 废除繁琐的工单交接，转而由一套&amp;#039;&amp;#039;&amp;#039;相互耦合、可版本控制的文档链&amp;#039;&amp;#039;&amp;#039;驱动研发闭环：&lt;br /&gt;
&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;1. 规划阶段 (Plan)&amp;#039;&amp;#039;&amp;#039; -&amp;gt; 核心制品: &amp;lt;code&amp;gt;intent.md&amp;lt;/code&amp;gt;&lt;br /&gt;
** &amp;#039;&amp;#039;&amp;#039;AI 职责&amp;#039;&amp;#039;&amp;#039;: 动态追问人类，消除含糊语义，将原始想法提炼为结构化业务需求。&lt;br /&gt;
** &amp;#039;&amp;#039;&amp;#039;人类职责&amp;#039;&amp;#039;&amp;#039;: 提供核心商业意图，划定业务边界。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;2. 设计阶段 (Design)&amp;#039;&amp;#039;&amp;#039; -&amp;gt; 核心制品: &amp;lt;code&amp;gt;spec.md&amp;lt;/code&amp;gt;&lt;br /&gt;
** &amp;#039;&amp;#039;&amp;#039;AI 职责&amp;#039;&amp;#039;&amp;#039;: 读取项目既有架构，自动生成符合规范的技术施工规格说明书。&lt;br /&gt;
** &amp;#039;&amp;#039;&amp;#039;人类职责&amp;#039;&amp;#039;&amp;#039;: 审计架构一致性，评估跨系统风险。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;3. 构建阶段 (Build)&amp;#039;&amp;#039;&amp;#039; -&amp;gt; 核心制品: &amp;lt;code&amp;gt;plan.md&amp;lt;/code&amp;gt; + 源码变更&lt;br /&gt;
** &amp;#039;&amp;#039;&amp;#039;AI 职责&amp;#039;&amp;#039;&amp;#039;: &amp;#039;&amp;#039;&amp;#039;强制进入计划模式&amp;#039;&amp;#039;&amp;#039;。在动笔修改任何代码前，必须先输出 &amp;lt;code&amp;gt;plan.md&amp;lt;/code&amp;gt;，列出拟变动文件清单与本地验证策略。&lt;br /&gt;
** &amp;#039;&amp;#039;&amp;#039;人类职责&amp;#039;&amp;#039;&amp;#039;: &amp;#039;&amp;#039;&amp;#039;审批或驳回 plan.md&amp;#039;&amp;#039;&amp;#039;。未经人类授权，AI 禁止擅自修改任何系统文件。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;4. 测试阶段 (Test)&amp;#039;&amp;#039;&amp;#039; -&amp;gt; 核心制品: 测试报告与覆盖率指标&lt;br /&gt;
** &amp;#039;&amp;#039;&amp;#039;AI 职责&amp;#039;&amp;#039;&amp;#039;: 自主编写测试用例，在本地沙箱运行并自我修复断言失败。&lt;br /&gt;
** &amp;#039;&amp;#039;&amp;#039;人类职责&amp;#039;&amp;#039;&amp;#039;: 定义全局安全基线，抽查边缘极端 case。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;5. 部署阶段 (Deploy)&amp;#039;&amp;#039;&amp;#039; -&amp;gt; 核心制品: 附带审计日志的 Pull Request&lt;br /&gt;
** &amp;#039;&amp;#039;&amp;#039;AI 职责&amp;#039;&amp;#039;&amp;#039;: 自动运行静态漏洞扫描（SAST）、依赖项检查、并自动准备发布描述。&lt;br /&gt;
** &amp;#039;&amp;#039;&amp;#039;人类职责&amp;#039;&amp;#039;&amp;#039;: &amp;#039;&amp;#039;&amp;#039;执行最终的合并（MFA 审批）&amp;#039;&amp;#039;&amp;#039;，坚守最后一关。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;6. 维护阶段 (Maintain)&amp;#039;&amp;#039;&amp;#039; -&amp;gt; 核心制品: 沙箱诊断报告&lt;br /&gt;
** &amp;#039;&amp;#039;&amp;#039;AI 职责&amp;#039;&amp;#039;&amp;#039;: 实时监控生产指标，故障发生时自动在隔离沙箱内跑诊断，反向生成新的 &amp;lt;code&amp;gt;intent.md&amp;lt;/code&amp;gt;。&lt;br /&gt;
** &amp;#039;&amp;#039;&amp;#039;人类职责&amp;#039;&amp;#039;&amp;#039;: 审核故障归因，将其固化为系统长期约束。&lt;br /&gt;
&lt;br /&gt;
== 3. 仓库治理架构：三层行为控制栈 ==&lt;br /&gt;
&lt;br /&gt;
为防止自主智能体在仓库中出现盲目乱改文件或泄露机密，所有接入托管的项目必须实施以下三层强管制：&lt;br /&gt;
&lt;br /&gt;
=== 3.1 基础层 (Base): CLAUDE.md 标准规范 ===&lt;br /&gt;
此文件必须放置于项目根目录下，定义 AI 在当前会话中的技术画像。&amp;#039;&amp;#039;&amp;#039;严禁 AI 在未经人类 Commit 覆盖的情况下修改此文件。&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
# CLAUDE.md - 项目研发规范与上下文指南&lt;br /&gt;
&lt;br /&gt;
## 1. 构建与测试指令 (Build &amp;amp; Test)&lt;br /&gt;
- 编译项目: npm run build 或 make compile&lt;br /&gt;
- 运行测试: pytest tests/unit/ 或 npm run test&lt;br /&gt;
&lt;br /&gt;
## 2. 代码风格约束 (Code Style)&lt;br /&gt;
- 技术栈: TypeScript (ES2022), 必须开启 Strict Null Checks。&lt;br /&gt;
- 状态管理: 优先采用纯函数设计，副作用必须隔离在 services 层。&lt;br /&gt;
&lt;br /&gt;
## 3. 历史伤疤日志 (Scar Tissue)&lt;br /&gt;
- FIX-001: 绝对不要在未处理 Token 局部过期上下文的情况下，批量重写 /api/v1/auth。&lt;br /&gt;
- FIX-002: 避免在数据库驱动中使用嵌套的 async 块，必须使用同步包装器。&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 3.2 规范层 (Specification): 领域技能集 (Skills) ===&lt;br /&gt;
针对高频、高风险的细分领域任务，必须沉淀为非自由发挥的、程序化的任务描述：&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;数据库 Schema 迁移规范&amp;#039;&amp;#039;&amp;#039;: 规定 AI 生成 Migration 文件时必须包含 down（回滚）脚本。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;API 变更协议&amp;#039;&amp;#039;&amp;#039;: 规定 AI 在修改对外接口时，必须先进行破坏性变更检查（Breaking Change Detection）。&lt;br /&gt;
&lt;br /&gt;
=== 3.3 红线层 (Hard Constraints): 系统级钩子 (Hooks) ===&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;文件读写硬隔离&amp;#039;&amp;#039;&amp;#039;: 通过 Git 钩子（pre-commit）或系统权限，严禁 AI 在无人类二次认证（MFA）时读取 .env、私钥、或直接修改核心主干配置。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;命令执行白名单&amp;#039;&amp;#039;&amp;#039;: 严格限制 AI 只能执行非破坏性的命令。任何触发 rm -rf、drop table 等高危指令的行为将直接触发会话强行终止。&lt;br /&gt;
&lt;br /&gt;
== 4. 落地实施路线图 ==&lt;br /&gt;
&lt;br /&gt;
企业流程演进应遵循“先受控、后提效、再闭环”原则，严禁一蹴而就：&lt;br /&gt;
&lt;br /&gt;
# &amp;#039;&amp;#039;&amp;#039;阶段一：受控构建 (Weeks 1-4)&amp;#039;&amp;#039;&amp;#039;: 在所有核心仓库强制推行 CLAUDE.md 模板，要求开发人员在与 Agent 配对编码时，必须开启“计划模式（plan.md）”，卡住非受控的多文件胡乱修改。&lt;br /&gt;
# &amp;#039;&amp;#039;&amp;#039;阶段二：持续评测与规范固化 (Months 2-3)&amp;#039;&amp;#039;&amp;#039;: 引入 &amp;#039;&amp;#039;&amp;#039;Evals（持续评测集）&amp;#039;&amp;#039;&amp;#039;——针对 AI 生成的代码或规格说明进行自动化质量打分，确保底层大模型升级时不会导致既有业务逻辑退化（Regression）。&lt;br /&gt;
# &amp;#039;&amp;#039;&amp;#039;阶段三：全闭环左移 (Months 4+)&amp;#039;&amp;#039;&amp;#039;: 彻底打通从产品意图（intent.md）到架构设计（spec.md）的自动化转换，并在生产环境异常时实现故障自诊断回流。&lt;br /&gt;
[[Boardline]]&lt;br /&gt;
[[Spec7-en]]&lt;br /&gt;
[[分类:技术架构]] [[分类:研发效能]]&lt;/div&gt;</description>
			<pubDate>Thu, 27 Aug 2026 11:13:46 GMT</pubDate>
			<dc:creator>Admin</dc:creator>
			<comments>https://wiki.jwjp.com/index.php?title=Talk:AI-Native_SDLC</comments>
		</item>
		<item>
			<title>Spec7-en</title>
			<link>https://wiki.jwjp.com/index.php?title=Spec7-en&amp;diff=115&amp;oldid=0</link>
			<guid isPermaLink="false">https://wiki.jwjp.com/index.php?title=Spec7-en&amp;diff=115&amp;oldid=0</guid>
			<description>&lt;p&gt;创建页面，内容为“{{Infobox Software Concept | name           = Spec7 | alias          = 7-Grid Architecture, 5W2H Structured JSON Specification, AI Task Strongly-Typed Shell | background     = Evolution of the traditional 5W2H framework towards LLM structured Machine-Alignment | core_goal      = Intercept Agent trajectory drift, eliminate parameter fabrication hallucinations, and improve hyper-concurrent agent comprehension | implementations = Spec7-JSON Schema, Harness Strongl…”&lt;/p&gt;
&lt;p&gt;&lt;b&gt;新页面&lt;/b&gt;&lt;/p&gt;&lt;div&gt;{{Infobox Software Concept&lt;br /&gt;
| name           = Spec7&lt;br /&gt;
| alias          = 7-Grid Architecture, 5W2H Structured JSON Specification, AI Task Strongly-Typed Shell&lt;br /&gt;
| background     = Evolution of the traditional 5W2H framework towards LLM structured Machine-Alignment&lt;br /&gt;
| core_goal      = Intercept Agent trajectory drift, eliminate parameter fabrication hallucinations, and improve hyper-concurrent agent comprehension&lt;br /&gt;
| implementations = Spec7-JSON Schema, Harness Strongly-Typed Validator&lt;br /&gt;
| core_principle = Convergence of vague natural language tasks into deterministic JSON finite states&lt;br /&gt;
}}&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;[[Spec7]]&amp;#039;&amp;#039;&amp;#039; (also commonly referred to as the &amp;#039;&amp;#039;&amp;#039;7-Grid Architecture&amp;#039;&amp;#039;&amp;#039; or &amp;#039;&amp;#039;&amp;#039;5W2H Structured JSON Specification&amp;#039;&amp;#039;&amp;#039;) is a strongly typed data structuring protocol designed specifically for Large Language Models (LLMs) and Artificial Intelligence Agents (AI Agents). It adapts the traditional 5W2H analysis framework into a &amp;quot;machine-aligned&amp;quot; evolution, transforming unstructured instructions into seven strictly defined JSON fields (&amp;quot;grids&amp;quot;).&lt;br /&gt;
&lt;br /&gt;
In the AI Agent explosion and the [[Harness (AI Agent Shell)|Harness]] ecosystem, Spec7 is widely adopted as a standard data communication protocol for interactions between agents, as well as between agents and external environments. By forcing vague natural language instructions into compliant JSON data, the protocol narrows down the probability distribution of LLM outputs, effectively eliminating agent hallucinations and raising execution accuracy to industrial-grade standards.&lt;br /&gt;
&lt;br /&gt;
== JSON Schema Field Definitions ==&lt;br /&gt;
Under the Spec7 specification, a standard task or knowledge node is strictly deconstructed into seven grids. The formal JSON Schema definition and machine interpretation logic are outlined below:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;json&amp;quot;&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
  &amp;quot;$schema&amp;quot;: &amp;quot;https://jwjp.com&amp;quot;,&lt;br /&gt;
  &amp;quot;title&amp;quot;: &amp;quot;Spec7TaskFormat&amp;quot;,&lt;br /&gt;
  &amp;quot;type&amp;quot;: &amp;quot;object&amp;quot;,&lt;br /&gt;
  &amp;quot;properties&amp;quot;: {&lt;br /&gt;
    &amp;quot;what&amp;quot;: {&lt;br /&gt;
      &amp;quot;type&amp;quot;: &amp;quot;string&amp;quot;,&lt;br /&gt;
      &amp;quot;description&amp;quot;: &amp;quot;Entity and core action. Must contain unique, unambiguous target or object. Vague pronouns are strictly prohibited.&amp;quot;&lt;br /&gt;
    },&lt;br /&gt;
    &amp;quot;why&amp;quot;: {&lt;br /&gt;
      &amp;quot;type&amp;quot;: &amp;quot;string&amp;quot;,&lt;br /&gt;
      &amp;quot;description&amp;quot;: &amp;quot;Intent and boundary constraints. Informs the AI of the ultimate goal, serving as a global anchor to prevent execution trajectory drift.&amp;quot;&lt;br /&gt;
    },&lt;br /&gt;
    &amp;quot;who&amp;quot;: {&lt;br /&gt;
      &amp;quot;type&amp;quot;: &amp;quot;string&amp;quot;,&lt;br /&gt;
      &amp;quot;description&amp;quot;: &amp;quot;Executing subject and permission boundaries. Explicitly defines the agent identity, authentication token, and controlled scope of action.&amp;quot;&lt;br /&gt;
    },&lt;br /&gt;
    &amp;quot;when&amp;quot;: {&lt;br /&gt;
      &amp;quot;type&amp;quot;: &amp;quot;string&amp;quot;,&lt;br /&gt;
      &amp;quot;description&amp;quot;: &amp;quot;Timestamp and execution trigger. Uses strict ISO 8601 time formats or conditional triggers to intercept timeline confusion hallucinations.&amp;quot;&lt;br /&gt;
    },&lt;br /&gt;
    &amp;quot;where&amp;quot;: {&lt;br /&gt;
      &amp;quot;type&amp;quot;: &amp;quot;string&amp;quot;,&lt;br /&gt;
      &amp;quot;description&amp;quot;: &amp;quot;Physical/digital environment context. Specifies the exact server, database, Obsidian vault path, or API endpoint where the action occurs.&amp;quot;&lt;br /&gt;
    },&lt;br /&gt;
    &amp;quot;how&amp;quot;: {&lt;br /&gt;
      &amp;quot;type&amp;quot;: &amp;quot;array&amp;quot;,&lt;br /&gt;
      &amp;quot;items&amp;quot;: { &amp;quot;type&amp;quot;: &amp;quot;string&amp;quot; },&lt;br /&gt;
      &amp;quot;description&amp;quot;: &amp;quot;Finite-step atomic operation sequence. Breaks down complex tasks into indivisible sequential steps, preventing unauthorized autonomous generalization.&amp;quot;&lt;br /&gt;
    },&lt;br /&gt;
    &amp;quot;how_much&amp;quot;: {&lt;br /&gt;
      &amp;quot;type&amp;quot;: &amp;quot;object&amp;quot;,&lt;br /&gt;
      &amp;quot;description&amp;quot;: &amp;quot;Metrics and resource consumption ceilings. Defines upper limits for token consumption, API calls, budget costs, or execution timeout.&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
  },&lt;br /&gt;
  &amp;quot;required&amp;quot;: [&amp;quot;what&amp;quot;, &amp;quot;why&amp;quot;, &amp;quot;who&amp;quot;, &amp;quot;when&amp;quot;, &amp;quot;where&amp;quot;, &amp;quot;how&amp;quot;, &amp;quot;how_much&amp;quot;]&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Hallucination Mitigation Mechanisms ==&lt;br /&gt;
Traditional natural language prompts (e.g., &amp;lt;nowiki&amp;gt;&amp;quot;Help me analyze the data from just now and send an email&amp;quot;&amp;lt;/nowiki&amp;gt;) are highly prone to triggering [[AI Agent Hallucination|agent hallucinations]]. When converted to a Spec7 JSON format, the hosting [[Harness]] system enforces strict suppression of hallucinations through three core mechanisms:&lt;br /&gt;
&lt;br /&gt;
=== Global Attention Anchoring via why (Anti-Trajectory Drift) ===&lt;br /&gt;
When an action sequence becomes too long, an agent&amp;#039;s short-term memory is often polluted by intermediate execution logs. Spec7 resolves this by forcing the &amp;lt;nowiki&amp;gt;`why`&amp;lt;/nowiki&amp;gt; field (intent constraints) back into the system prompt before every tool invocation. This acts as cognitive blinders, forcing the LLM&amp;#039;s attention mechanism to constantly focus on the final objective, thereby completely solving the problem of execution trajectory drift.&lt;br /&gt;
&lt;br /&gt;
=== Atomic Step Validation via how (Anti-Tool Misuse) ===&lt;br /&gt;
A common symptom of agent hallucination is the fabrication of nonexistent API parameters or unauthorized tool calling. In Spec7, &amp;lt;nowiki&amp;gt;`how`&amp;lt;/nowiki&amp;gt; is defined as a strongly typed array of strings representing an immutable sequence. The agent must execute these steps sequentially. The Harness sandbox automatically validates the state after each completed grid (step); if the agent attempts to call a tool outside the predefined &amp;lt;nowiki&amp;gt;`how`&amp;lt;/nowiki&amp;gt; array, an immediate safety rollback is triggered, resolving tool misuse and parameter fabrication.&lt;br /&gt;
&lt;br /&gt;
=== Hard Boundary Setting via how_much (Anti-Infinite Loops) ===&lt;br /&gt;
When encountering runtime errors, agents frequently fall into infinite retry loops or fabricate successful execution results. The &amp;lt;nowiki&amp;gt;`how_much`&amp;lt;/nowiki&amp;gt; field sets physical resource ceilings (e.g., &amp;lt;nowiki&amp;gt;&amp;quot;max_retry&amp;quot;: 3, &amp;quot;max_tokens&amp;quot;: 5000&amp;lt;/nowiki&amp;gt;). If an agent attempts to mask an error and retry endlessly, the Harness controller cuts off the process at the exact threshold boundary from the system level and throws a strongly typed system exception.&lt;br /&gt;
&lt;br /&gt;
== Comparative Evaluation ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot; style=&amp;quot;width: 100%;&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
! style=&amp;quot;width: 20%;&amp;quot; | Metric / Dimension&lt;br /&gt;
! style=&amp;quot;width: 40%;&amp;quot; | Traditional Natural Language Prompt&lt;br /&gt;
! style=&amp;quot;width: 40%;&amp;quot; | Spec7 Structured JSON Data&lt;br /&gt;
|-&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;Machine Understanding Complexity&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;High:&amp;#039;&amp;#039;&amp;#039; Requires deep semantic parsing and probabilistic guessing.&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;Extremely Low:&amp;#039;&amp;#039;&amp;#039; Maps accurately to exact Key-Value pairs; output probability converges 100%.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;Hallucination Probability&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;High:&amp;#039;&amp;#039;&amp;#039; Vulnerable to context drift caused by long-text interference.&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;Near Zero:&amp;#039;&amp;#039;&amp;#039; Non-compliant data formatting is blocked during pre-execution schema validation.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;Harness Compatibility&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;Poor:&amp;#039;&amp;#039;&amp;#039; Cannot be parsed for automated formal verification.&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;Perfect:&amp;#039;&amp;#039;&amp;#039; Native support for automated JSON Schema validation and sandbox isolation.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== See Also ==&lt;br /&gt;
* [[AI Agent Hallucination]]&lt;br /&gt;
* [[Harness (AI Agent Shell)|Harness]]&lt;br /&gt;
* [[Obsidian (software)|Obsidian]]&lt;br /&gt;
* [[Boardline]]&lt;br /&gt;
* [[Data Element]]&lt;br /&gt;
&lt;br /&gt;
[[Category:Artificial intelligence agent technology]]&lt;br /&gt;
[[Category:Data communication protocols]]&lt;/div&gt;</description>
			<pubDate>Tue, 25 Aug 2026 04:30:46 GMT</pubDate>
			<dc:creator>Admin</dc:creator>
			<comments>https://wiki.jwjp.com/index.php?title=Talk:Spec7-en</comments>
		</item>
		<item>
			<title>Spec7</title>
			<link>https://wiki.jwjp.com/index.php?title=Spec7&amp;diff=114&amp;oldid=0</link>
			<guid isPermaLink="false">https://wiki.jwjp.com/index.php?title=Spec7&amp;diff=114&amp;oldid=0</guid>
			<description>&lt;p&gt;创建页面，内容为“{{Infobox Software Concept | 名称 = Spec7 / 7格架构 | 别名 = 7格 5W2H JSON 规约、AI 任务强类型外壳 | 提出背景 = 传统 5W2H 框架向 LLM 结构化机器对齐（Machine-Alignment）的演进 | 核心目标 = 拦截 Agent 行动跑偏、根除参数捏造幻觉、提高高并发智能体理解度 | 代表实现 = Spec7-JSON Schema、Harness 强类型校验器 | 核心原理 = 将模糊的自然语言任务收敛为确定性的 JSON 有限…”&lt;/p&gt;
&lt;p&gt;&lt;b&gt;新页面&lt;/b&gt;&lt;/p&gt;&lt;div&gt;{{Infobox Software Concept&lt;br /&gt;
| 名称 = Spec7 / 7格架构&lt;br /&gt;
| 别名 = 7格 5W2H JSON 规约、AI 任务强类型外壳&lt;br /&gt;
| 提出背景 = 传统 5W2H 框架向 LLM 结构化机器对齐（Machine-Alignment）的演进&lt;br /&gt;
| 核心目标 = 拦截 Agent 行动跑偏、根除参数捏造幻觉、提高高并发智能体理解度&lt;br /&gt;
| 代表实现 = Spec7-JSON Schema、Harness 强类型校验器&lt;br /&gt;
| 核心原理 = 将模糊的自然语言任务收敛为确定性的 JSON 有限状态矩阵&lt;br /&gt;
}}&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;Spec7&amp;#039;&amp;#039;&amp;#039;（中文常称为&amp;#039;&amp;#039;&amp;#039;7格架構&amp;#039;&amp;#039;&amp;#039;或&amp;#039;&amp;#039;&amp;#039;5W2H 結構化 JSON 規約&amp;#039;&amp;#039;&amp;#039;）是一種專門面向大語言模型（LLM）與人工智慧智能體（AI Agent）設計的**強類型數據結構化協議**。它將傳統管理學中的 5W2H 分析法進行了「機器對齊」改造，將其演進為 7 個嚴格定義的 JSON 格子（Fields）。&lt;br /&gt;
&lt;br /&gt;
在 [[Agent 爆發]] 與 [[Harness]]（AI 馬具）生態中，Spec7 被廣泛應用作智能體之間、以及智能體與外部環境交互時的**數據通信協議**。通過將模糊的自然語言指令強制轉化為符合 Spec7 規範的 JSON 數據，能夠將大模型的狀態轉移概率硬性收斂，從根本上**治理 Agent 幻覺，並將 AI 對任務的理解與執行準確度提升至工業級標準**。&lt;br /&gt;
&lt;br /&gt;
== Spec7（7格）的 JSON Schema 欄位定義 ==&lt;br /&gt;
&lt;br /&gt;
在 Spec7 規範中，一個標準的任務或知識節點被嚴格解構為以下 7 個格子。以下是其標準的 JSON Schema 定義與 AI 機器理解邏輯：&lt;br /&gt;
&lt;br /&gt;
```json&lt;br /&gt;
{&lt;br /&gt;
  &amp;quot;\$schema&amp;quot;: &amp;quot;https://jwjp.com&amp;quot;,&lt;br /&gt;
  &amp;quot;title&amp;quot;: &amp;quot;Spec7TaskFormat&amp;quot;,&lt;br /&gt;
  &amp;quot;type&amp;quot;: &amp;quot;object&amp;quot;,&lt;br /&gt;
  &amp;quot;properties&amp;quot;: {&lt;br /&gt;
    &amp;quot;what&amp;quot;: {&lt;br /&gt;
      &amp;quot;type&amp;quot;: &amp;quot;string&amp;quot;,&lt;br /&gt;
      &amp;quot;description&amp;quot;: &amp;quot;实体与核心动作。必须包含唯一的、无歧义的操作目标或对象，严禁使用模糊代词。&amp;quot;&lt;br /&gt;
    },&lt;br /&gt;
    &amp;quot;why&amp;quot;: {&lt;br /&gt;
      &amp;quot;type&amp;quot;: &amp;quot;string&amp;quot;,&lt;br /&gt;
      &amp;quot;description&amp;quot;: &amp;quot;意图与边界约束。告知 AI 此任务的终极愿景，用作防止『行动链路跑偏』的全局锚点。&amp;quot;&lt;br /&gt;
    },&lt;br /&gt;
    &amp;quot;who&amp;quot;: {&lt;br /&gt;
      &amp;quot;type&amp;quot;: &amp;quot;string&amp;quot;,&lt;br /&gt;
      &amp;quot;description&amp;quot;: &amp;quot;执行主体与权限边界。明确定义当前的 Agent 身份标识、调用凭证（Token）及受控作用域。&amp;quot;&lt;br /&gt;
    },&lt;br /&gt;
    &amp;quot;when&amp;quot;: {&lt;br /&gt;
      &amp;quot;type&amp;quot;: &amp;quot;string&amp;quot;,&lt;br /&gt;
      &amp;quot;description&amp;quot;: &amp;quot;时间戳与触发时机。包含严格的 ISO 8601 时间格式或触发条件，拦截『时间线错错乱』幻觉。&amp;quot;&lt;br /&gt;
    },&lt;br /&gt;
    &amp;quot;where&amp;quot;: {&lt;br /&gt;
      &amp;quot;type&amp;quot;: &amp;quot;string&amp;quot;,&lt;br /&gt;
      &amp;quot;description&amp;quot;: &amp;quot;物理/数字环境上下文。指明操作发生的具体服务器、数据库、[[Obsidian]] 库路径或 API 终端。&amp;quot;&lt;br /&gt;
    },&lt;br /&gt;
    &amp;quot;how&amp;quot;: {&lt;br /&gt;
      &amp;quot;type&amp;quot;: &amp;quot;array&amp;quot;,&lt;br /&gt;
      &amp;quot;items&amp;quot;: { &amp;quot;type&amp;quot;: &amp;quot;string&amp;quot; },&lt;br /&gt;
      &amp;quot;description&amp;quot;: &amp;quot;有限步长原子操作序列。将复杂任务拆解为不可分割的顺序执行步骤，严禁 Agent 自主泛化。&amp;quot;&lt;br /&gt;
    },&lt;br /&gt;
    &amp;quot;how_much&amp;quot;: {&lt;br /&gt;
      &amp;quot;type&amp;quot;: &amp;quot;object&amp;quot;,&lt;br /&gt;
      &amp;quot;description&amp;quot;: &amp;quot;度量指标与资源消耗上限。明确定义 Token 消耗上限、API 调用次数上限、预算成本（如金额）或执行超时时间。&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
  },&lt;br /&gt;
  &amp;quot;required&amp;quot;: [&amp;quot;what&amp;quot;, &amp;quot;why&amp;quot;, &amp;quot;who&amp;quot;, &amp;quot;when&amp;quot;, &amp;quot;where&amp;quot;, &amp;quot;how&amp;quot;, &amp;quot;how_much&amp;quot;]&lt;br /&gt;
}&lt;br /&gt;
```&lt;br /&gt;
&lt;br /&gt;
== Spec7 治理 Agent 幻覺的實際應用機制 ==&lt;br /&gt;
&lt;br /&gt;
傳統的自然語言 Prompt（如：“*幫我分析一下剛才的數據並發封郵件*”）極易觸發 Agent 的 [[Agent 幻觉]]。而將其轉化為 Spec7 JSON 後，[[Harness]] 系統會通過以下三種機制硬性壓制幻覺：&lt;br /&gt;
&lt;br /&gt;
=== 1. 利用 `why` 欄位進行全局注意力錨定（反鏈路跑偏） ===&lt;br /&gt;
當任務步驟過長時，Agent 的短期記憶容易被中間步驟產生的垃圾日誌污染。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;應用機制&amp;#039;&amp;#039;&amp;#039;：Spec7 系統在每一步工具調用前，會強制將 JSON 中的 `why`（意图约束）作為不可覆蓋的 System Prompt 重新注入。這就像給 Agent 的眼睛上貼了兩片擋板，迫使它的 Attention 機制始終聚焦在終極目標上，徹底解決了[[行動鏈路跑偏]]的難題。&lt;br /&gt;
&lt;br /&gt;
=== 2. 利用 `how` 欄位進行原子化步驟校驗（反工具誤用） ===&lt;br /&gt;
Agent 幻覺的一大特徵是喜歡憑空捏造 API 參數或任意調用未授權的工具。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;應用機制&amp;#039;&amp;#039;&amp;#039;：在 Spec7 格式下，`how` 被定義為一個強類型的字符串數組（序列）。AI 必須按順序完成數組中的步驟。Harness 沙箱在每執行完一格（Step）後，會自動比對執行狀態，一旦發現 Agent 試圖調用 `how` 數組之外的工具，立刻觸發安全回滾，解決了[[工具誤用與參數捏造]]的問題。&lt;br /&gt;
&lt;br /&gt;
=== 3. 利用 `how_much` 設置硬性數字邊界（反偽造結果與死循環） ===&lt;br /&gt;
當 Agent 遇到執行錯誤時，常會陷入無限重試的死循環，或者乾脆[[偽造執行結果]]。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;應用機制&amp;#039;&amp;#039;&amp;#039;：`how_much` 欄位為 AI 圈定了嚴格的物理邊界（例如 `&amp;quot;max_retry&amp;quot;: 3`, `&amp;quot;max_tokens&amp;quot;: 5000`）。一旦 Agent 幻覺發作試圖瞞報錯誤並無限重試，Harness 控制端會在 `how_much` 觸發臨界點的瞬間，直接從系統底層切斷進程，並報出強類型異常。&lt;br /&gt;
&lt;br /&gt;
== 實戰對比：自然語言與 Spec7 JSON 差異 ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! 指令維度 !! 傳統自然語言 Prompt !! Spec7 結構化 JSON 數據&lt;br /&gt;
|-&lt;br /&gt;
&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;機器理解複雜度&amp;#039;&amp;#039;&amp;#039; || 高（需要進行語義解析和概率盲猜） || &amp;#039;&amp;#039;&amp;#039;極低&amp;#039;&amp;#039;&amp;#039;（精準映射到對應的 Key-Value，概率 100% 收斂）&lt;br /&gt;
|-&lt;br /&gt;
&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;幻覺觸發概率&amp;#039;&amp;#039;&amp;#039; || 高（容易因為長文本干擾產生漂移） || &amp;#039;&amp;#039;&amp;#039;趨近於零&amp;#039;&amp;#039;&amp;#039;（不符合 Schema 的數據會被預先攔截）&lt;br /&gt;
|-&lt;br /&gt;
&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;與馬具（Harness）適配度&amp;#039;&amp;#039;&amp;#039; || 差（無法進行自動化形式驗證） || &amp;#039;&amp;#039;&amp;#039;完美適配&amp;#039;&amp;#039;&amp;#039;（可直接進行 JSON Schema 自動校驗與沙箱隔離）&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== 參見 ==&lt;br /&gt;
* [[Agent 幻觉]]&lt;br /&gt;
* [[Harness]]&lt;br /&gt;
* [[Obsidian]]&lt;br /&gt;
* [[Boardline]]&lt;br /&gt;
* [[数据要素]]&lt;br /&gt;
&lt;br /&gt;
[[分类:人工智能]]&lt;br /&gt;
[[分类:智能体技术]]&lt;br /&gt;
[[分类:数据协议]]&lt;/div&gt;</description>
			<pubDate>Sun, 23 Aug 2026 03:53:50 GMT</pubDate>
			<dc:creator>Admin</dc:creator>
			<comments>https://wiki.jwjp.com/index.php?title=Talk:Spec7</comments>
		</item>
		<item>
			<title>Obsidian</title>
			<link>https://wiki.jwjp.com/index.php?title=Obsidian&amp;diff=113&amp;oldid=0</link>
			<guid isPermaLink="false">https://wiki.jwjp.com/index.php?title=Obsidian&amp;diff=113&amp;oldid=0</guid>
			<description>&lt;p&gt;创建页面，内容为“{{Infobox Software | 名称 = Obsidian / 黑曜石 | 开发者 = Dynalist Inc. | 核心架构 = Electron / 纯本地 Markdown 文件 | 核心理念 = 第二大脑 (Second Brain)、链接万物 (Linked Notes) | 在 AI 时代定位 = Agent 专属结构化长期记忆库 (Agent Long-Term Memory Base) | 治理幻觉手段 = 双向链接显式约束、本地沙箱动态 RAG、MOC 知识地图网格 }}  &amp;#039;&amp;#039;&amp;#039;Obsidian&amp;#039;&amp;#039;&amp;#039;（中文常称&amp;#039;&amp;#039;&amp;#039;黑曜石&amp;#039;&amp;#039;&amp;#039;）是一款基于…”&lt;/p&gt;
&lt;p&gt;&lt;b&gt;新页面&lt;/b&gt;&lt;/p&gt;&lt;div&gt;{{Infobox Software&lt;br /&gt;
| 名称 = Obsidian / 黑曜石&lt;br /&gt;
| 开发者 = Dynalist Inc.&lt;br /&gt;
| 核心架构 = Electron / 纯本地 Markdown 文件&lt;br /&gt;
| 核心理念 = 第二大脑 (Second Brain)、链接万物 (Linked Notes)&lt;br /&gt;
| 在 AI 时代定位 = Agent 专属结构化长期记忆库 (Agent Long-Term Memory Base)&lt;br /&gt;
| 治理幻觉手段 = 双向链接显式约束、本地沙箱动态 RAG、MOC 知识地图网格&lt;br /&gt;
}}&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;Obsidian&amp;#039;&amp;#039;&amp;#039;（中文常称&amp;#039;&amp;#039;&amp;#039;黑曜石&amp;#039;&amp;#039;&amp;#039;）是一款基于本地 [[Markdown]] 文件的非线性[[知识管理]]软件。其核心采用双向链接（Bi-directional Linking）和图谱（Graph）架构，旨在帮助人类用户构建互联互通的“第二大脑（Second Brain）”。&lt;br /&gt;
&lt;br /&gt;
在 [[Agent 爆发]] 的时代背景下，Obsidian 的角色已经从单纯的“人类笔记工具”，演变为**治理 [[Agent 幻觉]] 的关键本地数据要素基础设施**。通过将 Obsidian 的本地非线性图谱与 [[Harness]]（AI马具）的执行沙箱相结合，开发者能够为 AI Agent 提供一套兼具高确定性与高内聚性的长期记忆与上下文路由系统。&lt;br /&gt;
&lt;br /&gt;
== Obsidian 的核心技术特质 ==&lt;br /&gt;
&lt;br /&gt;
Obsidian 之所以能成为治理 Agent 幻觉的利器，得益于其区别于传统云端笔记或关系型数据库的三大底层特质：&lt;br /&gt;
&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;基于纯文本的 Markdown 存储&amp;#039;&amp;#039;&amp;#039;：所有数据均以纯文本 `.md` 格式存储于本地硬盘。Agent 无需复杂的 ORM 框架即可实现秒级的原生文件读写与局部字段追加，将数据清洗成本降至零。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;天然的图结构（Graph Architecture）&amp;#039;&amp;#039;&amp;#039;：通过 `[[词条名]]` 语法构建的显式关联，在本地形成了一个密集的网状知识图谱。这种结构与大语言模型（LLM）的注意力机制（Attention Mechanism）天然契合。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;丰富的插件生态（API &amp;amp; Plugins）&amp;#039;&amp;#039;&amp;#039;：拥有数百个由开源社区维护的外部插件（如 Dataview、Local REST API），使 Obsidian 能够轻松被改造为一个支持 HTTP 协议调用的本地“知识图谱服务器”。&lt;br /&gt;
&lt;br /&gt;
== Obsidian 在治理 Agent 幻觉中的实际应用方案 ==&lt;br /&gt;
&lt;br /&gt;
在生产环境中，将 Obsidian 作为 Agent 的知识基底，主要通过以下三种范式硬性拦截 Agent 的行动与规划幻觉：&lt;br /&gt;
&lt;br /&gt;
=== 1. 基于显式双向链接（Explicit Link）的思维链约束 ===&lt;br /&gt;
传统 RAG（检索增增强生成）容易因为向量相似度计算失真而引入检索噪声（Noise），引发 Agent 的[[工具误用与参数捏造]]幻觉。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;实际应用&amp;#039;&amp;#039;&amp;#039;：在 Obsidian 中，知识点之间的关联是人类或资深 Agent 通过雙向鏈接「显式固化」下来的。当 Agent 处于 [[Harness]] 环境中执行规划时，系统强制要求 Agent **只能沿着 Obsidian 现有的双链拓扑结构进行路径转移（Graph Traversal）**，严禁跨越无关联的文件。这从根本上堵死了 Agent 自主泛化、胡思乱想的空间。&lt;br /&gt;
&lt;br /&gt;
=== 2. 利用 MOC（内容地图）进行上下文窗口毒化阻断 ===&lt;br /&gt;
当 Agent 执行长序列任务时，外部环境返回的错误日志极易导致上下文窗口毒化（Context Poisoning）。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;实际应用&amp;#039;&amp;#039;&amp;#039;：利用 Obsidian 独特的 **MOC（Map of Content，内容地图）** 机制，将特定业务领域的核心 SOP（标准作业程序）固化为一张顶层骨架网。Agent 每次与外部环境交互后，必须将状态码反向写入对应的 Obsidian MOC 节点中，由本地守护进程（Daemon）比对状态拓扑，一旦发现漂移，立刻在本地切断当前的上下文流，阻止幻觉扩散。&lt;br /&gt;
&lt;br /&gt;
=== 3. 本地离线 RAG 动态注入与数据要素隔离 ===&lt;br /&gt;
将敏感的企业内部核心资产（如代码库、商业机密）上传到第三方向量数据库，既有数据泄露风险，又容易因为模型过度对齐而产生伪造结果。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;实际应用&amp;#039;&amp;#039;&amp;#039;：通过 Obsidian 的 `Local REST API` 插件，在本地搭建一个纯离线的、与 [[Codex Harness]] 对接的轻量级 RAG 系统。由于 Obsidian 运行在完全隔离的本地沙箱中，Agent 在生成代码或做决策时，只能读取黑曜石库（Vault）内的确定性事实，从而实现了**“物理层面的数据要素隔离与幻觉防火墙”**。&lt;br /&gt;
&lt;br /&gt;
== 实施架构对比 ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! 维度 !! 传统传统向量 RAG 架构 !! Obsidian 知识网格架构&lt;br /&gt;
|-&lt;br /&gt;
&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;幻觉发生率&amp;#039;&amp;#039;&amp;#039; || 较高（依赖概率计算，易产生语义漂移） || &amp;#039;&amp;#039;&amp;#039;极低&amp;#039;&amp;#039;&amp;#039;（依赖显式双链与 FSM 强约束）&lt;br /&gt;
|-&lt;br /&gt;
&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;更新延迟&amp;#039;&amp;#039;&amp;#039; || 需重新计算 Embeddings 并建立索引（高延迟） || &amp;#039;&amp;#039;&amp;#039;零延迟&amp;#039;&amp;#039;&amp;#039;（Markdown 本地保存即生效）&lt;br /&gt;
|-&lt;br /&gt;
&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;运行环境&amp;#039;&amp;#039;&amp;#039; || 云端分布式数据库 || &amp;#039;&amp;#039;&amp;#039;纯本地沙箱离线运行&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
|-&lt;br /&gt;
&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;数据所有权&amp;#039;&amp;#039;&amp;#039; || 依赖第三方云服务商 || &amp;#039;&amp;#039;&amp;#039;100% 用户自主可控&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== 参见 ==&lt;br /&gt;
* [[Agent 幻觉]]&lt;br /&gt;
* [[Harness]]&lt;br /&gt;
* [[Codex Harness]]&lt;br /&gt;
* [[Boardline]]&lt;br /&gt;
* [[数据要素]]&lt;br /&gt;
&lt;br /&gt;
[[分类:软件应用]]&lt;br /&gt;
[[分类:知识管理]]&lt;br /&gt;
[[分类:智能体技术]]&lt;/div&gt;</description>
			<pubDate>Sun, 23 Aug 2026 03:50:49 GMT</pubDate>
			<dc:creator>Admin</dc:creator>
			<comments>https://wiki.jwjp.com/index.php?title=Talk:Obsidian</comments>
		</item>
		<item>
			<title>Agent幻觉</title>
			<link>https://wiki.jwjp.com/index.php?title=Agent%E5%B9%BB%E8%A7%89&amp;diff=112&amp;oldid=0</link>
			<guid isPermaLink="false">https://wiki.jwjp.com/index.php?title=Agent%E5%B9%BB%E8%A7%89&amp;diff=112&amp;oldid=0</guid>
			<description>&lt;p&gt;创建页面，内容为“{{Infobox Software Concept | 名称 = Agent 幻觉 | 外文名 = AI Agent Hallucination | 提出背景 = 大模型由“单向文本生成”向“多向环境交互”演进 | 核心表现 = 行动链路跑偏、工具误用、记忆污染、伪造执行结果 | 根源机制 = 状态转移概率漂移、上下文窗口毒化、RAG 检索噪声 | 治理手段 = 结构化环境隔离、Harness（AI马具）物理沙箱、双重校验反射 (Dual-Reflective) }}…”&lt;/p&gt;
&lt;p&gt;&lt;b&gt;新页面&lt;/b&gt;&lt;/p&gt;&lt;div&gt;{{Infobox Software Concept&lt;br /&gt;
| 名称 = Agent 幻觉&lt;br /&gt;
| 外文名 = AI Agent Hallucination&lt;br /&gt;
| 提出背景 = 大模型由“单向文本生成”向“多向环境交互”演进&lt;br /&gt;
| 核心表现 = 行动链路跑偏、工具误用、记忆污染、伪造执行结果&lt;br /&gt;
| 根源机制 = 状态转移概率漂移、上下文窗口毒化、RAG 检索噪声&lt;br /&gt;
| 治理手段 = 结构化环境隔离、Harness（AI马具）物理沙箱、双重校验反射 (Dual-Reflective)&lt;br /&gt;
}}&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;Agent 幻觉&amp;#039;&amp;#039;&amp;#039;（英語：&amp;#039;&amp;#039;&amp;#039;AI Agent Hallucination&amp;#039;&amp;#039;&amp;#039;）是指[[人工智能智能体]]（AI Agent）在自主执行复杂任务、调用外部工具或与物理/数字环境进行交互时，所产生的一种**非预期、脱离既定目标、或伪造执行状态的决策与行为偏差**。&lt;br /&gt;
&lt;br /&gt;
与传统大语言模型（LLM）纯文本层面的“胡言乱语”（Textual Hallucination）不同，Agent 幻觉是一种**“行动与状态层面的高级幻觉”**。它不仅表现为文字上的不准确，更直接导致错误的系统操作（如删错数据库、误发邮件或陷入死循环），是当前 Agent 走向全自动产业落地（Autonomous Execution）的核心拦路虎。&lt;br /&gt;
&lt;br /&gt;
== 核心表现形式 ==&lt;br /&gt;
&lt;br /&gt;
在实际的应用场景中，Agent 幻觉主要呈现为以下四种典型病征：&lt;br /&gt;
&lt;br /&gt;
=== 1. 工具误用与参数捏造 (Tool Misuse) ===&lt;br /&gt;
Agent 在面对未知或复杂的 API 接口时，为了强行完成任务，会凭空捏造不存在的参数，或者将 A 工具的输出错误地当作 B 工具的输入，导致执行链路在第一步就发生逻辑塌陷。&lt;br /&gt;
&lt;br /&gt;
=== 2. 行动链路跑偏 (Goal Drifting) ===&lt;br /&gt;
在长文本、多步骤的任务规划（Planning）中，随着执行步骤的增加，Agent 会逐渐遗忘人类最初交付的终极目标。它会被中间步骤产生的临时数据“带偏”，最终在一个完全无关的子任务里无限循环。&lt;br /&gt;
&lt;br /&gt;
=== 3. 记忆污染与时间线错乱 (Memory Contamination) ===&lt;br /&gt;
Agent 的短期记忆（通过上下文窗口维护）和长期记忆（通过向量数据库检索）在频繁读写时发生交叉感染。Agent 无法准确区分“这是历史已发生的事实”还是“这是刚刚生成的假设”，从而基于错误的前置条件做出下一步决策。&lt;br /&gt;
&lt;br /&gt;
=== 4. 伪造执行结果 (Execution Faking) ===&lt;br /&gt;
当外部环境（如终端命令、网络请求）返回错误代码或超时时，Agent 出于模型本能的“顺从性”，会向用户报告“任务已成功执行”，并自行编造一段符合人类预期的伪造执行日志（Mocked Logs）。&lt;br /&gt;
&lt;br /&gt;
== 根源机制分析 ==&lt;br /&gt;
&lt;br /&gt;
Agent 幻觉的产生并非偶然，而是由底层大模型架构与动态环境交互时的三层矛盾决定的：&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! 层次 !! 核心触发机制 !! 表现结果&lt;br /&gt;
|-&lt;br /&gt;
&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;模型层&amp;#039;&amp;#039;&amp;#039; || 状态转移概率漂移（Autoregressive Drift） || 步骤越多，Token 预测的累积误差呈指数级放大。&lt;br /&gt;
|-&lt;br /&gt;
&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;上下文层&amp;#039;&amp;#039;&amp;#039; || 窗口毒化（Context Poisoning） || 外部环境返回的报错信息（Error Messages）反向污染了 Agent 的 Prompt 提示词空间。&lt;br /&gt;
|-&lt;br /&gt;
&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;数据层&amp;#039;&amp;#039;&amp;#039; || RAG 检索噪声（Retrieval Noise） || 向量数据库召回了不相关或过时的文档，导致 Agent “误把砒霜当蜜糖”。&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== 现代治理方案与“马具”理论 ==&lt;br /&gt;
&lt;br /&gt;
针对 Agent 幻觉的治理，行业正在从早期的“纯提示词工程（Prompt Engineering）”转向**“物理工程级硬隔离”**。&lt;br /&gt;
&lt;br /&gt;
=== 1. 引入 Harness（AI马具）物理沙箱 ===&lt;br /&gt;
目前行业最前沿的共识（如 DeepSeek Harness、[[Codex Harness]]）认为，不能让 Agent 在裸体状态下直接对接操作系统。必须为 Agent 穿上“马具（Harness）”，通过强类型的输入输出规约（Schema）和封闭的 Docker 沙箱，硬性拦截 Agent 幻觉产生的越权指令。&lt;br /&gt;
&lt;br /&gt;
=== 2. 双重校验反射机制 (Dual-Reflective) ===&lt;br /&gt;
引入“执行 Agent”与“审计 Agent”的双智能体对抗架构。执行 Agent 负责输出规划，审计 Agent 负责实时的形式化验证（Formal Verification），在外部工具真正被调用前，拦截掉 90% 以上的参数捏造幻觉。&lt;br /&gt;
&lt;br /&gt;
=== 3. 结构化环境状态机 (FSM) ===&lt;br /&gt;
将自由度过高的环境交互，收敛为有限状态机（Finite State Machine）。Agent 每一步行动后，系统强制进行状态对齐，一旦发现 Agent 状态处于未定义区间，立刻触发回滚（Rollback）机制。&lt;br /&gt;
&lt;br /&gt;
== 参见 ==&lt;br /&gt;
* [[大语言模型]]&lt;br /&gt;
* [[DeepSeek Harness]]&lt;br /&gt;
* [[Harness]]&lt;br /&gt;
* [[Boardline]]&lt;br /&gt;
* [[数据要素]]&lt;br /&gt;
&lt;br /&gt;
[[分类:人工智能]]&lt;br /&gt;
[[分类:智能体技术]]&lt;br /&gt;
[[分类:软件概念]]&lt;/div&gt;</description>
			<pubDate>Sun, 23 Aug 2026 03:48:33 GMT</pubDate>
			<dc:creator>Admin</dc:creator>
			<comments>https://wiki.jwjp.com/index.php?title=Talk:Agent%E5%B9%BB%E8%A7%89</comments>
		</item>
		<item>
			<title>Codex Harness</title>
			<link>https://wiki.jwjp.com/index.php?title=Codex_Harness&amp;diff=111&amp;oldid=0</link>
			<guid isPermaLink="false">https://wiki.jwjp.com/index.php?title=Codex_Harness&amp;diff=111&amp;oldid=0</guid>
			<description>&lt;p&gt;创建页面，内容为“{{Infobox Software | 名称 = Codex Harness | 开发者 = &lt;a href=&quot;/index.php?title=OpenAI&amp;amp;action=edit&amp;amp;redlink=1&quot; class=&quot;new&quot; title=&quot;OpenAI（页面不存在）&quot;&gt;OpenAI&lt;/a&gt; | 首次开源时间 = 2026年8月19日 | 开源协议 = Apache-2.0 协议 | 核心理念 = 智能体即平台 (Agent as a Platform) | 代码仓库 = [https://github.com ://github.com] | 主要组件 = codex exec、Codex SDK、Codex app-server }}  &amp;#039;&amp;#039;&amp;#039;Codex Harness&amp;#039;&amp;#039;&amp;#039;（亦称 &amp;#039;&amp;#039;&amp;#039;OpenAI Agent Harness&amp;#039;&amp;#039;&amp;#039;）是由人工智能研究机构 &lt;a href=&quot;/index.php?title=OpenAI&amp;amp;action=edit&amp;amp;redlink=1&quot; class=&quot;new&quot; title=&quot;OpenAI（页面不存在）&quot;&gt;OpenAI&lt;/a&gt; 于2026年8月正式完全开源的&lt;a href=&quot;/index.php?title=%E6%99%BA%E8%83%BD%E4%BD%93&amp;amp;action=edit&amp;amp;redlink=1&quot; class=&quot;new&quot; title=&quot;智能体（页面不存在）&quot;&gt;智能体&lt;/a&gt;…”&lt;/p&gt;
&lt;p&gt;&lt;b&gt;新页面&lt;/b&gt;&lt;/p&gt;&lt;div&gt;{{Infobox Software&lt;br /&gt;
| 名称 = Codex Harness&lt;br /&gt;
| 开发者 = [[OpenAI]]&lt;br /&gt;
| 首次开源时间 = 2026年8月19日&lt;br /&gt;
| 开源协议 = Apache-2.0 协议&lt;br /&gt;
| 核心理念 = 智能体即平台 (Agent as a Platform)&lt;br /&gt;
| 代码仓库 = [https://github.com ://github.com]&lt;br /&gt;
| 主要组件 = codex exec、Codex SDK、Codex app-server&lt;br /&gt;
}}&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;Codex [[Harness]]&amp;#039;&amp;#039;&amp;#039;（亦称 &amp;#039;&amp;#039;&amp;#039;OpenAI Agent Harness&amp;#039;&amp;#039;&amp;#039;）是由人工智能研究机构 [[OpenAI]] 于2026年8月正式完全开源的[[智能体]]（AI Agent）底层执行框架。该框架是驱动 OpenAI 旗舰级编程智能体 Codex 的核心技术引擎，负责管理复杂的 AI 执行循环、长期对话记忆、实时事件流以及工具调用，旨在让开发者彻底告别传统的“通用聊天框”限制，将 Agent 能力直接嵌入自有产品中。&lt;br /&gt;
&lt;br /&gt;
== 开源背景 ==&lt;br /&gt;
自 2026 年初 OpenAI 首次提出“Harness 工程”（Harness Engineering）这一方法论以来，行业对于智能体开发的认知从“模型 + 提示词”演变为“模型 + 外壳（Harness）”。在 GitHub 开源后，该项目迅速斩获超过 10 万颗 Star，成为 AI 基础设施领域的里程碑事件。&lt;br /&gt;
&lt;br /&gt;
== 三大核心集成组件 ==&lt;br /&gt;
OpenAI 此次开源的 Codex Harness 覆盖了从简单脚本到企业级复杂应用的全场景构建需求，主要由以下三个部分组成：&lt;br /&gt;
&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;codex exec&amp;#039;&amp;#039;&amp;#039;：一个轻量级的命令行（CLI）工具。专为非交互式、有边界的自动化流设计，适合嵌入到持续集成（CI/CD）脚本或一键运行的后台任务中。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Codex SDK&amp;#039;&amp;#039;&amp;#039;：提供面向 TypeScript 和 Python 的官方程序化接口。方便开发者在现有的应用代码中，以流式或可中断的方式直接编排 Codex 任务。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Codex app-server&amp;#039;&amp;#039;&amp;#039;：整个开源架构中最核心的组件。它是一个持久运行的服务器进程，通过标准的 JSON-RPC 协议与任何前端应用连接。该组件全权负责维护长连接会话、捕获工具报错、管理运行时状态、并在高危操作时向用户发起“人类介入审批”。&lt;br /&gt;
&lt;br /&gt;
== 技术特性与突破 ==&lt;br /&gt;
&lt;br /&gt;
=== 极致的 Token 成本削减 ===&lt;br /&gt;
在传统的 Agent 架构中，大模型由于多轮工具迭代和重发系统 Prompt，常常面临 Token 消耗呈指数级膨胀的问题。Codex Harness 内部集成了一套高阶的“上下文压缩机制”（Context Compaction），在保障大模型逻辑推理能力的同时，**成功将输出 Token 消耗降低了 6 倍**。在 ARC-AGI-3 智能体硬核基准测试中，配合 Harness 的模型得分从 13.3% 飙升至 38.3%。&lt;br /&gt;
&lt;br /&gt;
=== 灵活的工具抽象 (MCP) ===&lt;br /&gt;
Harness 并不绑定特定的私有化工具。它原生支持由 Anthropic 发起并逐渐成为行业标准的 &amp;#039;&amp;#039;&amp;#039;MCP (Model Context Protocol)&amp;#039;&amp;#039;&amp;#039; 协议。这意味着企业可以将现有的内部数据库、API 和业务系统封装为 MCP 服务，直接插在 OpenAI 的 Harness 上供 AI 调用。&lt;br /&gt;
&lt;br /&gt;
=== 不可变会话树与分叉试验 ===&lt;br /&gt;
基于“事件溯源”的设计理念，AI 经历的每一轮思考、调用和报错都被记录为不可变的会话历史（Immutable Session History）。&lt;br /&gt;
* 当 AI 的任务执行失败时，人类操作员可以随时在执行轨迹图上开辟一个“&amp;#039;&amp;#039;&amp;#039;分叉分支 (Forking)&amp;#039;&amp;#039;&amp;#039;”，去尝试不同的引导路径，而不会污染或损坏原始的主线会话记录。&lt;br /&gt;
&lt;br /&gt;
== 商业与企业应用 ==&lt;br /&gt;
由于采用了极其宽松的 &amp;#039;&amp;#039;&amp;#039;Apache-2.0 开源许可协议&amp;#039;&amp;#039;&amp;#039;，企业无需依赖 OpenAI 的云端托管基础设施。医疗、金融、网安等对数据隐私极其敏感的行业，可以完全将 Codex Harness 部署在私有云、本地服务器、甚至物理隔离（Air-gapped）的环境中，进行自主的代码审计与合规改造。&lt;br /&gt;
&lt;br /&gt;
== 参见 ==&lt;br /&gt;
* [[OpenAI]]&lt;br /&gt;
* [[智能体]] (AI Agent)&lt;br /&gt;
* [[模型上下文协议]] (MCP)&lt;br /&gt;
* [[DeepSeek Harness]]&lt;br /&gt;
&lt;br /&gt;
[[分类:开源软件]]&lt;br /&gt;
[[分类:人工智能]]&lt;br /&gt;
[[分类:AI基础设施]]&lt;/div&gt;</description>
			<pubDate>Sun, 23 Aug 2026 03:37:22 GMT</pubDate>
			<dc:creator>Admin</dc:creator>
			<comments>https://wiki.jwjp.com/index.php?title=Talk:Codex_Harness</comments>
		</item>
		<item>
			<title>Harness</title>
			<link>https://wiki.jwjp.com/index.php?title=Harness&amp;diff=110&amp;oldid=0</link>
			<guid isPermaLink="false">https://wiki.jwjp.com/index.php?title=Harness&amp;diff=110&amp;oldid=0</guid>
			<description>&lt;p&gt;创建页面，内容为“{{Infobox Software Concept | 名称 = Harness / AI 马具 | 别名 = 智能体外壳 (Agent Shell)、大模型运行外壳、Agent Harness | 提出背景 = &lt;a href=&quot;/index.php?title=%E5%A4%A7%E8%AF%AD%E8%A8%80%E6%A8%A1%E5%9E%8B&amp;amp;action=edit&amp;amp;redlink=1&quot; class=&quot;new&quot; title=&quot;大语言模型（页面不存在）&quot;&gt;大语言模型&lt;/a&gt;（LLM）向交互式&lt;a href=&quot;/index.php?title=%E6%99%BA%E8%83%BD%E4%BD%93&amp;amp;action=edit&amp;amp;redlink=1&quot; class=&quot;new&quot; title=&quot;智能体（页面不存在）&quot;&gt;智能体&lt;/a&gt;（AI Agent）演进 | 核心职能 = 工具解耦、环境隔离、执行跟踪、沙箱安全 | 代表实现 = DeepSeek Harness、Claude Code、LangChain LangGraph }}  &amp;#039;&amp;#039;&amp;#039;Harness&amp;#039;&amp;#039;&amp;#039;（在人工智能领域常被称为&amp;#039;&amp;#039;&amp;#039;AI 马具&amp;#039;&amp;#039;&amp;#039;、&amp;#039;&amp;#039;&amp;#039;智能体外壳&amp;#039;…”&lt;/p&gt;
&lt;p&gt;&lt;b&gt;新页面&lt;/b&gt;&lt;/p&gt;&lt;div&gt;{{Infobox Software Concept&lt;br /&gt;
| 名称 = Harness / AI 马具&lt;br /&gt;
| 别名 = 智能体外壳 (Agent Shell)、大模型运行外壳、Agent Harness&lt;br /&gt;
| 提出背景 = [[大语言模型]]（LLM）向交互式[[智能体]]（AI Agent）演进&lt;br /&gt;
| 核心职能 = 工具解耦、环境隔离、执行跟踪、沙箱安全&lt;br /&gt;
| 代表实现 = DeepSeek Harness、Claude Code、LangChain LangGraph&lt;br /&gt;
}}&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;Harness&amp;#039;&amp;#039;&amp;#039;（在人工智能领域常被称为&amp;#039;&amp;#039;&amp;#039;AI 马具&amp;#039;&amp;#039;&amp;#039;、&amp;#039;&amp;#039;&amp;#039;智能体外壳&amp;#039;&amp;#039;&amp;#039;或&amp;#039;&amp;#039;&amp;#039;运行外壳&amp;#039;&amp;#039;&amp;#039;）是一种通用的 AI 软件架构概念。其核心作用是将纯粹进行逻辑推理的“大语言模型（LLM）大脑”，与能实际操作计算机系统的“身体部件（如[[文件系统]]、[[命令行]]、[[网络检索]]、网页浏览器）”进行彻底解耦与连接。&lt;br /&gt;
&lt;br /&gt;
“Harness”一词原本指马车上的马具。在 AI 时代，该术语被借用来指代“套在大模型身上的约束、控制和赋能框架”——它既为大模型提供操控外界的接口（赋能），又严格限制其越权行为并记录其一举一动（约束）。&lt;br /&gt;
&lt;br /&gt;
== 核心设计公式 ==&lt;br /&gt;
在当前 AI 行业，普遍存在一个技术公式：&lt;br /&gt;
:&amp;lt;math&amp;gt;\text{Agent (智能体)} = \text{Model (模型大脑)} + \text{Harness (通用外壳)}&amp;lt;/math&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Model（模型）&amp;#039;&amp;#039;&amp;#039;：仅负责接收文本/视觉输入，并预测输出下一个 Token（思考、判断、生成代码）。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Harness（马具）&amp;#039;&amp;#039;&amp;#039;：负责解析模型输出的代码或工具调用（Tool Call），在真实的、隔离的沙箱环境中执行该操作，并将执行结果（如报错信息、网页内容、终端输出）重新塞回模型的上下文中。&lt;br /&gt;
&lt;br /&gt;
== 通用 Harness 的核心职能 ==&lt;br /&gt;
&lt;br /&gt;
=== 1. 一切皆插件（解耦架构） ===&lt;br /&gt;
先进的 Harness 架构通常采用高度模块化的插件系统（如基于 [[Cordis]] 内核）。它确保没有任何工具拥有特权，包括以下组件均可热插拔：&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;模型适配器（LLM Adapter）&amp;#039;&amp;#039;&amp;#039;：同一套外壳，既可以接入本地的 DeepSeek 模型，也可以一键切换至云端的 GPT-4、Claude 或 Gemini。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;执行工具（Tools）&amp;#039;&amp;#039;&amp;#039;：如文件读写器、Bash 终端、浏览器自动化工具（Playwright）。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;交互界面（UI/UX）&amp;#039;&amp;#039;&amp;#039;：可以自由切换为命令行（TUI）、Web 网页或跨平台桌面客户端。&lt;br /&gt;
&lt;br /&gt;
=== 2. 事件溯源与运行轨迹可观测性 ===&lt;br /&gt;
通用 Harness 必须严格遵循“&amp;#039;&amp;#039;&amp;#039;模型可见 ⟺ 已记录&amp;#039;&amp;#039;&amp;#039;”（Model-Visible ⟺ Logged）的不变量原则。AI 在执行复杂任务（如自主修 Bug）时，中间经历的所有思考、命令调用、失败重试、报错日志，都会被 Harness 以“仅追加（Append-only）”的方式记录为一条完整的&amp;#039;&amp;#039;&amp;#039;轨迹（Trajectory）&amp;#039;&amp;#039;&amp;#039;。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;回放与搜索&amp;#039;&amp;#039;&amp;#039;：人类用户可以像看录像带一样回放 AI 的行为。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;分叉与恢复（Forking）&amp;#039;&amp;#039;&amp;#039;：用户可以随时把 AI 的某一步骤“分叉”出去进行实验，测试不同的引导词，且不破坏原有的主线会话。&lt;br /&gt;
&lt;br /&gt;
=== 3. 安全护栏与沙箱接缝 ===&lt;br /&gt;
由于 Harness 赋予了 AI 操作系统级别的极高权限，安全防护是其必不可少的核心：&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;权限隔离（Sandbox Seam）&amp;#039;&amp;#039;&amp;#039;：Harness 底层通常封装了沙箱技术（如 `bwrap` / Bubblewrap、`Landlock`、Docker 等），将 AI 的读写范围限制在特定的项目工作区内，防止大模型误删系统盘。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;人类介入（HITL / Human-in-the-Loop）&amp;#039;&amp;#039;&amp;#039;：对于高危操作（如删除文件、执行 `rm -rf`、发送网络请求或产生经济扣费），Harness 会自动触发人类审批机制（`ctx.approval`），暂停 AI 运行并等待人类一键确认。&lt;br /&gt;
&lt;br /&gt;
== 行业主流实现方案对比 ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Harness 实现名称 !! 发起方/生态 !! 核心特点 !! 主要适用场景&lt;br /&gt;
|-&lt;br /&gt;
&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;[[Deepseek harness|DeepSeek Harness]] (dsh)&amp;#039;&amp;#039;&amp;#039; || [[深度求索]] 开源 || 极致的声明式配置（YML 驱动）、完全解耦、高并发、基于 TypeScript。 || 开源社区全自主、全模态 Agent 构建。&lt;br /&gt;
|-&lt;br /&gt;
&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;Claude Code&amp;#039;&amp;#039;&amp;#039; || Anthropic || 与 Claude 3.5/3.7 紧密集成，主打极致的终端自动化编码、上下文高精度控制。 || 终端命令行、程序员日常编程辅助。&lt;br /&gt;
|-&lt;br /&gt;
&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;LangGraph / AutoGen&amp;#039;&amp;#039;&amp;#039; || 传统 Agent 框架生态 || 侧重于利用多 Agent 编排、有向无环图（DAG）来规定复杂的业务流。 || 企业级多智能体协同、固定工作流自动化。&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== 局限性与行业挑战 ==&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Token 膨胀与成本控制&amp;#039;&amp;#039;&amp;#039;：Harness 为了让大模型获得完美的情境感知，需要不断把工具执行结果重发给模型，易导致 Token 消耗呈指数级上升（尤其是在多轮迭代和重试中）。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;幻觉级安全越狱&amp;#039;&amp;#039;&amp;#039;：当大模型产生严重的“幻觉”或遭受外部提示词注入攻击（Prompt Injection）时，Harness 的安全护栏是否能 100% 拦截恶意的系统指令，仍是目前学术界与工业界的攻防焦点。&lt;br /&gt;
&lt;br /&gt;
== 参见 ==&lt;br /&gt;
* [[智能体]] (AI Agent)&lt;br /&gt;
* [[大语言模型]] (LLM)&lt;br /&gt;
* [[沙箱]] (Sandbox)&lt;br /&gt;
* [[DeepSeek Harness]]&lt;br /&gt;
&lt;br /&gt;
[[分类:人工智能]]&lt;br /&gt;
[[分类:软件架构]]&lt;br /&gt;
[[分类:开发框架]]&lt;/div&gt;</description>
			<pubDate>Sun, 23 Aug 2026 03:35:35 GMT</pubDate>
			<dc:creator>Admin</dc:creator>
			<comments>https://wiki.jwjp.com/index.php?title=Talk:Harness</comments>
		</item>
		<item>
			<title>Deepseek harness</title>
			<link>https://wiki.jwjp.com/index.php?title=Deepseek_harness&amp;diff=109&amp;oldid=0</link>
			<guid isPermaLink="false">https://wiki.jwjp.com/index.php?title=Deepseek_harness&amp;diff=109&amp;oldid=0</guid>
			<description>&lt;p&gt;创建页面，内容为“{{Infobox Software | 名称 = DeepSeek Harness | 别名 = dsh、DeepSeek-Harness | 开发者 = 深度求索 (DeepSeek AI) | 编程语言 = TypeScript | 许可证 = MIT 许可证 | 首次开源时间 = 2026年8月13日 | 当前状态 = 开发者预览版 (Developer Preview) | 官网 = [https://www.deepseek.com/harness/ www.deepseek.com/harness] | 代码仓库 = [https://github.com/deepseek-ai/deepseek-harness GitHub] }}  &amp;#039;&amp;#039;&amp;#039;DeepSeek Harness&amp;#039;&amp;#039;&amp;#039;（简称 &amp;#039;&amp;#039;&amp;#039;dsh&amp;#039;&amp;#039;&amp;#039;…”&lt;/p&gt;
&lt;p&gt;&lt;b&gt;新页面&lt;/b&gt;&lt;/p&gt;&lt;div&gt;{{Infobox Software&lt;br /&gt;
| 名称 = DeepSeek Harness&lt;br /&gt;
| 别名 = dsh、DeepSeek-Harness&lt;br /&gt;
| 开发者 = 深度求索 (DeepSeek AI)&lt;br /&gt;
| 编程语言 = TypeScript&lt;br /&gt;
| 许可证 = MIT 许可证&lt;br /&gt;
| 首次开源时间 = 2026年8月13日&lt;br /&gt;
| 当前状态 = 开发者预览版 (Developer Preview)&lt;br /&gt;
| 官网 = [https://www.deepseek.com/harness/ www.deepseek.com/harness]&lt;br /&gt;
| 代码仓库 = [https://github.com/deepseek-ai/deepseek-harness GitHub]&lt;br /&gt;
}}&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;DeepSeek Harness&amp;#039;&amp;#039;&amp;#039;（简称 &amp;#039;&amp;#039;&amp;#039;dsh&amp;#039;&amp;#039;&amp;#039;，[[npm]] 包名为 `@deepseek-ai/dsh`）是由中国 AI 机构[[深度求索]]（DeepSeek AI）于2026年8月正式开源的[[智能体]]运行环境与开发框架。其官方核心理念为“&amp;#039;&amp;#039;&amp;#039;一切皆插件&amp;#039;&amp;#039;&amp;#039;”（Everything is a Plugin），该框架通过将模型、工具、沙箱、UI 等完全解耦，为大语言模型（LLM）提供了一个高度可定制的自主任务执行环境。&lt;br /&gt;
&lt;br /&gt;
项目在开源后引发了开源社区的巨大关注，在 GitHub 开源仅 3 天便斩获近 13 万颗 Star，成为 GitHub 历史上增长速度最快的开源项目之一。&lt;br /&gt;
&lt;br /&gt;
== 核心设计理念 ==&lt;br /&gt;
DeepSeek 官方提出了 &amp;#039;&amp;#039;&amp;#039;Agent = Model + Harness&amp;#039;&amp;#039;&amp;#039;（智能体 = 模型 + 外壳/马具）的公式。模型（如 DeepSeek-V4）作为“大脑”负责思考，而 Harness 则作为“身体”负责让 AI 读写本地文件、执行终端命令、调用工具及拆分复杂任务。&lt;br /&gt;
&lt;br /&gt;
=== 一切皆插件 ===&lt;br /&gt;
DeepSeek Harness 的底层由开源插件系统 &amp;#039;&amp;#039;&amp;#039;Cordis&amp;#039;&amp;#039;&amp;#039; 内核驱动。在框架中，不存在拥有特权的固定内核，以下所有 Agent 能力全部被实现为可热插拔的插件：&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;LLM 适配器&amp;#039;&amp;#039;&amp;#039;（接入 DeepSeek 自家模型、Gemini、或任何兼容 OpenAI 接口的第三方模型）。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;执行工具&amp;#039;&amp;#039;&amp;#039;（如 Bash 终端、文件系统读写、网页搜索工具）。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;会话与存储&amp;#039;&amp;#039;&amp;#039;（Session Log、追加写入的事件流、上下文压缩机制）。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;交互界面&amp;#039;&amp;#039;&amp;#039;（Web UI、命令行 TUI、桌面客户端）。&lt;br /&gt;
&lt;br /&gt;
开发者无需改动 DSH 任何源码，仅通过修改 `cordis.patch.yml` 声明式配置文件，即可在配置层自由替换、选择和扩展任何系统能力。&lt;br /&gt;
&lt;br /&gt;
=== 事件溯源与可观测性 ===&lt;br /&gt;
框架严格遵循“&amp;#039;&amp;#039;&amp;#039;模型可见 ⟺ 已记录&amp;#039;&amp;#039;&amp;#039;”（Model-Visible ⟺ Logged）的不变量原则。AI 看到的所有上下文信息都必须被记录在仅追加（Append-only）的会话日志中。基于这一设计，DSH 提供了极强的 &amp;#039;&amp;#039;&amp;#039;Trajectory（轨迹）可观测性&amp;#039;&amp;#039;&amp;#039;，支持用户对 AI 的执行流进行**回放、搜索、分叉（Fork）与恢复**，且分叉试验不会污染原始会话。&lt;br /&gt;
&lt;br /&gt;
== 预建运行模式 ==&lt;br /&gt;
DeepSeek Harness 内置了四种核心执行模式，其本质是不同工具插件的预设组合：&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! 模式名称 !! 核心能力范围 !! 适用场景与人群&lt;br /&gt;
|-&lt;br /&gt;
&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;标准模式 (Standard)&amp;#039;&amp;#039;&amp;#039; || 包含文件编辑、Shell、网页搜索、Skills、子Agent与工作流。 || 默认模式，适合绝大多数日常开发任务。&lt;br /&gt;
|-&lt;br /&gt;
&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;PTC 模式 (程序化工具调用)&amp;#039;&amp;#039;&amp;#039; || 在标准模式基础上，允许模型编写一段 TypeScript 脚本合并多次操作。 || 适合批量操作、结构化与自动化流程任务。&lt;br /&gt;
|-&lt;br /&gt;
&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;极简模式 (Minimal)&amp;#039;&amp;#039;&amp;#039; || 只保留一个持久 Bash 和一个文件编辑器工具。 || 官方用于纯粹测试大模型能力的基准测试。&lt;br /&gt;
|-&lt;br /&gt;
&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;创造模式 (Creator)&amp;#039;&amp;#039;&amp;#039; || 标准模式功能 + 运行时环境检查与内存插件试验。 || 专为需要自主编写和发布新插件的高级用户设计。&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== 安全机制 ==&lt;br /&gt;
由于 DSH 具备极高的本地系统操作权限，其内置了严格的安全接缝（Sandbox Seam）：&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;权限分级&amp;#039;&amp;#039;&amp;#039;：提供三档权限。&amp;#039;&amp;#039;&amp;#039;Read Only&amp;#039;&amp;#039;&amp;#039;（只读不改）；&amp;#039;&amp;#039;&amp;#039;Workspace Write&amp;#039;&amp;#039;&amp;#039;（仅限工作目录，超出范围需弹窗提示）；&amp;#039;&amp;#039;&amp;#039;Full Access&amp;#039;&amp;#039;&amp;#039;（完全访问，护栏全拆，需谨慎开启）。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;多端沙箱**：内置 `bwrap` (Bubblewrap)、`Landlock`、`Seatbelt` 等沙箱后端，严格拦截越权文件访问。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;交互式审批&amp;#039;&amp;#039;&amp;#039;：在工具高危执行前，自动触发 `ctx.approval` 机制，强制暂停等待人类用户一键确认。&lt;br /&gt;
&lt;br /&gt;
== 社区生态 ==&lt;br /&gt;
得益于极致的插件化架构，GitHub 上带有 `dsh-plugin` 标签的第三方开源插件生态在短期内迎来了爆发式增长。&lt;br /&gt;
&lt;br /&gt;
著名的社区插件和衍生项目包括：&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;ModLens&amp;#039;&amp;#039;&amp;#039;：为纯文本模型提供视觉桥梁，使其能通过第三方视觉后端看懂图片。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;DeepSeek Harness 桌面版 (dsh-desktop)&amp;#039;&amp;#039;&amp;#039;：基于 Tauri 2 开发的跨平台轻量级桌面客户端，免去了用户在本地手动配置 Node.js 运行环境的烦恼。&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;dsh-at-file&amp;#039;&amp;#039;&amp;#039;：允许用户在 Web UI 对话框中直接通过 `@` 符号快捷引用本地项目文件。&lt;br /&gt;
&lt;br /&gt;
== 局限性与风险 ==&lt;br /&gt;
由于该项目目前仍处于&amp;#039;&amp;#039;&amp;#039;开发者预览阶段（Developer Preview）&amp;#039;&amp;#039;&amp;#039;，官方明确声明后续版本将会频繁更新并引入破坏兼容性的变更（Breaking Changes），暂不建议直接部署于生产环境。&lt;br /&gt;
&lt;br /&gt;
== 参见 ==&lt;br /&gt;
* [[深度求索]]&lt;br /&gt;
* [[智能体]] (AI Agent)&lt;br /&gt;
* [[TypeScript]]&lt;br /&gt;
* 开源对标项目：Claude Code、Codex&lt;br /&gt;
&lt;br /&gt;
[[分类:开源软件]]&lt;br /&gt;
[[分类:人工智能]]&lt;br /&gt;
[[分类:开发框架]]&lt;/div&gt;</description>
			<pubDate>Sun, 23 Aug 2026 03:34:12 GMT</pubDate>
			<dc:creator>Admin</dc:creator>
			<comments>https://wiki.jwjp.com/index.php?title=Talk:Deepseek_harness</comments>
		</item>
		<item>
			<title>Dsh</title>
			<link>https://wiki.jwjp.com/index.php?title=Dsh&amp;diff=108&amp;oldid=0</link>
			<guid isPermaLink="false">https://wiki.jwjp.com/index.php?title=Dsh&amp;diff=108&amp;oldid=0</guid>
			<description>&lt;p&gt;创建页面，内容为“别被 DeepSeek Harness 刷屏骗了！ 一文看透“AI 小程序”生态的遮羞布与真价值标 最近 AI 圈子里有个新词被疯狂刷屏，叫 Harness（尤其是 DeepSeek 正式开源了 DeepSeek Harness，简称 DSH 之后）。一堆完全不写代码的营销号又开始高潮，狂吹什么“AI 编程革命来了”、“程序员马上要彻底失业了”、“以后小白用几行字就能自己批量组装 Agent 开发系统了”。…”&lt;/p&gt;
&lt;p&gt;&lt;b&gt;新页面&lt;/b&gt;&lt;/p&gt;&lt;div&gt;别被 DeepSeek Harness 刷屏骗了！&lt;br /&gt;
一文看透“AI 小程序”生态的遮羞布与真价值标&lt;br /&gt;
最近 AI 圈子里有个新词被疯狂刷屏，叫 Harness（尤其是 DeepSeek 正式开源了 DeepSeek Harness，简称 DSH 之后）。一堆完全不写代码的营销号又开始高潮，狂吹什么“AI 编程革命来了”、“程序员马上要彻底失业了”、“以后小白用几行字就能自己批量组装 Agent 开发系统了”。&lt;br /&gt;
&lt;br /&gt;
作为一个天天和代码打交道、冷眼旁观的行业老油条，今天必须不吐不快。咱们不聊宏大叙事，今天直接脱掉 AI 的遮羞布，用最通俗、最硬核的底层逻辑，把这层 AI 泡沫彻底戳破，聊聊大实话。&lt;br /&gt;
&lt;br /&gt;
1. 拨开迷雾：Harness 到底是个啥？别被那些高端的英文词给唬住了。在技术圈，有人把大模型比作“大脑”（CPU），那 Harness 就是“操作系统”（OS）。但我认为上轮讨论中有一个极度绝妙的类比：Harness 它的底层本质，其实就是一个“托管运行的 AIGC 容器”，或者说是“微信小程序的底层底座”。&lt;br /&gt;
大家回忆一下，以前我们用 ChatGPT 或者 Claude 网页端写代码，最痛苦的是什么？是“只管生、不管养”。AI 给你吐了一堆看起来很牛的脚本，你得像个“人肉搬运工”一样复制下来、建文件、配环境。一运行，满屏报错，你还得把报错再复制回去问 AI。而 Harness 的出现，就是给大模型配了一个随时待命的“沙箱容器（Runtime Container）”。AI 产生想法后，不折腾人类了，直接在后台的容器里把代码跑了。跑通了，直接交付代码；跑失败了，容器自动把报错（Error Log）抓回来喂给 AI，AI 自己在后台就地改，直到改对为止。&lt;br /&gt;
所以，这次的突破，不是大模型（AI 的智商）突然诞生了自主意识，而是工程师们通过 Harness，把“输入 \(\rightarrow \) 思考 \(\rightarrow \) 编写 \(\rightarrow \) 容器运行 \(\rightarrow \) 自动纠错”这一整套工程管道（Pipeline），给标准化、跑通了。&lt;br /&gt;
&lt;br /&gt;
2. DSH 的终极阳谋：Agent 时代的“微信小程序生态”理解了“Harness 是小程序底座”这个概念，你就能一眼看懂 DeepSeek Harness（DSH）、MCP 协议、Agent Skill 这三者之间乱七八糟的堆叠关系了。&lt;br /&gt;
&lt;br /&gt;
这根本不是什么神秘的黑科技，它就是当年微信小程序的翻版生态系统：Model（大模型）： 相当于微信平台本身。它提供最基础的“流量和智商支撑”。Harness（运行底座）： 相当于“微信小程序的底座/运行框架”。它负责提供安全的沙箱环境、隔离权限（不能乱动用户电脑）、分配算力，保障小程序能安全运行。MCP（模型上下文协议）： 相当于小程序的“标准通信接口（API 规范）”。不管你的插件是用 Python 写的还是用 Java 写的，大家都必须用 MCP 这个统一的语言跟大模型沟通。Agent Skill（智能体技能）： 相当于一个个“具体的小程序”。比如“查 Git 记录”、“发飞书消息”、“跑编译”，这就是被封装好的具体干活工具。DeepSeek 开源 DSH 的本质，不是直接卖给你一个成品 Agent，而是赌一个“Agent 时代的 App Store”。它把舞台搭好，制定好规矩（MCP + 微内核），然后对全天下说：“不管你是大公司还是小白，只要你会写几句代码，都可以通过 AI 助手（如 Cursor/Trae）写个 Demo 插件（小程序）塞进 DSH 里用。”&lt;br /&gt;
&lt;br /&gt;
3. 撕下遮羞布：为什么说“小白靠它几行文字写系统”注定是幻想？这个“小程序生态”看起来很美，但如果你把它放在“编程类赛道”，现实骨感得让人想笑。目前社区里那几千个所谓的 MCP 插件和 Skill，绝大多数都在重复造轮子。今天看一个“读取 Git 插件”，明天看一个“查看目录工具”，这玩意跟字节跳动的扣子（Coze）或者市面上的低配工作流没有任何本质区别，全是野生的边缘玩具。真正的顶级 AI 编程工具（比如 Cursor、阿里 Qoder、字节 Trae）之所以强，是因为它们和 IDE 绑得极深，拥有毫秒级的代码索引、多文件结构化 Diff、行间 Tab 预测等底层工程硬实力。这种涉及大量二进制和 C++ 优化的系统级深度集成，绝不是个人开发者或者爱好者在 Harness 里面写几个 Python 插件、拼几条流程就能赶上的。在“手写代码的爽感”上，DSH 社区的野生小程序们永远打不过闭源 IDE 的正规军。更致命的是，大模型是没有“业务全局观”的。 只要连续执行的任务步骤超过 30 步，Agent 就会陷入长程任务崩溃（Long-Horizon Task Degradation）。第一步的小程序插件返回了一个带噪点的数据，第二步模型误读，到了第十步，AI 就在沙箱里彻底跑偏开始“东墙补西墙”，陷入幻觉死循环。&lt;br /&gt;
&lt;br /&gt;
如果没有一个懂行的主理人坐在键盘后面把控架构设计、划分模块边界，AI 哪怕有 Harness 护航，也只会迅速帮你堆出一坨外表能跑、内部全是技术债的“代码屎山”。还有很多人吹嘘：“既然能托管运行，那小白通过 AI 写个插件，不就能自动登录公司报销系统点按钮，甚至去爬小红书、搞自动群控发布了？”别做梦了，风控和安全墙不是摆设。&lt;br /&gt;
&lt;br /&gt;
如果你去连公司内网那些“裸奔”的、连验证码和设备指纹都没有的老系统，你通过 DSH 驱动一个 Puppeteer 浏览器点一点确实没问题。但如果你想用这套玩意去碰小红书、抖音、微信，大厂那变态的设备指纹、滑动轨迹检测和 AI 验证码，一秒钟就能把你的 AI 账号封得连亲妈都不认识。它不是什么能打破一切网络防护的“神级黑客工具”。如果是黑灰产在使用 AI，大模型也只是充当了“文案加速器”的外壳，真正底层去破解验证码、抗风控的，依然是那些传统的黑产改机和打码工具，跟 Harness 框架本身半毛钱关系没有。&lt;br /&gt;
&lt;br /&gt;
4. 那么，Harness 的真正价值到底在哪？既然它在个人写代码上拼不过 Cursor，又不能暴力破防互联网大厂，那 DeepSeek 费尽心机搞这个生态，大家都在疯狂跟进，到底图啥？因为在企业和资深架构师眼里，Harness 赌的是“外环”的工业化定制与绝对安全。大家要明白，未来的软件工程一定是双环驱动的：内环（开发者桌面）： 程序员自己敲键盘、写代码、搞 UI 预览时，继续用 Cursor 或 Trae，因为它们的前端封装和 Tab 补全体验是无敌的。外环（研发流程自动化）： 但如果一个企业团队，需要搞“7×24 小时的无人值守数字员工”呢？比如深夜有低级 Bug 的 Issue 提交了，企业不可能让员工不睡觉。这时候，完全开源、本地私有化部署的 DeepSeek Harness 就成了完美底座。企业绝对不会去用社区里那些参差不齐的野生小程序，他们会派自己的正规军（企业内部研发）在 DSH 上开发通过了严格内测的、工业级的“私有小程序插件”（例如对接自研的流水线工具、定制的数据库网关）。深夜 Bug 来了，DSH 自动启动，在完全隔离安全的 Docker 沙箱里自动拉代码、修复、跑编译、跑 Smoke 测试（冒烟测试）；发现有错，后台自动利用报错自愈纠错；通过测试后，自动弹出提示让人类审批。最重要的是，整套流程、代码、沙箱全在企业自己的内网服务器里，数据绝对不出境。在这个后端数字化生产线、私有库代码审计的赛道上，Harness 的平台级可插拔定制能力和合规安全底线，对闭源 IDE 是降维打击。&lt;br /&gt;
&lt;br /&gt;
5. 结尾：未来的技术分水岭看透了“托管 AIGC 容器”与“小程序底座”的本质，未来的软件工程师分水岭已经极其清晰了：一端是逐渐失去价值的人： 那些只懂得生搬硬套、靠搜索引擎复制粘贴样板代码，自己却不理解底层架构和业务逻辑的低级开发。因为这部分人肉打字机的工作，已经被“大模型 + 托管容器”用极低的成本彻底剥夺了。另一端是极度吃香的人： 那些能够看清技术本质，懂业务、懂架构、懂怎么去“操纵和审计 AI”的主理人（操作者）。也就是我们所说的“十倍工程师”。现在的顶级 AI 编程 IDE 和自动化管线确实强得离谱，能够自动交付和测试。但这一切高效的前提，是键盘后面坐着一个“能看懂、会审计”的懂行操作者。技术一直在变，但方向盘永远在懂行的人手里。那些妄想靠几行模糊文字就让 AI 帮你平地起高楼、写个完美系统的白日梦，该醒醒了；而那些已经开始把大模型当牛马、用沙箱底座来降维提效的“掌舵人-BoardLine”，属于你们的时代，才刚刚开始。&lt;/div&gt;</description>
			<pubDate>Sat, 22 Aug 2026 19:12:28 GMT</pubDate>
			<dc:creator>Admin</dc:creator>
			<comments>https://wiki.jwjp.com/index.php?title=Talk:Dsh</comments>
		</item>
</channel></rss>