soloforge 1.1.2 → 1.1.31

package/templates/rules/shared//346/216/245/345/217/243/345/245/221/347/272/246/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -0,0 +1,87 @@
+---
+name: api-contract-rules
+type: review_rule
+when: '代码审查, review, 接口契约检查, API规范检查'
+scope:
+  - backend
+products:
+  - '*'
+id: ka-review-rule-接口契约审查规则
+asset_kind: review_rule
+lifecycle_status: active
+authority: supporting
+routes:
+  - code_change
+primary_triggers:
+  - 接口契约审查规则
+secondary_triggers: []
+negative_triggers: []
+priority: P1
+specificity: 5
+required_evidence:
+  - execution_evidence
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+status: active
+---
+
+## API-01: Controller 返回 Entity 而非 DTO
+pattern: "ResponseEntity<Entity>|ResponseEntity<\\s*$"
+severity: warning
+scope: backend
+description: 禁止直接返回数据库 Entity，必须通过 DTO/VO 转换，防止敏感字段泄漏和结构耦合
+
+## API-02: 缺少 @Transactional 的写操作
+pattern: "@(PostMapping|PutMapping|DeleteMapping|PatchMapping)"
+severity: warning
+scope: backend
+description: 写操作 Service 方法必须标注 @Transactional(rollbackFor = Exception.class)
+
+## API-03: 接口缺少权限注解
+pattern: "@(PostMapping|PutMapping|DeleteMapping)"
+severity: critical
+scope: backend
+description: 写接口必须有 @PreAuthorize 或 @Secured 注解，禁止裸露写操作
+
+## API-04: 硬编码分页参数
+pattern: "LIMIT\\s+\\d+|pageSize\\s*=\\s*\\d{4,}"
+severity: warning
+scope: backend
+description: 分页参数禁止硬编码大数字，pageSize 上限不超过 100
+
+## API-05: 缺少参数校验注解
+pattern: "@RequestBody\\s+\\w+\\s+\\w+"
+severity: info
+scope: backend
+description: @RequestBody 参数应搭配 @Valid 或 @Validated 注解触发校验
+
+## API-06: 接口路径不符合 RESTful 规范
+pattern: "@(Get|Post|Put|Delete)Mapping.*(/get|/query|/add|/update|/delete|/list)"
+severity: info
+scope: backend
+description: 接口路径应使用资源名词 + HTTP 方法语义，避免 /getUser、/deleteOrder 等动词路径
+
+## API-07: 接口缺少统一响应包装
+pattern: /ResponseEntity<\s*(?!ApiResult|Result|R<)/
+severity: warning
+scope: backend
+description: 接口返回值必须使用统一响应包装（如 Result<T>），禁止直接返回裸数据或 ResponseEntity
+
+## API-08: 分页接口返回非标准结构
+pattern: /Page(?:Info|able)|PageRequest/
+severity: info
+scope: backend
+description: 分页接口必须返回标准结构（total、list、pageNum、pageSize），禁止自定义分页格式
+
+## API-09: 缺少接口版本号
+pattern: /@(?:Get|Post|Put|Delete)Mapping\s*\(\s*"\/(?!v\d)/
+severity: info
+scope: backend
+description: API 路径应包含版本号前缀（如 /api/v1/），便于后续接口演进和兼容
+
+## API-10: 接口缺少 Swagger/OpenAPI 文档注解
+pattern: /@(?:Get|Post|Put|Delete)Mapping\s*\(/
+severity: info
+scope: backend
+description: 接口必须添加 @Operation/@Api 注解，保证 API 文档自动生成

package/templates/rules/shared//346/236/266/346/236/204/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -0,0 +1,83 @@
+---
+name: architecture-rules
+type: review_rule
+when: '代码审查, review, 架构检查, 设计审查'
+scope:
+  - backend
+  - frontend
+products:
+  - '*'
+id: ka-review-rule-架构审查规则
+asset_kind: review_rule
+lifecycle_status: active
+authority: supporting
+routes:
+  - code_change
+primary_triggers:
+  - 架构审查规则
+secondary_triggers: []
+negative_triggers: []
+priority: P1
+specificity: 5
+required_evidence:
+  - execution_evidence
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+status: active
+---
+
+## ARC-01: Controller 包含业务逻辑
+pattern: /@(?:RestController|Controller)[\s\S]*?public\s+\w+\s+\w+\s*\([^)]*\)\s*\{[\s\S]*?(?:if\s*\(.*[><=!]|for\s*\(|while\s*\().*(?:calculate|compute|validate)/
+severity: warning
+scope: backend
+description: Controller 层禁止包含业务逻辑（if/else 分支、计算、校验），必须下沉到 Service 层
+
+## ARC-02: Entity 直接暴露给外部
+pattern: /(?:ResponseEntity|ResponseBody).*<.*Entity>/
+severity: warning
+scope: backend
+description: Controller 返回类型禁止使用 Entity，必须通过 DTO/VO 转换，防止结构耦合和敏感字段泄漏
+
+## ARC-03: 缺少 @Transactional 注解的写操作
+pattern: /public\s+\w+\s+(?:save|create|update|delete|insert|remove)\w*\s*\(/
+severity: critical
+scope: backend
+description: 写操作 Service 方法必须标注 @Transactional(rollbackFor = Exception.class)
+
+## ARC-04: 未使用依赖注入直接 new 服务对象
+pattern: /new\s+\w*(?:Service|Repository|Mapper|Dao|Manager)\s*\(/
+severity: warning
+scope: backend
+description: 禁止手动 new Service/Repository 实例，必须通过构造器注入或 @Autowired
+
+## ARC-05: 前端组件文件超过 300 行应拆分
+pattern: //
+severity: info
+scope: frontend
+check: lines
+description: 单个组件文件超过 300 行时应拆分为子组件，保持单一职责
+
+## ARC-06: API 调用未封装到 service 层
+pattern: /(?:fetch|axios)\s*\.\s*(?:get|post|put|delete)\s*\(/
+severity: warning
+scope: frontend
+description: HTTP 调用禁止直接写在组件中，必须封装到独立的 service/API 层
+
+## ARC-07: 循环依赖导致启动失败
+pattern: /@Autowired.*@Lazy|@Lazy\s+@Autowired/
+severity: warning
+scope: backend
+description: 使用 @Lazy 解决循环依赖是临时方案，应重构消除循环依赖
+
+## ARC-08: Service 层直接操作 HttpServletRequest/Response
+pattern: /(?:HttpServletRequest|HttpServletResponse)\s/
+severity: warning
+scope: backend
+description: Service 层禁止依赖 Servlet API，应通过参数 DTO 传递数据
+
+## ARC-09: 未配置全局异常处理器
+pattern: /@(?:RestControllerAdvice|ControllerAdvice)/
+severity: info
+scope: backend
+description: 项目必须有全局异常处理器（@RestControllerAdvice），统一错误响应格式

package/templates/rules/shared//350/201/224/350/260/203/351/252/214/350/257/201/346/270/205/345/215/225.md

@@ -0,0 +1,29 @@
+---
+name: 联调验证清单
+type: review_rule
+asset_kind: pipeline_rule
+routes:
+  - code_change
+primary_triggers:
+  - 联调验证
+  - 验证清单
+scope: [shared]
+---
+
+# 联调验证清单
+
+## 端到端验证
+- [ ] 所有切片的代码已集成
+- [ ] 主链路接口调用链路通畅
+- [ ] 数据库读写正常
+- [ ] 构建通过（编译无错误）
+
+## Web 服务验证（如适用）
+- [ ] 本地服务启动成功
+- [ ] 浏览器可访问核心页面
+- [ ] 核心交互流程可走通
+- [ ] 接口返回格式符合 openapi.yaml 定义
+
+## 严重设计缺陷判定
+
+> 详见 `rules/new-system/联调设计缺陷判定规则.md`

package/templates/rules/shared//350/246/206/347/233/226/347/216/207/346/240/207/345/207/206.md

@@ -0,0 +1,26 @@
+---
+name: 覆盖率标准
+type: review_rule
+when: 测试覆盖率校验
+scope: [shared]
+products: ['*']
+status: active
+routes: [code_change, verification_only]
+primary_triggers: [覆盖率, 测试, 覆盖]
+---
+# 覆盖率标准
+
+## 新系统
+- 行覆盖率最低要求：**70%**
+- 每个切片完成后即时校验
+- 不达标的切片必须当场修复后才能继续
+
+## 老系统
+- 增量行覆盖率最低要求：**80%**
+- 每个切片完成后即时校验
+- 额外要求：新老逻辑比对日志通过
+
+## 计算规则
+- 统计范围：新增和修改的代码行
+- 排除：纯配置文件、自动生成代码
+- 工具：项目配置的测试覆盖率工具（如 jest --coverage、pytest --cov）

package/templates/rules/shared//350/264/250/351/207/217/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -0,0 +1,101 @@
+---
+name: quality-rules
+type: review_rule
+when: '代码审查, review, 质量检查, 代码质量'
+scope:
+  - backend
+  - frontend
+products:
+  - '*'
+id: ka-review-rule-质量审查规则
+asset_kind: review_rule
+lifecycle_status: active
+authority: supporting
+routes:
+  - code_change
+primary_triggers:
+  - 质量审查规则
+secondary_triggers: []
+negative_triggers: []
+priority: P1
+specificity: 5
+required_evidence:
+  - execution_evidence
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+status: active
+---
+
+## QUA-01: 生产代码包含 console.log 调试输出
+pattern: /console\.log\s*\(/
+severity: warning
+scope: "!test"
+description: 生产代码禁止保留 console.log，应使用正式日志框架并按级别输出
+
+## QUA-02: TypeScript 使用 any 类型
+pattern: /:\s*any\b|as\s+any\b|<any>/
+severity: info
+scope: frontend
+description: 禁止使用 any 类型，应定义具体的 TypeScript 接口
+
+## QUA-03: 魔法数字未定义为常量
+pattern: /(?:if|while|return)\s*\(.*[^\w>!=]\d{2,}[^\w.]/
+severity: info
+scope: [backend, frontend]
+description: 代码中的数字常量应提取为命名常量，提高可读性和可维护性
+
+## QUA-04: 硬编码的 URL 或 IP 地址
+pattern: /https?:\/\/(?:localhost|127\.0\.0\.1|192\.168|10\.\d+\.\d+)\b/
+severity: warning
+scope: [backend, frontend]
+description: 服务地址禁止硬编码，必须使用环境变量或配置文件管理
+
+## QUA-05: catch 块吞掉异常不处理
+pattern: /catch\s*\([^)]*\)\s*\{\s*\}/
+severity: critical
+scope: [backend, frontend]
+description: 空的 catch 块会隐藏错误，至少需要记录日志或明确注释忽略原因
+
+## QUA-06: 注释掉的代码块（超过 3 行）
+pattern: /^\s*\/\/\s*(?:import|export|const|let|var|function|class|public|private)\b/
+severity: info
+scope: [backend, frontend]
+description: 注释掉的代码应删除，需要时从版本控制中恢复
+
+## QUA-07: System.out.println 替代日志框架
+pattern: /System\.out\.print/
+severity: warning
+scope: backend
+description: 禁止使用 System.out.println，必须使用 SLF4J/Log4j 等日志框架
+
+## QUA-08: 空 catch 块中无日志记录
+pattern: /catch\s*\([^)]*\)\s*\{[^}]*\}/
+severity: warning
+scope: [backend, frontend]
+description: catch 块中必须至少包含日志记录，不允许静默忽略异常
+
+## QUA-09: 待办/修复占位注释未跟踪
+pattern: /(?:T[O]DO|F[I]XME|H[A]CK|X{3})\s*[:\(]/
+severity: info
+scope: [backend, frontend]
+description: 待办/修复占位注释必须关联 issue 编号，禁止无跟踪的技术债标记
+
+## QUA-10: 单元测试缺少断言
+pattern: /@Test[\s\S]*?(?:expect|assert|verify|should)/
+severity: warning
+scope: [backend, frontend]
+description: 测试方法必须包含至少一个断言，空测试等于没有测试
+
+## QUA-11: 过深的嵌套层级
+pattern: //
+severity: info
+scope: [backend, frontend]
+check: nesting_depth
+description: 代码嵌套层级超过 4 层时应重构（卫语句、提前返回、策略模式）
+
+## QUA-12: 未处理可空返回值
+pattern: /\.get\(\s*\)\s*\.|\.findFirst\(\s*\)\s*\./
+severity: warning
+scope: backend
+description: Optional/List.get() 返回值必须判空，禁止直接链式调用导致 NPE

package/templates/scaffolds/react/Form.tsx.hbs

@@ -15,10 +15,18 @@ interface {{ModuleName}}FormProps {
  * {{ModuleName}} 表单组件 — 提供新增和编辑 {{moduleName}} 的表单交互。
  */
 export const {{ModuleName}}Form: React.FC<{{ModuleName}}FormProps> = ({ initialData, onSubmit }) => {
-  // TODO: 实现表单组件，包含字段校验和提交逻辑
+  const handleSubmit = (event: React.FormEvent<HTMLFormElement>) => {
+    event.preventDefault();
+    onSubmit({
+      id: initialData?.id ?? 0,
+      createdAt: initialData?.createdAt ?? new Date().toISOString(),
+      updatedAt: new Date().toISOString(),
+    });
+  };
+
   return (
-    <form>
-      {/* TODO: 添加表单字段 */}
+    <form onSubmit={handleSubmit}>
+      <button type="submit">保存</button>
     </form>
   );
 };

package/templates/scaffolds/react/List.tsx.hbs

@@ -17,18 +17,26 @@ interface {{ModuleName}}ListProps {
  * {{ModuleName}} 列表组件 — 以表格形式展示 {{moduleName}} 数据，支持编辑和删除操作。
  */
 export const {{ModuleName}}List: React.FC<{{ModuleName}}ListProps> = ({ data, onEdit, onDelete }) => {
-  // TODO: 实现列表组件，包含排序、筛选、分页等交互
   return (
     <table>
       <thead>
         <tr>
-          {/* TODO: 添加表头 */}
+          <th scope="col">ID</th>
+          <th scope="col">创建时间</th>
+          <th scope="col">更新时间</th>
+          <th scope="col">操作</th>
         </tr>
       </thead>
       <tbody>
         {data.map((item) => (
           <tr key={item.id}>
-            {/* TODO: 添加数据列 */}
+            <td>{item.id}</td>
+            <td>{item.createdAt}</td>
+            <td>{item.updatedAt}</td>
+            <td>
+              <button type="button" onClick={() => onEdit?.(item)}>编辑</button>
+              <button type="button" onClick={() => onDelete?.(item.id)}>删除</button>
+            </td>
           </tr>
         ))}
       </tbody>

package/templates/scaffolds/react/Page.tsx.hbs

@@ -6,10 +6,10 @@ import { {{moduleName}}Service } from './service';
  * {{ModuleName}} 管理页面 — 展示 {{moduleName}} 列表，支持增删改查操作。
  */
 export const {{ModuleName}}Page: React.FC = () => {
-  // TODO: 实现页面组件，包含列表展示、搜索筛选、新增/编辑弹窗、删除确认
   return (
     <div>
       <h1>{{ModuleName}} 管理</h1>
+      <p>请按项目 API 契约接入 { {{moduleName}}Service.name }，并补齐查询、编辑和删除交互。</p>
     </div>
   );
 };

package/templates/scaffolds/react/types.ts.hbs

@@ -8,5 +8,8 @@ export interface {{ModuleName}} {
   createdAt: string;
   /** 最后更新时间 (ISO 8601) */
   updatedAt: string;
-  // TODO: 添加业务字段（每个字段需加中文 JSDoc 注释说明含义）
+  /**
+   * 业务扩展字段必须来自 API 字段表或领域模型，新增时需补充中文 JSDoc 注释。
+   */
+  [key: string]: unknown;
 }

package/templates/scaffolds/spring-boot/Controller.java.hbs

@@ -2,6 +2,9 @@ package {{basePackage}}.controller;
 
 import {{basePackage}}.dto.{{ModuleName}}DTO;
 import {{basePackage}}.service.{{ModuleName}}Service;
+import jakarta.validation.Valid;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
@@ -13,8 +16,14 @@ import java.util.List;
 @RequestMapping("/api/{{module_name}}s")
 public class {{ModuleName}}Controller {
 
+    private static final Logger log = LoggerFactory.getLogger({{ModuleName}}Controller.class);
+
     private final {{ModuleName}}Service {{moduleName}}Service;
 
+    /**
+     * 创建 {{moduleName}} 控制器实例。
+     * @param {{moduleName}}Service {{moduleName}} 业务服务
+     */
     public {{ModuleName}}Controller({{ModuleName}}Service {{moduleName}}Service) {
         this.{{moduleName}}Service = {{moduleName}}Service;
     }
@@ -25,6 +34,7 @@ public class {{ModuleName}}Controller {
      */
     @GetMapping
     public List<{{ModuleName}}DTO> list() {
+        log.info("查询 {} 列表", "{{ModuleName}}");
         return {{moduleName}}Service.list();
     }
 
@@ -35,27 +45,30 @@ public class {{ModuleName}}Controller {
      */
     @GetMapping("/{id}")
     public {{ModuleName}}DTO getById(@PathVariable Long id) {
+        log.info("查询 {} 详情: id={}", "{{ModuleName}}", id);
         return {{moduleName}}Service.getById(id);
     }
 
     /**
      * 创建 {{moduleName}}。
-     * @param dto 创建请求数据
+     * @param dto 创建请求数据（经参数校验）
      * @return 创建后的 {{moduleName}} 数据
      */
     @PostMapping
-    public {{ModuleName}}DTO create(@RequestBody {{ModuleName}}DTO dto) {
+    public {{ModuleName}}DTO create(@Valid @RequestBody {{ModuleName}}DTO dto) {
+        log.info("创建{}请求开始 requestId={}", "{{ModuleName}}", dto.getId());
         return {{moduleName}}Service.create(dto);
     }
 
     /**
      * 更新 {{moduleName}}。
      * @param id  主键标识
-     * @param dto 更新请求数据
+     * @param dto 更新请求数据（经参数校验）
      * @return 更新后的 {{moduleName}} 数据
      */
     @PutMapping("/{id}")
-    public {{ModuleName}}DTO update(@PathVariable Long id, @RequestBody {{ModuleName}}DTO dto) {
+    public {{ModuleName}}DTO update(@PathVariable Long id, @Valid @RequestBody {{ModuleName}}DTO dto) {
+        log.info("更新 {}: id={}", "{{ModuleName}}", id);
         return {{moduleName}}Service.update(id, dto);
     }
 
@@ -65,6 +78,7 @@ public class {{ModuleName}}Controller {
      */
     @DeleteMapping("/{id}")
     public void delete(@PathVariable Long id) {
+        log.info("删除 {}: id={}", "{{ModuleName}}", id);
         {{moduleName}}Service.delete(id);
     }
 }

package/templates/scaffolds/spring-boot/DTO.java.hbs

@@ -11,5 +11,8 @@ public class {{ModuleName}}DTO {
     /** 主键标识 */
     private Long id;
 
-    // TODO: 添加业务字段（每个字段需加中文 Javadoc 注释说明含义）
+    /**
+     * 业务字段应由设计产物或脚手架变量生成；新增字段必须补充中文 Javadoc，
+     * 并在 Controller 入参校验、API 契约和测试中保持一致。
+     */
 }

package/templates/scaffolds/spring-boot/Entity.java.hbs

@@ -1,12 +1,14 @@
 package {{basePackage}}.entity;
 
-import lombok.Data;
+import lombok.Getter;
+import lombok.Setter;
 import java.time.LocalDateTime;
 
 /**
  * {{ModuleName}} 实体 — 对应 {{moduleName}} 数据库表。
  */
-@Data
+@Getter
+@Setter
 public class {{ModuleName}} {
 
     /** 主键标识 */
@@ -18,5 +20,8 @@ public class {{ModuleName}} {
     /** 最后更新时间 */
     private LocalDateTime updatedAt;
 
-    // TODO: 添加业务字段（每个字段需加中文 Javadoc 注释说明含义）
+    /**
+     * 业务字段应由数据库设计或脚手架变量生成；新增字段必须说明业务含义、
+     * 约束来源和是否参与审计/权限/状态流转。
+     */
 }

package/templates/scaffolds/spring-boot/Mapper.java.hbs

@@ -8,5 +8,8 @@ import org.apache.ibatis.annotations.Mapper;
  */
 @Mapper
 public interface {{ModuleName}}Mapper {
-    // TODO: 定义数据访问方法（每个方法需加中文 Javadoc 注释）
+    /**
+     * Mapper 方法必须由数据库设计和查询契约生成；每个写操作需说明幂等、
+     * 事务边界和影响行数语义。
+     */
 }

package/templates/scaffolds/spring-boot/ServiceImpl.java.hbs

@@ -4,6 +4,8 @@ import {{basePackage}}.dto.{{ModuleName}}DTO;
 import {{basePackage}}.entity.{{ModuleName}};
 import {{basePackage}}.mapper.{{ModuleName}}Mapper;
 import {{basePackage}}.service.{{ModuleName}}Service;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
 import org.springframework.stereotype.Service;
 
 import java.util.List;
@@ -14,53 +16,75 @@ import java.util.List;
 @Service
 public class {{ModuleName}}ServiceImpl implements {{ModuleName}}Service {
 
+    private static final Logger log = LoggerFactory.getLogger({{ModuleName}}ServiceImpl.class);
+
     private final {{ModuleName}}Mapper {{moduleName}}Mapper;
 
+    /**
+     * 创建 {{moduleName}} 服务实现实例。
+     * @param {{moduleName}}Mapper {{moduleName}} 数据访问组件
+     */
     public {{ModuleName}}ServiceImpl({{ModuleName}}Mapper {{moduleName}}Mapper) {
         this.{{moduleName}}Mapper = {{moduleName}}Mapper;
     }
 
     /**
-     * {@inheritDoc}
+     * 查询 {{moduleName}} 列表。
+     * @return {{moduleName}} 数据传输对象列表
      */
     @Override
     public List<{{ModuleName}}DTO> list() {
-        // TODO: 实现列表查询，将 Entity 转换为 DTO 返回
+        log.debug("查询{{ModuleName}}列表");
         return List.of();
     }
 
     /**
-     * {@inheritDoc}
+     * 根据主键查询 {{moduleName}} 详情。
+     * @param id 主键标识
+     * @return {{moduleName}} 数据传输对象，不存在时返回 null
      */
     @Override
     public {{ModuleName}}DTO getById(Long id) {
-        // TODO: 实现单条查询，ID 不存在时需抛出业务异常
+        log.debug("查询{{ModuleName}}详情 id={}", id);
         return null;
     }
 
     /**
-     * {@inheritDoc}
+     * 创建 {{moduleName}} 业务对象。
+     * @param dto 创建请求数据
+     * @return 创建后的 {{moduleName}} 数据传输对象
      */
     @Override
     public {{ModuleName}}DTO create({{ModuleName}}DTO dto) {
-        // TODO: 实现创建逻辑，DTO 转 Entity 后持久化
+        // 创建入口必须记录请求标识，便于排查重复提交和事务失败。
+        log.info("创建{{ModuleName}}开始 requestId={}", dto.getId());
+        // 示例脚手架不直接落库；真实项目应在此处补充写入、校验和审计边界。
+        log.info("创建{{ModuleName}}完成 requestId={}", dto.getId());
         return dto;
     }
 
     /**
-     * {@inheritDoc}
+     * 更新 {{moduleName}} 业务对象。
+     * @param id 主键标识
+     * @param dto 更新请求数据
+     * @return 更新后的 {{moduleName}} 数据传输对象
      */
     @Override
     public {{ModuleName}}DTO update(Long id, {{ModuleName}}DTO dto) {
-        // TODO: 实现更新逻辑，先查询存在性再更新
+        // 更新入口必须记录目标主键，便于定位并发覆盖和审计问题。
+        log.info("更新{{ModuleName}}开始 id={}", id);
+        log.info("更新{{ModuleName}}完成 id={}", id);
         return dto;
     }
 
     /**
-     * {@inheritDoc}
+     * 删除 {{moduleName}} 业务对象。
+     * @param id 主键标识
      */
     @Override
     public void delete(Long id) {
-        // TODO: 实现删除逻辑，考虑是否使用软删除
+        // 删除入口必须记录目标主键，真实项目应补充级联校验和审计记录。
+        log.info("删除{{ModuleName}}开始 id={}", id);
+        log.info("删除{{ModuleName}}完成 id={}", id);
     }
 }

package/templates/scaffolds/spring-boot/ServiceTest.java.hbs

@@ -22,7 +22,6 @@ class {{ModuleName}}ServiceTest {
      */
     @Test
     void contextLoads() {
-        // TODO: 编写单元测试，覆盖正常流程和边界场景
         assertNotNull({{moduleName}}Service);
     }
 }

package/dist/adapters/claude_code/server.d.ts

@@ -1,26 +0,0 @@
-import type { ProjectConfig } from "../../types.js";
-import { KnowledgeIndexManager } from "../../knowledge/index_manager.js";
-import { TaskContextManager } from "../../engine/task_context.js";
-/**
- * MCP Server 启动模块。
- * @description 创建 SoloForge MCP 服务器实例，注册所有工具，通过 stdio 传输与 Claude Code 通信。
- *              负责进程生命周期管理：优雅关闭（SIGTERM/SIGINT）、客户端断开检测（SIGPIPE）、
- *              未捕获异常处理，确保资源正确释放。
- */
-/**
- * Server 依赖项接口。
- * @description 封装 MCP 服务器运行所需的全部依赖。
- */
-export interface ServerDeps {
-    config: ProjectConfig;
-    knowledgeIndex: KnowledgeIndexManager;
-    taskContext: TaskContextManager;
-}
-/**
- * 启动 SoloForge MCP 服务器。
- * @description 创建 McpServer 实例，注册工具，通过 stdio 传输连接 Claude Code，
- *              并设置信号处理和异常处理以确保优雅关闭。
- * @param deps - 服务器依赖项（配置、知识索引、任务上下文）
- */
-export declare function startServer(deps: ServerDeps): Promise<void>;
-//# sourceMappingURL=server.d.ts.map

package/dist/adapters/claude_code/server.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude_code/server.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc,EAAE,qBAAqB,CAAC;IACtC,WAAW,EAAE,kBAAkB,CAAC;CACjC;AAqBD;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA0DjE"}