@haaaiawd/anws 2.2.2 → 2.2.3

package/templates/.agents/skills/system-designer/references/system-design-detail-template.md

@@ -2,7 +2,7 @@
 
 > **文件性质**: L1 实现层 · **对应 L0**: [`{system-id}.md`](./{system-id}.md)
 > 本文件仅在 `/forge` 任务明确引用时加载。日常阅读和任务规划请优先看 L0。
-> **⚠️ 孤岛检查**: 本文件各节均须在 L0 有对应超链接入口，禁止孤岛内容。
+> ** 孤岛检查**: 本文件各节均须在 L0 有对应超链接入口，禁止孤岛内容。
 
 ---
 
@@ -140,10 +140,10 @@ def plan_or_decide(...):
 ### §5.1 {具体情况}
 
 ```python
-# ❌ 错误做法
+# 错误做法
 # cloned_unit.embarked_unit = unit.embarked_unit  # 浅拷贝 → 状态污染!
 
-# ✅ 正确做法
+# 正确做法
 # cloned_unit.embarked_unit = deepcopy(unit.embarked_unit) if unit.embarked_unit else None
 ```
 
@@ -166,7 +166,7 @@ def make_test_world(size=8) -> World:
 
 ---
 
-<!-- ⚠️ AGENT 使用指南
+<!--  AGENT 使用指南
 
 何时创建本文件: 触发 L0 拆分规则 R1-R5 任意一条时。
   R1 单个代码块 > 30 行
@@ -182,6 +182,6 @@ def make_test_world(size=8) -> World:
   §2 数据结构  — 含方法体的完整类
   §3 算法伪代码 — 按函数顺序编号 (§3.1, §3.2 ...)
   §4 决策树    — 对应 L0 Mermaid 图的展开
-  §5 边缘情况  — 从代码注释中提取的 "# ⚠️ 注意" 类内容
+  §5 边缘情况  — 从代码注释中提取的 "#  注意" 类内容
   §6 测试辅助  — 可选
 -->

package/templates/.agents/skills/system-designer/references/system-design-template.md

@@ -14,11 +14,11 @@
 > **文档分层说明**
 > - **本文件 (L0 导航层)**: 架构图、操作契约、设计决策。面向快速理解与任务规划。禁止放配置字典、算法伪代码和方法体。
 > - **[{system-id}.detail.md](./{system-id}.detail.md) (L1 实现层)**: 完整伪代码、配置常量、边缘情况。仅 `/forge` 任务明确引用时加载。
-> - **L1 锚点原则 ⚠️**: L1 中的每一节都必须在本文件有对应超链接入口。严禁 L1 出现 L0 完全未提及的"孤岛内容"。
+> - **L1 锚点原则 **: L1 中的每一节都必须在本文件有对应超链接入口。严禁 L1 出现 L0 完全未提及的"孤岛内容"。
 
 ---
 
-## 📋 目录 (Table of Contents)
+## 目录 (Table of Contents)
 
 |   §   | 章节                                                         | 关键内容                                                 |
 | :---: | ------------------------------------------------------------ | -------------------------------------------------------- |
@@ -48,7 +48,7 @@
 [这个系统要解决什么问题？为什么需要它？]
 
 ### 1.2 System Boundary (系统边界)
-<!-- ⚠️ CRITICAL: 明确边界，避免职责不清 -->
+<!--  CRITICAL: 明确边界，避免职责不清 -->
 
 - **输入 (Input)**: [系统接收什么？来自哪里？]
 - **输出 (Output)**: [系统产出什么？给谁？]
@@ -104,7 +104,7 @@
 ## 4. 系统架构 (Architecture)
 
 ### 4.1 Architecture Diagram (架构图)
