refactor(docs): streamline comments and remove outdated Python alignment references

chickenlj · chickenlj · commit 6639635348f1 · 2026-06-02T22:26:22.000+08:00
diff --git a/agentscope-core/src/main/java/io/agentscope/core/agent/Agent.java b/agentscope-core/src/main/java/io/agentscope/core/agent/Agent.java
@@ -42,28 +42,6 @@
  * terminal {@link Msg}. Streaming variants (see {@link StreamableAgent}) may emit
  * many events but resolve to a single terminal Msg. This is enforced by the
  * {@code Mono<Msg>} return type on the call methods.
- *
- * <h3>Python 2.0 alignment</h3>
- * <p>This interface corresponds to Python's {@code agentscope.agent.Agent} class.
- * Method mapping:
- * <ul>
- *   <li>{@code Agent.reply()} &rarr; {@code CallableAgent#call(List)}</li>
- *   <li>{@code Agent.reply_stream()} &rarr; {@code io.agentscope.core.ReActAgent#streamEvents(List)}</li>
- *   <li>{@code Agent.observe()} &rarr; {@link ObservableAgent#observe(Msg)}</li>
- *   <li>{@code Agent.compress_context()} &rarr; {@code io.agentscope.core.ReActAgent#compressContext()}</li>
- * </ul>
- * <p>Constructor mapping (Python &rarr; Java {@link io.agentscope.core.ReActAgent.Builder}):
- * <ul>
- *   <li>{@code name} &rarr; {@code name()}</li>
- *   <li>{@code system_prompt} &rarr; {@code sysPrompt()}</li>
- *   <li>{@code model} &rarr; {@code model()}</li>
- *   <li>{@code toolkit} &rarr; {@code toolkit()}</li>
- *   <li>{@code middlewares} &rarr; {@code middlewares()}</li>
- *   <li>{@code state} &rarr; {@code agentState()}</li>
- *   <li>{@code model_config} &rarr; {@code modelConfig()}</li>
- *   <li>{@code context_config} &rarr; {@code contextConfig()}</li>
- *   <li>{@code react_config} &rarr; {@code reactConfig()}</li>
- * </ul>
  */
 public interface Agent extends CallableAgent, StreamableAgent, ObservableAgent {
 
diff --git a/agentscope-core/src/main/java/io/agentscope/core/agent/StructuredOutputCapableAgent.java b/agentscope-core/src/main/java/io/agentscope/core/agent/StructuredOutputCapableAgent.java
@@ -57,7 +57,6 @@
  * <p><b>Subclass Requirements:</b>
  * <ul>
  *   <li>Provide Toolkit via constructor</li>
- *   <li>Implement {@link #getMemory()} for memory access</li>
  *   <li>Implement {@link #buildGenerateOptions()} for model options</li>
  * </ul>
  *
diff --git a/agentscope-core/src/main/java/io/agentscope/core/agent/config/package-info.java b/agentscope-core/src/main/java/io/agentscope/core/agent/config/package-info.java
@@ -16,9 +16,7 @@
 
 /**
  * Agent configuration value objects: {@link io.agentscope.core.agent.config.ModelConfig} for
- * retry / fallback wiring, {@link io.agentscope.core.agent.config.ContextConfig} for
- * compression thresholds and templates, {@link io.agentscope.core.agent.config.ReactConfig}
- * for reasoning-loop bounds, and {@link io.agentscope.core.agent.config.SummarySchema} for the
- * structured-output contract that drives memory compression.
+ * retry / fallback wiring and {@link io.agentscope.core.agent.config.ReactConfig} for
+ * reasoning-loop bounds.
  */
 package io.agentscope.core.agent.config;
diff --git a/agentscope-core/src/main/java/io/agentscope/core/tool/mcp/McpTool.java b/agentscope-core/src/main/java/io/agentscope/core/tool/mcp/McpTool.java
@@ -55,7 +55,7 @@ public class McpTool extends ToolBase {
     private final McpClientWrapper clientWrapper;
     private final Map<String, Object> presetArguments;
 
-    /** Preferred constructor used by {@link McpClientManager}. */
+    /** Preferred constructor used by {@link io.agentscope.core.tool.McpClientManager}. */
     public McpTool(
             String name,
             String description,
diff --git a/agentscope-core/src/main/java/io/agentscope/core/tracing/OtelTracingMiddleware.java b/agentscope-core/src/main/java/io/agentscope/core/tracing/OtelTracingMiddleware.java
@@ -50,9 +50,6 @@
  * active), every hook short-circuits to {@code next.apply(input)} with
  * near-zero overhead.
  *
- * <h3>Python 2.0 alignment</h3>
- * <p>Corresponds to {@code agentscope.middleware._tracing.TracingMiddleware}.
- *
  * <p>Usage:
  * <pre>{@code
  * ReActAgent agent = ReActAgent.builder()
diff --git a/agentscope-examples/agents/agentscope-dataagent/src/main/java/io/agentscope/dataagent/web/workspace/SharedSandboxFilesystem.java b/agentscope-examples/agents/agentscope-dataagent/src/main/java/io/agentscope/dataagent/web/workspace/SharedSandboxFilesystem.java
@@ -41,10 +41,10 @@
  * <p>Used by browser-side controllers (workspace tree, file read/write, upload) so the UI sees
  * exactly the same files the agent does. Unlike {@link
  * io.agentscope.harness.agent.filesystem.sandbox.SandboxBackedFilesystem} — which is a stable
- * proxy whose sandbox is flipped per-call by {@link
- * io.agentscope.harness.agent.hook.SandboxLifecycleHook} — this filesystem holds the sandbox
- * directly, because controllers are not inside an agent-call lifecycle and have no hook to do
- * the flip for them.
+ * proxy whose sandbox is flipped per-call by {@code
+ * io.agentscope.harness.agent.middleware.SandboxLifecycleMiddleware} — this filesystem holds
+ * the sandbox directly, because controllers are not inside an agent-call lifecycle and have
+ * no middleware to do the flip for them.
  *
  * <p>The exec/upload/download mapping mirrors {@code SandboxBackedFilesystem} exactly; we don't
  * subclass it because that class implements {@link io.agentscope.harness.agent.sandbox.SandboxAware}
diff --git a/agentscope-examples/documentation/src/main/java/io/agentscope/examples/documentation2/tool/PermissionContextExample.java b/agentscope-examples/documentation/src/main/java/io/agentscope/examples/documentation2/tool/PermissionContextExample.java
@@ -42,6 +42,7 @@
  *
  * <p><b>PermissionMode overview:</b>
  * <table border="1">
+ *   <caption>PermissionMode behaviour summary</caption>
  *   <tr><th>Mode</th><th>Behaviour</th></tr>
  *   <tr><td>DEFAULT</td><td>Ask for everything unless an explicit rule matches</td></tr>
  *   <tr><td>ACCEPT_EDITS</td><td>Auto-allow write tools; ask for destructive ones</td></tr>
diff --git a/agentscope-extensions/agentscope-spring-boot-starters/agentscope-a2a-spring-boot-starter/src/main/java/io/agentscope/spring/boot/a2a/runner/ReActAgentWithStarterRunner.java b/agentscope-extensions/agentscope-spring-boot-starters/agentscope-a2a-spring-boot-starter/src/main/java/io/agentscope/spring/boot/a2a/runner/ReActAgentWithStarterRunner.java
@@ -33,7 +33,7 @@
  *
  * <p> {@link ReActAgent} should be created from {@link org.springframework.beans.factory.ObjectProvider}, which build
  * from
- * {@link io.agentscope.spring.boot.AgentscopeAutoConfiguration#agentscopeReActAgent(Model, Memory, Toolkit,
+ * {@code io.agentscope.spring.boot.AgentscopeAutoConfiguration#agentscopeReActAgent(Model, Memory, Toolkit,
  * AgentscopeProperties)}.
  */
 public class ReActAgentWithStarterRunner extends BaseReActAgentRunner implements AgentRunner {
diff --git a/agentscope-harness/src/main/java/io/agentscope/harness/agent/HarnessAgent.java b/agentscope-harness/src/main/java/io/agentscope/harness/agent/HarnessAgent.java
@@ -517,7 +517,7 @@ public Flux<AgentEvent> streamEvents(Msg msg, RuntimeContext ctx) {
     /**
      * Stream fine-grained {@link AgentEvent}s for a list of messages with a caller-supplied
      * {@link RuntimeContext}. The harness wraps the delegate's
-     * {@link ReActAgent#streamEvents(List, RuntimeContext)} with the same sandbox-lifecycle
+     * {@code ReActAgent#streamEvents(List, RuntimeContext)} with the same sandbox-lifecycle
      * acquire/release semantics that the {@code call(...)} family uses, so streaming and
      * blocking callers behave consistently with respect to sandbox warm-up.
      *
@@ -823,6 +823,7 @@ private Builder() {}
          * <h4>What this method copies</h4>
          *
          * <table border="1">
+         *   <caption>Fields copied from the source ReActAgent</caption>
          *   <tr><th>Group</th><th>Field</th><th>Source</th></tr>
          *   <tr><td rowspan="7">Observable configuration</td>
          *       <td>{@code name}</td><td>{@code agent.getName()}</td></tr>
diff --git a/agentscope-harness/src/main/java/io/agentscope/harness/agent/middleware/SkillCuratorMiddleware.java b/agentscope-harness/src/main/java/io/agentscope/harness/agent/middleware/SkillCuratorMiddleware.java
@@ -6,6 +6,12 @@
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 package io.agentscope.harness.agent.middleware;
 
diff --git a/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/AbstractAgentCreatedFilter.java b/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/AbstractAgentCreatedFilter.java
@@ -6,6 +6,12 @@
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 package io.agentscope.harness.agent.skill.curator;
 
diff --git a/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/AllowListFilter.java b/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/AllowListFilter.java
@@ -6,6 +6,12 @@
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 package io.agentscope.harness.agent.skill.curator;
 
diff --git a/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/CanaryFilter.java b/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/CanaryFilter.java
@@ -6,6 +6,12 @@
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 package io.agentscope.harness.agent.skill.curator;
 
diff --git a/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/CompositeFilter.java b/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/CompositeFilter.java
@@ -6,6 +6,12 @@
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 package io.agentscope.harness.agent.skill.curator;
 
diff --git a/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/EnvironmentFilter.java b/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/EnvironmentFilter.java
@@ -6,6 +6,12 @@
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 package io.agentscope.harness.agent.skill.curator;
 
diff --git a/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/LocalApprovalGate.java b/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/LocalApprovalGate.java
@@ -6,6 +6,12 @@
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 package io.agentscope.harness.agent.skill.curator;
 
diff --git a/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/NotificationSink.java b/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/NotificationSink.java
@@ -6,6 +6,12 @@
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 package io.agentscope.harness.agent.skill.curator;
 
diff --git a/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/NotifyAndWaitGate.java b/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/NotifyAndWaitGate.java
@@ -6,6 +6,12 @@
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 package io.agentscope.harness.agent.skill.curator;
 
diff --git a/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/RejectAllGate.java b/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/RejectAllGate.java
@@ -6,6 +6,12 @@
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 package io.agentscope.harness.agent.skill.curator;
 
diff --git a/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/SkillCandidate.java b/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/SkillCandidate.java
@@ -6,6 +6,12 @@
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 package io.agentscope.harness.agent.skill.curator;
 
diff --git a/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/SkillCurator.java b/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/SkillCurator.java
@@ -6,6 +6,12 @@
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 package io.agentscope.harness.agent.skill.curator;
 
diff --git a/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/SkillCuratorConfig.java b/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/SkillCuratorConfig.java
@@ -6,6 +6,12 @@
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 package io.agentscope.harness.agent.skill.curator;
 
diff --git a/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/SkillCuratorState.java b/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/SkillCuratorState.java
@@ -6,6 +6,12 @@
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 package io.agentscope.harness.agent.skill.curator;
 
diff --git a/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/SkillPromoter.java b/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/SkillPromoter.java
@@ -6,6 +6,12 @@
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 package io.agentscope.harness.agent.skill.curator;
 
diff --git a/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/SkillPromotionGate.java b/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/SkillPromotionGate.java
@@ -6,6 +6,12 @@
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 package io.agentscope.harness.agent.skill.curator;
 
diff --git a/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/SkillVisibilityFilter.java b/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/curator/SkillVisibilityFilter.java
@@ -6,6 +6,12 @@
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 package io.agentscope.harness.agent.skill.curator;
 
diff --git a/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/runtime/SkillPromptBuilder.java b/agentscope-harness/src/main/java/io/agentscope/harness/agent/skill/runtime/SkillPromptBuilder.java
@@ -34,7 +34,7 @@
  *       catalog has a non-null {@code filesRoot} (i.e. shell is available and at least one
  *       skill's files are reachable). The new instruction tells the LLM to use each skill's
  *       {@code <files-root>} rather than a single hardcoded root.
- *   <li>{@link SkillResources} fallback for non-SKILL.md paths is implemented by
+ *   <li>Resource fallback for non-SKILL.md paths is implemented by
  *       {@link SkillLoadTool}; the prompt does not need to mention it.
  * </ul>
  */
diff --git a/agentscope-harness/src/test/java/io/agentscope/harness/agent/middleware/SkillUsageMiddlewareTest.java b/agentscope-harness/src/test/java/io/agentscope/harness/agent/middleware/SkillUsageMiddlewareTest.java
@@ -6,6 +6,12 @@
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 package io.agentscope.harness.agent.middleware;
 
diff --git a/agentscope-harness/src/test/java/io/agentscope/harness/agent/skill/WorkspaceSkillRepositoryTest.java b/agentscope-harness/src/test/java/io/agentscope/harness/agent/skill/WorkspaceSkillRepositoryTest.java
@@ -6,6 +6,12 @@
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 package io.agentscope.harness.agent.skill;
 
diff --git a/agentscope-harness/src/test/java/io/agentscope/harness/agent/skill/curator/CanaryFilterTest.java b/agentscope-harness/src/test/java/io/agentscope/harness/agent/skill/curator/CanaryFilterTest.java
@@ -6,6 +6,12 @@
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 package io.agentscope.harness.agent.skill.curator;
 
diff --git a/agentscope-harness/src/test/java/io/agentscope/harness/agent/skill/curator/EnvironmentAndAllowListFilterTest.java b/agentscope-harness/src/test/java/io/agentscope/harness/agent/skill/curator/EnvironmentAndAllowListFilterTest.java
@@ -6,6 +6,12 @@
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 package io.agentscope.harness.agent.skill.curator;
 
diff --git a/agentscope-harness/src/test/java/io/agentscope/harness/agent/skill/curator/SkillAuditLogTest.java b/agentscope-harness/src/test/java/io/agentscope/harness/agent/skill/curator/SkillAuditLogTest.java
diff --git a/agentscope-harness/src/test/java/io/agentscope/harness/agent/skill/curator/SkillCuratorTest.java b/agentscope-harness/src/test/java/io/agentscope/harness/agent/skill/curator/SkillCuratorTest.java
diff --git a/agentscope-harness/src/test/java/io/agentscope/harness/agent/skill/curator/SkillPromoterTest.java b/agentscope-harness/src/test/java/io/agentscope/harness/agent/skill/curator/SkillPromoterTest.java
diff --git a/agentscope-harness/src/test/java/io/agentscope/harness/agent/skill/curator/SkillSecurityScannerTest.java b/agentscope-harness/src/test/java/io/agentscope/harness/agent/skill/curator/SkillSecurityScannerTest.java
diff --git a/agentscope-harness/src/test/java/io/agentscope/harness/agent/skill/curator/SkillUsageStoreTest.java b/agentscope-harness/src/test/java/io/agentscope/harness/agent/skill/curator/SkillUsageStoreTest.java
diff --git a/agentscope-harness/src/test/java/io/agentscope/harness/agent/skill/runtime/SkillRuntimeTest.java b/agentscope-harness/src/test/java/io/agentscope/harness/agent/skill/runtime/SkillRuntimeTest.java
diff --git a/agentscope-harness/src/test/java/io/agentscope/harness/agent/tool/ProposeSkillToolTest.java b/agentscope-harness/src/test/java/io/agentscope/harness/agent/tool/ProposeSkillToolTest.java
diff --git a/agentscope-harness/src/test/java/io/agentscope/harness/agent/tool/SkillManageToolTest.java b/agentscope-harness/src/test/java/io/agentscope/harness/agent/tool/SkillManageToolTest.java

Original file line number	Diff line number	Diff line change
`@@ -57,7 +57,6 @@`
`57`	`57`	`* <p><b>Subclass Requirements:</b>`
`58`	`58`	`* <ul>`
`59`	`59`	`* <li>Provide Toolkit via constructor</li>`
`60`		`- * <li>Implement {@link #getMemory()} for memory access</li>`
`61`	`60`	`* <li>Implement {@link #buildGenerateOptions()} for model options</li>`
`62`	`61`	`* </ul>`
`63`	`62`	`*`
Original file line number	Diff line number	Diff line change
`@@ -42,6 +42,7 @@`
`42`	`42`	`*`
`43`	`43`	`* <p><b>PermissionMode overview:</b>`
`44`	`44`	`* <table border="1">`
	`45`	`+ * <caption>PermissionMode behaviour summary</caption>`
`45`	`46`	`* <tr><th>Mode</th><th>Behaviour</th></tr>`
`46`	`47`	`* <tr><td>DEFAULT</td><td>Ask for everything unless an explicit rule matches</td></tr>`
`47`	`48`	`* <tr><td>ACCEPT_EDITS</td><td>Auto-allow write tools; ask for destructive ones</td></tr>`
Original file line number	Diff line number	Diff line change
`@@ -33,7 +33,7 @@`
`33`	`33`	`*`
`34`	`34`	`* <p> {@link ReActAgent} should be created from {@link org.springframework.beans.factory.ObjectProvider}, which build`
`35`	`35`	`* from`
`36`		`- * {@link io.agentscope.spring.boot.AgentscopeAutoConfiguration#agentscopeReActAgent(Model, Memory, Toolkit,`
	`36`	`+ * {@code io.agentscope.spring.boot.AgentscopeAutoConfiguration#agentscopeReActAgent(Model, Memory, Toolkit,`
`37`	`37`	`* AgentscopeProperties)}.`
`38`	`38`	`*/`
`39`	`39`	`public class ReActAgentWithStarterRunner extends BaseReActAgentRunner implements AgentRunner {`