@lark-apaas/coding-steering 0.1.6-alpha.8 → 0.1.6-beta.0

package/steering/nestjs-react-fullstack/skills/client-builtins-user-service/SKILL.md

@@ -10,6 +10,7 @@ match-template-name: nestjs-react-fullstack
 # Dataloom 用户信息与鉴权 SDK
 
 ## 概述
+
 项目提供了 Dataloom SDK 的用户信息与鉴权服务，用于用户登录、登出、获取用户信息等身份认证相关功能。
 
 > **边界说明**：`dataloom.service.session` 仅用于用户登录/登出/获取用户信息等鉴权操作。**插件调用（capability）不属于 dataloom**，须使用独立的 `capabilityClient`（参见 plugin-guide）。
@@ -17,6 +18,7 @@ match-template-name: nestjs-react-fullstack
 ## 统一响应结构
 
 ### 响应类型定义
+
 ```typescript
 /**
  * 统一结果返回结构
@@ -57,6 +59,7 @@ type DataloomServiceResponse<T> = DataloomServiceSuccess<T> | DataloomServiceFai
 ```
 
 ## Dataloom实例获取方式
+
 ```typescript
 import { getDataloom } from "@lark-apaas/client-toolkit/dataloom";
 
@@ -69,12 +72,15 @@ const dataloom = await getDataloom();
 #### 1. 登录跳转接口 (redirectToLogin)
 
 ##### 用途
+
 跳转至 Dataloom 登录页面，适用于：用户身份认证、单点登录、权限验证
 
 ##### 适用场景
+
 需要用户进行身份认证的场景
 
 ##### 入参说明
+
 ```typescript
 interface SignInRedirectionOptions {
   /**
@@ -94,6 +100,7 @@ interface SignInRedirectionOptions {
 | `newTab` | `boolean` | ❌ | `false` | 是否在新浏览器标签页打开登录页 |
 
 ##### 出参说明
+
 | 字段名 | 类型 | 说明 |
 |--------|------|---------|
 | `data` | `'success'` | 成功标识 |
@@ -102,6 +109,7 @@ interface SignInRedirectionOptions {
 | `statusText` | `'OK'` | HTTP状态文本 |
 
 ##### 使用示例
+
 ```typescript
 /**
  * 跳转至dataloom登录页
@@ -139,15 +147,19 @@ const loginResult = dataloom
 #### 2. 退出登录接口 (signOut)
 
 ##### 用途
+
 退出登录，删除cookie中的登录态，适用于：用户主动登出、会话清理、安全退出
 
 ##### 适用场景
+
 需要清除用户登录状态的场景
 
 ##### 入参说明
+
 无需传入参数
 
 ##### 出参说明
+
 | 字段名 | 类型 | 说明 |
 |--------|------|---------|
 | `data` | `null` | 数据为空 |
@@ -156,6 +168,7 @@ const loginResult = dataloom
 | `statusText` | `'OK'` | HTTP状态文本 |
 
 ##### 使用示例
+
 ```typescript
 /**
  * 退出登录，删除cookie中的登陆态
@@ -196,12 +209,15 @@ try {
 #### 3. 跳转用户详情页接口 (navigateToUserProfile)
 
 ##### 用途
+
 跳转至当前登录用户的详情页，适用于：查看个人资料、从用户头像/姓名点击进入详情页面
 
 ##### 适用场景
+
 需要在应用中快速打开用户详情页面的场景
 
 ##### 入参说明
+
 ```typescript
 interface NavigateToUserProfileOptions {
   /**
@@ -216,6 +232,7 @@ interface NavigateToUserProfileOptions {
 | `newTab` | `boolean` | ❌ | `false` | 是否在新浏览器标签页打开详情页 |
 
 ##### 出参说明
+
 | 字段名 | 类型 | 说明 |
 |--------|------|---------|
 | `data` | `'success'` | 成功标识 |
@@ -224,6 +241,7 @@ interface NavigateToUserProfileOptions {
 | `statusText` | `'OK'` | HTTP状态文本 |
 
 ##### 使用示例
+
 ```typescript
 /**
  * 跳转至用户详情页
@@ -252,12 +270,15 @@ const resNewTab = dataloom
 #### 4. 获取用户信息接口 (getUserInfo)
 
 ##### 用途
+
 根据当前登录态获取已登录的用户信息，适用于：用户资料展示、权限判断、个性化配置
 
 ##### 适用场景
+
 需要获取当前登录用户详细信息的场景
 
 ##### 数据类型定义
+
 ```typescript
 interface I18n {
   language_code: number;
@@ -289,9 +310,11 @@ interface UserInfoResponse {
 ```
 
 ##### 入参说明
+
 无需传入参数
 
 ##### 出参说明
+
 | 字段名 | 类型 | 说明 |
 |--------|------|---------|
 | `data.user_info` | `UserBaseInfo` | 用户基本信息对象 |
@@ -304,6 +327,7 @@ interface UserInfoResponse {
 | `error` | `null` | 错误信息，成功时为null |
 
 ##### 使用示例
+
 ```typescript
 /**
  * 根据当前登陆态获取已登录的用户信息。
@@ -359,6 +383,7 @@ try {
 ## 错误处理
 
 ### 常见错误类型
+
 | 错误码 | 说明 | 处理建议 |
 |--------|------|---------|
 | `400` | 请求参数错误 | 检查传入参数是否正确 |
@@ -368,6 +393,7 @@ try {
 | `500` | 服务器内部错误 | 稍后重试或联系技术支持 |
 
 ### 错误处理最佳实践
+
 ```typescript
 // 统一错误处理函数
 function handleDataloomError(response: DataloomServiceResponse<any>) {
@@ -414,12 +440,15 @@ if (handleDataloomError(userInfoResult)) {
 # 用户系统前端相关规范
 
 ## 概述
+
 内置的用户前端组件规范，提供了 UserSelect（支持单选/多选的用户选择器）和 UserDisplay（用户信息展示组件）两个核心 React 组件，基于统一的userid数据，并且用户选择组件中会通过onchange返回User类型数据，专门用于处理用户相关的表单输入和数据展示场景。
 
 同时提供 DepartmentSelect（部门选择组件），用于部门字段的单选/多选选择，交互与受控规范与 UserSelect 保持一致。
+
 ## 类型定义
 
 ### 用户数据类型
+
 ```typescript
 import type { User } from '@/types/common';
 ```
@@ -437,6 +466,7 @@ export type User = {
 ## 当前用户信息的获取方案
 
 ### 常用场景
+
 - **用户信息展示**：在界面中显示当前用户名称和头像
 - **权限验证**：基于用户ID进行权限检查和控制
 - **数据关联**：在数据操作时关联当前用户信息
@@ -445,6 +475,7 @@ export type User = {
 ### Hooks 方法: `useCurrentUserProfile` - 在 React 中获取当前用户信息
 
 ### 基本信息
+
 - **文件路径**：`@lark-apaas/client-toolkit/hooks/useCurrentUserProfile`
 - **功能**：获取当前登录用户的个人信息（含飞书 user_id）
 - **返回值**：`Partial<IUserProfile>`（初始为空对象 `{}`，异步获取后填充完整字段）
@@ -460,12 +491,14 @@ export type User = {
 | `lark_user_id` | `string` | 飞书 user_id，通过额外异步请求获取，可能晚于其他字段就绪 |
 
 > ⚠️ **空值处理（CRITICAL）**：该 Hook 初始返回空对象 `{}`（truthy），所有字段均为 `undefined`。
+>
 > - **MUST** 使用可选链访问：`userInfo?.name`、`userInfo?.user_id`
 > - **MUST** 判断加载状态用 `if (!userInfo?.user_id)` 而非 `if (!userInfo)`（空对象是 truthy）
 > - **MUST** 渲染时提供默认值：`userInfo?.name ?? '加载中...'`
 > - **MUST** `lark_user_id` 通过额外异步请求获取，可能为 `undefined`（加载中/获取失败/无飞书账号），使用时必须条件渲染
 
 ### 使用方法
+
 ```typescript
 import { useCurrentUserProfile } from "@lark-apaas/client-toolkit/hooks/useCurrentUserProfile";
 
@@ -486,143 +519,22 @@ const MyComponent = () => {
 > **飞书 ID 转换详细指南**（后端 `AuthNPaasService` 用法、自定义转换接口等）参见 `user-identity` skill。
 
 ## 用户展示与选择方案
-{% if projectMeta['flags']['supportBusinessUser'] %}
+
 这些组件在使用之前必须读取 client/src/components/business-ui/README.md文件来理解用法
 
 目前可用的组件有：
+
 - UserSelect 用户选择组件（@/components/business-ui/user-select）
 - DepartmentSelect 部门选择组件（@/components/business-ui/department-select）
 - UserDisplay - 用户展示组件（@/components/business-ui/user-display）
 
-{% else %}
- ## 
-
-### 基本信息
-- **组件路径**：`@lark-apaas/client-toolkit/components/User`
-- **功能**：用于所有用户字段的表单输入
-- **特性**：支持单选/多选模式，内置搜索功能
-
-### 组件 Props 定义
-```typescript
-interface UserSelectProps {
-  mode: 'single' | 'multiple';  // 选择模式
-  value?: string | string[];  // 当前userid的值
-  onChange?: (value: IUserProfile | IUserProfile[]) => void;  // userid值变化回调
-  placeholder?: string;  // 占位符文本
-  disabled?: boolean;    // 是否禁用
-}
-```
-
-### 值类型说明
-- **单选模式** (`mode="single"`)：值为 userid，返回为`IUserProfile` 对象
-- **多选模式** (`mode="multiple"`)：值为 userid数组，返回为`IUserProfile` 数组
-
-### 使用示例
-
-#### 表单集成
-```typescript
-import { useForm } from "react-hook-form";
-import { zodResolver } from "@hookform/resolvers/zod";
-import * as z from "zod";
-import { Form, FormControl, FormField, FormItem, FormLabel } from "@/components/ui/form";
-import { UserSelect } from "@lark-apaas/client-toolkit/components/User";
-
-// 定义表单验证schema
-const formSchema = z.object({
-  assignee: z.string(),
-  participants: z.array(z.string()).optional(),
-});
-
-const form = useForm<z.infer<typeof formSchema>>({
-  resolver: zodResolver(formSchema),
-});
-
-<Form {...form}>
-  <form onSubmit={form.handleSubmit(onSubmit)} className="space-y-4">
-    <FormField
-      control={form.control}
-      name="assignee"
-      render={({ field }) => (
-        <FormItem>
-          <FormLabel>负责人</FormLabel>
-          <FormControl>
-            <UserSelect
-              mode="single"
-              placeholder="选择负责人"
-              value={field.value}
-              onChange={(user) => field.onChange(user.user_id)}
-            />
-          </FormControl>
-        </FormItem>
-      )}
-    />
-
-    <FormField
-      control={form.control}
-      name="participants"
-      render={({ field }) => (
-        <FormItem>
-          <FormLabel>参与人（多选）</FormLabel>
-          <FormControl>
-            <UserSelect
-              mode="multiple"
-              placeholder="选择参与人员"
-              value={field.value}
-              onChange={(users) => field.onChange(users.map(user => user.user_id))}
-            />
-          </FormControl>
-        </FormItem>
-      )}
-    />
-  </form>
-</Form>
-```
-
-## UserDisplay - 用户展示组件
-
-### 基本信息
-- **组件路径**：`@lark-apaas/client-toolkit/components/User`
-- **功能**：用于所有用户信息的展示场景
-- **特性**：显示用户**头像**和**姓名**，支持多用户展示
-
-IMPORTANT：当不传递showLabel时，组件会同时展示用户头像和姓名，如果只需要头像，则需要传递showLabel的值为false
-
-### 属性定义
-```typescript
-interface UserDisplayProps {
-  users: string[];     // 用户id数组（必需）
-  size?: 'small' | 'medium' | 'large';  // 头像尺寸
-  className?: string;        // 自定义样式类名
-  showLabel?: boolean; // 默认为true，会展示用户姓名，如果只需要展示头像则需要设置为false
-}
-```
-
-### 使用示例
-
-#### 基础用法
-```jsx
-import { UserDisplay } from "@lark-apaas/client-toolkit/components/User";
-import { useEmployeeStore } from "@/models/employee";
-
-const { employeesId } = useEmployeeStore();
-
-// 单个用户展示
-<UserDisplay
-  users={[employeesId]}
-  size="small"
-/>
-
-// 多用户展示
-<UserDisplay
-  users={project.participants}
-  size="medium"
-  className="project-members"
-/>
-```
+<!-- legacy: client-toolkit User 组件备用方案,已不再推荐;按本地版静态化,仅保留 business-ui 路径 -->
+<!-- begin: removed Nunjucks else branch (line 532..672 in upstream) -->
+<!-- end -->
 
 ## 使用注意事项
 
 ### 最佳实践
+
 - 根据展示场景选择合适的组件尺寸（`small`、`medium`、`large`）
 - 对于用户信息 userId，禁止直接展示文本，总是使用 UserDisplay 组件展示
-{% endif %}

package/steering/nestjs-react-fullstack/skills/devops-guide/SKILL.md

@@ -0,0 +1,119 @@
+---
+name: devops-guide
+description: "Use when user needs build, deploy, run, troubleshoot, or operate a miaoda fullstack app. IMPORTANT: Only activate this skill when the user explicitly asks about deployment, build failures, or service operations. Do NOT proactively trigger this skill during normal code development — reading devops skills to troubleshoot preemptively disrupts the development workflow. Only use when: build fails, deploy fails, service crashes, or user explicitly asks about ops issues. 触发词：devops, 构建, 部署, 运维, 日志, 启动失败, 编译失败, 服务异常, read_logs, pkill, ps, pstree"
+steering: true
+steering-topic: devops
+match-template-name: nestjs-react-fullstack
+control-by-feature-ab: true
+---
+
+# DevOps Guide
+
+用于处理妙搭全栈应用的构建、部署、运行排障。
+
+核心原则：**先检查，再验证，再看日志，最后才下结论**。
+
+## Quick Reference
+
+| 场景 | 必做动作 | 结果标准 |
+|------|----------|----------|
+| 修改代码后自检 | 先跑代码检查工具 | 无语法错误、无类型错误、无明显构建错误 |
+| 修改服务端代码 | 补跑接口测试 | 每个新增接口都能验证通过 |
+| 准备交付前 | 读取最新日志 | 最新改动后无错误日志 |
+| 用户反馈编译失败 | 查 lint/typecheck + devServer 日志 | 定位到具体文件、具体报错 |
+| 用户反馈服务无响应 | 查日志 + 查进程状态 | 确认是代码报错还是 dev 进程卡死 |
+
+## Step 1：先判断问题类型
+
+### A. 代码改完后的质量保障
+
+按固定顺序执行：
+
+1. 运行代码检查工具，优先发现语法、类型、样式问题。
+2. 若改了服务端代码，执行接口测试，覆盖新增接口。
+3. 最后读取日志，确认最新改动没有引入错误日志。
+
+### B. 编译失败 / 服务启动失败 / 页面异常
+
+按定位顺序执行：
+
+1. 先查代码检查结果。
+2. 再查 devServer 日志。
+3. 必要时检查进程状态，判断 dev 进程是否失活。
+
+## Step 2：根据改动范围读取正确日志
+
+| 改动范围 | 必读日志 |
+|----------|----------|
+| 服务端代码 | `server`、`server-devserver` |
+| 客户端代码 | `client-devserver` |
+| 编译失败但范围不清楚 | `server-devserver` + `client-devserver` |
+| 请求报错 | `server`，必要时补 `trace` |
+
+规则：
+
+- **不要只看一个日志源**。
+- **不要基于旧日志下结论**，要读取最新日志。
+- 日志为空不代表没问题，先确认对应服务是否真的在运行。
+
+## Step 3：devServer 无响应时的 SOP
+
+若你发现代码已经修改，但 dev 日志长时间不更新，优先怀疑 dev 进程失活。
+
+### 检查顺序
+
+1. 用 `ps` / `pgrep` / `pstree` 确认 `dev:server`、`dev:client` 相关进程是否存在。
+2. 若进程存在但日志不更新，先把现象记录为结论，不要直接重启环境。
+3. 只有调用方明确要求时，才执行 `pkill -f "dev:server"` 或 `pkill -f "dev:client"`。
+
+### 推荐命令
+
+```bash
+ps -ef | grep "dev:server"
+ps -ef | grep "dev:client"
+pgrep -af "dev:server"
+pgrep -af "dev:client"
+pstree -p <pid>
+pkill -f "dev:server"
+pkill -f "dev:client"
+```
+
+### 判断标准
+
+- 有进程、日志持续刷新：devServer 正常，继续排查代码问题。
+- 有进程、日志不刷新：高概率卡死，先报告现象和证据。
+- 没进程：说明服务未拉起，先看最近一次 devServer 错误日志。
+
+## Step 4：构建 / 部署 / 运维排查框架
+
+按照 **现象 → 根因 → 方案** 输出。
+
+### 常见现象映射
+
+| 现象 | 高概率根因 | 优先方案 |
+|------|------------|----------|
+| 编译失败 | 语法错误、类型错误、依赖误用 | 先跑 lint / typecheck，再看 devServer 日志 |
+| 后端启动失败 | Nest 模块注册错误、配置错误、运行时异常 | 查 `server-devserver` 和 `server` |
+| 页面白屏 | 前端编译错误、运行时异常、接口异常 | 查 `client-devserver`，必要时补 `browser` |
+| 接口 500 | 服务端业务异常 | 查 `server` / `trace`，补接口测试 |
+| 热更新失效 | dev 进程卡死 | 查进程状态，不要默认重启 |
+
+## 交付要求
+
+输出排查结果时，必须包含：
+
+1. **现象**：用户看到什么错误。
+2. **根因**：定位到哪一层出问题。
+3. **证据**：哪条日志、哪段报错、哪个检查结果支撑结论。
+4. **方案**：下一步修复动作。
+
+## Common Mistakes
+
+| 错误 | 正确做法 |
+|------|----------|
+| 改完代码直接说“没问题” | 先跑代码检查，再读日志 |
+| 服务端改动后不测接口 | 必须验证新增接口 |
+| 只看 `server` 不看 `server-devserver` | 服务端至少看两个日志源 |
+| 发现无响应就直接 `pkill` | 先用 `ps` / `pgrep` / `pstree` 定位，再报告结论 |
+| `pkill` 后不复读日志 | 只有明确要求重启时才执行，并再次读日志确认 |
+| 只给结论不给证据 | 必须给日志或检查结果作为依据 |

package/steering/nestjs-react-fullstack/skills/feishu/SKILL.md

@@ -267,4 +267,3 @@ for await (const items of await client.contact.user.listWithIterator({
 | 忘记开启机器人能力 | 应用能力 → 添加机器人（发消息必须） |
 | 日期格式搞混 | 日历用 RFC3339 (`2026-01-01T09:00:00+08:00`)，考勤用整数 (`20260101`) |
 | 生成独立可运行的脚本文件 | 所有飞书调用放在 NestJS Service 方法中，由 Controller 调用 |
-

package/steering/nestjs-react-fullstack/skills/feishu/references/approval.md

@@ -1,6 +1,6 @@
 # 审批 (Approval)
 
-> 开放平台文档（Markdown 版）：https://open.larkoffice.com/document/server-docs/approval-v4/approval-overview.md
+> 开放平台文档（Markdown 版）：<https://open.larkoffice.com/document/server-docs/approval-v4/approval-overview.md>
 
 使用 `@larksuiteoapi/node-sdk` 在 NestJS 中管理飞书审批流程。
 

package/steering/nestjs-react-fullstack/skills/feishu/references/attendance.md

@@ -1,6 +1,6 @@
 # 考勤 (Attendance)
 
-> 开放平台文档（Markdown 版）：https://open.larkoffice.com/document/server-docs/attendance-v1/overview.md
+> 开放平台文档（Markdown 版）：<https://open.larkoffice.com/document/server-docs/attendance-v1/overview.md>
 
 使用 `@larksuiteoapi/node-sdk` 在 NestJS 中查询飞书考勤数据。
 

package/steering/nestjs-react-fullstack/skills/feishu/references/bitable.md

@@ -1,6 +1,6 @@
 # 多维表格 (Bitable)
 
-> 开放平台文档（Markdown 版）：https://open.larkoffice.com/document/server-docs/docs/bitable-v1/bitable-overview.md
+> 开放平台文档（Markdown 版）：<https://open.larkoffice.com/document/server-docs/docs/bitable-v1/bitable-overview.md>
 
 使用 `@larksuiteoapi/node-sdk` 在 NestJS 中操作飞书多维表格。
 
@@ -16,6 +16,7 @@
 ## 获取 app_token
 
 多维表格的 `app_token` 有三种获取方式：
+
 1. **通过 API 创建** → 响应中包含 `app_token`
 2. **通过 API 列出** → 从文件列表中获取
 3. **从 URL 提取** → 见下方 URL 解析
@@ -264,6 +265,7 @@ await client.bitable.appTableField.delete({
 ## 新建多维表格清理建议
 
 新建的多维表格会自动创建默认字段（单选、日期、附件）和空行。建议创建后清理：
+
 1. 删除不需要的默认字段（类型 3/5/17）
 2. 重命名主字段为有意义的名称
 3. 批量删除空的占位行

package/steering/nestjs-react-fullstack/skills/feishu/references/calendar.md

@@ -1,6 +1,6 @@
 # 日历与会议室 (Calendar)
 
-> 开放平台文档（Markdown 版）：https://open.larkoffice.com/document/server-docs/calendar-v4/overview.md
+> 开放平台文档（Markdown 版）：<https://open.larkoffice.com/document/server-docs/calendar-v4/overview.md>
 
 使用 `@larksuiteoapi/node-sdk` 在 NestJS 中管理日程、预约会议室和查询忙闲状态。
 

package/steering/nestjs-react-fullstack/skills/feishu/references/contacts.md

@@ -1,6 +1,6 @@
 # 通讯录 (Contacts)
 
-> 开放平台文档（Markdown 版）：https://open.larkoffice.com/document/server-docs/contact-v3/resources.md
+> 开放平台文档（Markdown 版）：<https://open.larkoffice.com/document/server-docs/contact-v3/resources.md>
 
 使用 `@larksuiteoapi/node-sdk` 在 NestJS 中查询飞书通讯录用户和部门信息。
 

package/steering/nestjs-react-fullstack/skills/feishu/references/doc.md

@@ -1,6 +1,7 @@
 # 云文档 (Document)
 
-> 开放平台文档（Markdown 版）：https://open.larkoffice.com/document/server-docs/docs/docs-overview
+> 开放平台文档（Markdown 版）：<https://open.larkoffice.com/document/server-docs/docs/docs-overview>
+.md
 
 使用 `@larksuiteoapi/node-sdk` 在 NestJS 中操作飞书云文档。
 

package/steering/nestjs-react-fullstack/skills/feishu/references/drive.md

@@ -1,6 +1,7 @@
 # 云空间 (Drive)
 
-> 开放平台文档（Markdown 版）：https://open.larkoffice.com/document/server-docs/docs/drive-v1/introduction
+> 开放平台文档（Markdown 版）：<https://open.larkoffice.com/document/server-docs/docs/drive-v1/introduction>
+.md
 
 使用 `@larksuiteoapi/node-sdk` 在 NestJS 中管理飞书云空间文件和文件夹。
 

package/steering/nestjs-react-fullstack/skills/feishu/references/events.md

@@ -1,6 +1,7 @@
 # 事件订阅 (Events)
 
-> 开放平台文档（Markdown 版）：https://open.larkoffice.com/document/server-docs/event-subscription-guide/overview
+> 开放平台文档（Markdown 版）：<https://open.larkoffice.com/document/server-docs/event-subscription-guide/overview>
+.md
 
 通过 WebSocket 长连接接收飞书事件推送，无需公网 IP / 域名，无需加解密。
 

package/steering/nestjs-react-fullstack/skills/feishu/references/id-convert.md

@@ -1,8 +1,8 @@
 # 妙搭与飞书开放平台 — ID 识别与转换
 
-> 开放平台文档（Markdown 版）：https://open.larkoffice.com/document/uAjLw4CM/ukTMukTMukTM/spark-v1/overview.md
+> 开放平台文档（Markdown 版）：<https://open.larkoffice.com/document/uAjLw4CM/ukTMukTMukTM/spark-v1/overview.md>
 >
-> 飞书用户身份体系官方说明：https://open.larkoffice.com/document/platform-overveiw/basic-concepts/user-identity-introduction/introduction
+> 飞书用户身份体系官方说明：<https://open.larkoffice.com/document/platform-overveiw/basic-concepts/user-identity-introduction/introduction>
 >
 > **承接 `user-identity` skill 决策树**：如果只需 妙搭 userId → 飞书 user_id（employee_id），在 nestjs-react-fullstack 项目内优先用 `AuthNPaasService`。本文覆盖 `AuthNPaasService` 不支持的场景：需要 `open_id` / `union_id`、或需要任何方向的反查、或不在该模板内的项目。
 

package/steering/nestjs-react-fullstack/skills/feishu/references/messaging.md

@@ -1,6 +1,6 @@
 # 消息 (Messaging)
 
-> 开放平台文档（Markdown 版）：https://open.larkoffice.com/document/server-docs/im-v1/introduction.md
+> 开放平台文档（Markdown 版）：<https://open.larkoffice.com/document/server-docs/im-v1/introduction.md>
 
 使用 `@larksuiteoapi/node-sdk` 在 NestJS 中发送和回复飞书消息。
 

package/steering/nestjs-react-fullstack/skills/feishu/references/oauth.md

@@ -1,6 +1,7 @@
 # OAuth 用户授权
 
-> 开放平台文档（Markdown 版）：https://open.larkoffice.com/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM
+> 开放平台文档（Markdown 版）：<https://open.larkoffice.com/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM>
+.md
 
 默认的 tenant_access_token 以应用身份调用 API。
 部分场景（个人日历、搜索联系人）需要 user_access_token 代表用户操作。

package/steering/nestjs-react-fullstack/skills/feishu/references/perm.md

@@ -1,6 +1,7 @@
 # 权限管理 (Permission)
 
-> 开放平台文档（Markdown 版）：https://open.larkoffice.com/document/server-docs/docs/permission/overview
+> 开放平台文档（Markdown 版）：<https://open.larkoffice.com/document/server-docs/docs/permission/overview>
+.md
 
 使用 `@larksuiteoapi/node-sdk` 在 NestJS 中管理飞书云文档的协作者权限。
 

package/steering/nestjs-react-fullstack/skills/feishu/references/wiki.md

@@ -1,6 +1,7 @@
 # 知识库 (Wiki)
 
-> 开放平台文档（Markdown 版）：https://open.larkoffice.com/document/server-docs/docs/wiki-v2/wiki-overview
+> 开放平台文档（Markdown 版）：<https://open.larkoffice.com/document/server-docs/docs/wiki-v2/wiki-overview>
+.md
 
 使用 `@larksuiteoapi/node-sdk` 在 NestJS 中操作飞书知识库。
 
@@ -151,7 +152,7 @@ Wiki API 不提供搜索功能。获取内容需通过以下方式：
 
 1. 打开知识空间 → 设置 → 成员管理
 2. 添加机器人应用
-3. 参考：https://open.feishu.cn/document/server-docs/docs/wiki-v2/wiki-qa
+3. 参考：<https://open.feishu.cn/document/server-docs/docs/wiki-v2/wiki-qa>
 
 ## Common Mistakes
 

package/steering/nestjs-react-fullstack/skills/openapi-guide/SKILL.md

@@ -72,6 +72,7 @@ modules/orders/
 ```
 
 在 `orders.module.ts` 中注册：
+
 ```typescript
 @Module({
   controllers: [OrdersController, OpenApiOrdersController],