-<!-- ⚠️ CRITICAL: 使用Mermaid或图片展示系统架构 -->
+<!--  CRITICAL: 使用Mermaid或图片展示系统架构 -->
 
 ```mermaid
 graph TD
@@ -152,7 +152,7 @@ sequenceDiagram
 
 ## 5. 接口设计 (Interface Design)
 
-<!-- ⚠️ L0 写法原则:
+<!--  L0 写法原则:
   - 后端 API: 只放 endpoint 路径 + 请求/响应结构摘要（无需完整 JSON 示例）
   - Agent/游戏系统: 使用「操作契约表格」代替函数伪代码
   - 完整参数细节、错误码列表 → {system}.detail.md §3
@@ -160,13 +160,13 @@ sequenceDiagram
 
 ### 5.1 操作契约表 (Operation Contracts)
 
-<!-- ⭐ 核心格式：用表格代替函数伪代码。每行覆盖一个原子操作。 -->
+<!--  核心格式：用表格代替函数伪代码。每行覆盖一个原子操作。 -->
 <!-- 「detail 链接」填写 {system}.detail.md 的对应 §章节号 -->
 
 | 操作                 | [REQ-XXX] | 前置条件     | 消耗/输入 | 产出/副作用  |      实现细节       |
 | -------------------- | :-------: | ------------ | --------- | ------------ | :-----------------: |
-| `operation_a(param)` | [REQ-001] | 条件1; 条件2 | cost★     | 状态变化描述 | [§3.1](./detail.md) |
-| `operation_b(param)` | [REQ-002] | 条件1        | cost★     | 状态变化描述 | [§3.2](./detail.md) |
+| `operation_a(param)` | [REQ-001] | 条件1; 条件2 | cost     | 状态变化描述 | [§3.1](./detail.md) |
+| `operation_b(param)` | [REQ-002] | 条件1        | cost     | 状态变化描述 | [§3.2](./detail.md) |
 
 > **填写说明**:
 > - **操作**: 使用函数签名风格 `func_name(key_params)`，参数只写关键入参类型，不写类型注解
@@ -199,12 +199,12 @@ class ISystemName(Protocol):
 
 ## 6. 数据模型 (Data Model)
 
-<!-- ⚠️ L0 写法原则 — 请严格遵守:
-  ✅ 允许: @dataclass 属性字段声明
-  ✅ 允许: Protocol 风格的方法签名 (def foo(self, x: T) -> R: ...)
-  ❌ 禁止: 任何方法体 (哪怕只有 2 行)
-  ❌ 禁止: 注释风格的方法列表 (# def foo... 这种)
-  ❌ 禁止: 配置常量字典 (UNIT_CONFIG = {...})
+<!--  L0 写法原则 — 请严格遵守:
+   允许: @dataclass 属性字段声明
+   允许: Protocol 风格的方法签名 (def foo(self, x: T) -> R: ...)
+   禁止: 任何方法体 (哪怕只有 2 行)
+   禁止: 注释风格的方法列表 (# def foo... 这种)
+   禁止: 配置常量字典 (UNIT_CONFIG = {...})
   → 以上内容全部放入 {system}.detail.md §1 和 §2。并且依据「L1 锚点原则」，你必须在此处用 Markdown 超链接指明它们在 L1 的下落，例如：
   *(完整的配置常量字典详见 [{system}.detail.md §1](./{system}.detail.md))*
 -->
@@ -266,7 +266,7 @@ classDiagram
 ---
 
 ## 8. Trade-offs & Alternatives (权衡与备选方案)
-<!-- ⚠️ CRITICAL: Google Design Docs风格 - 说明为什么选A而不是B -->
+<!--  CRITICAL: Google Design Docs风格 - 说明为什么选A而不是B -->
 
 > [!IMPORTANT]
 > **ADR 引用规则 (单向引用链)**
@@ -280,7 +280,7 @@ classDiagram
 >
 > **自检示例**:
 >
-> ❌ **错误** - 复制 ADR 内容:
+>  **错误** - 复制 ADR 内容:
 > ```markdown
 > ### 8.1 数据库选型
 > 我们选择 PostgreSQL 因为:
@@ -290,7 +290,7 @@ classDiagram
 > (这些理由已在 ADR-001 中记录,不应复制)
 > ```
 >
-> ✅ **正确** - 引用 ADR:
+>  **正确** - 引用 ADR:
 > ```markdown
 > ### 8.1 数据库选型
 > > **决策来源**: [ADR-001: 技术栈选型](../03_ADR/ADR_001_TECH_STACK.md)
@@ -316,16 +316,16 @@ classDiagram
 
 <!-- 如果此决策只影响本系统，在此详细说明 -->
 
-**Option A: [名称] (✅ Selected)**
-- ✅ **优点**: 
+**Option A: [名称] ( Selected)**
+- **优点**: 
   - ...
-- ❌ **缺点**:
+- **缺点**:
   - ...
 
 **Option B: [名称]**
-- ✅ **优点**:
+- **优点**:
   - ...
-- ❌ **缺点**:
+- **缺点**:
   - ...
 
 **Decision**: 选择 [Option A]，因为 [核心理由]。
@@ -348,13 +348,13 @@ classDiagram
 <!-- 示例：本系统特有决策 -->
 ### 8.y 示例: 缓存策略 (本系统决策)
 
-**Option A: Redis (✅ Selected)**
-- ✅ 高性能，团队熟悉
-- ❌ 需要额外运维
+**Option A: Redis ( Selected)**
+- 高性能，团队熟悉
+- 需要额外运维
 
 **Option B: 内存缓存**
-- ✅ 简单
-- ❌ 不支持分布式
+- 简单
+- 不支持分布式
 
 **Decision**: 选择 Redis，因为本系统需要支持多实例部署。
 
@@ -581,7 +581,7 @@ classDiagram
 
 ---
 
-<!-- ⚠️ AGENT 使用指南
+<!--  AGENT 使用指南
 
 L0 撰写九律:
 1. 导航层定位 — 不展示实现细节，面向快速理解与任务规划