标题: skill 调优求助
作者: #Joyousoda
板块: #开发调优
编号: 1723207
帖子: https://linux.do/t/topic/1723207
时间: 2026-03-11 11:15:52
摘要:

佬们，我又开始研究skill，并且自己写了一个开发文档流 skill，请佬们提提建议或者还有什么流程可以加入的。
佬们，我又开始研究skill，并且自己写了一个开发文档流 skill，请佬们提提建议

---
id: "codex-doc-workflow"
name: "Codex Doc & Workflow Orchestrator"
description: "支持手动与自动双模式的研发文档流，实现‘对话即开发’，并在开发完成后自动沉淀影响范围、代码定位、SQL 变更与 Mermaid 逻辑流程图。用于初始化任务、持续同步研发记录、收口交付文档、生成结项摘要。"
version: "1.6.0"
author: "Developer"
---

# Skill: Codex-Doc-Workflow

## Core Rules

- 优先复用项目中已存在的任务文档目录，按以下顺序解析：`.claude/tasks/` -> `.claude/docs/tasks/` -> `.codex/docs/tasks/` -> `docs/tasks/`。
- 若以上目录均不存在，则默认创建 `.codex/tasks/`。
- 当前回合只能维护一个“活动任务文档”；若存在多个候选文档，优先选择最近修改的 `task-*.md`。
- 所有开发过程记录都必须回写到任务文档，不额外散落到临时说明中。
- 文件定位统一使用 `FileName:LineNumber` 或 `path/to/file:line` 格式，至少记录类、方法、SQL 片段或 XML 语句的主入口位置。
- 若项目为后端项目且本轮涉及数据库结构、初始化数据、迁移脚本或核心 SQL 逻辑调整，必须在任务文档中补充“数据库变更记录”。
- 逻辑流程图统一使用 Mermaid 代码块保存到任务文档；默认优先 `flowchart TD`，若存在明显的角色交互或时序关系，则使用 `sequenceDiagram`。
- 若本轮未涉及数据库修改，必须在“数据库变更记录”中显式写明“无数据库变更”，而不是留空。
- 若本轮改动较大，影响范围总结必须同时覆盖：模块、接口、服务、持久层、缓存、权限、文档、SQL 脚本。

## Workflow

1. 使用 `$init-task` 初始化任务文档。
2. 开发过程中使用 `$sync` 持续同步进度与实现记录。
3. 开发完成后使用 `$finalize-impact` 回填影响范围、代码定位、SQL 记录与逻辑流程图。
4. 最后使用 `$wrap-up` 做结项校验、验证命令执行与 Commit 信息生成。

---

## Commands

### $init-task [options] [context]
**Description**: 初始化研发任务规格书。支持全自动分析或手动创建。

**Execution Logic**:
1. **模式判定**：检查 `options` 是否包含 `--auto`。
2. **任务目录解析**：优先查找 `.claude/tasks/`、`.claude/docs/tasks/`、`.codex/docs/tasks/`、`docs/tasks/`；若均不存在，则创建 `.codex/tasks/`。
3. **[手动模式]** (无 `--auto`)：
    - 提取 `context` 作为任务标题。
    - 在解析出的任务目录下生成 `task-{{DATE}}-[TITLE_SLUG].md`；若标题为空则退化为 `task-{{DATE}}.md`。
    - 填充内置 `TASK_SPEC_TEMPLATE` 模板。
    - 若项目中已存在 `AGENTS.md`、`.claude/tasks/REQUIREMENTS.md` 或同类约束文档，则自动吸收其中的接口规范、DTO/VO 约束、数据库同步要求写入模板。
    - 立即进入文档编辑态，允许用户补充业务背景。
4. **[全自动模式]** (带 `--auto`)：
    - **Context Analysis**：扫描当前对话历史及 `AGENTS.md`。
    - **Repo Scan**：扫描 `Controller`、`Service`、`Mapper`、`sql/`、任务文档目录，识别 DTO 遗漏点、接口风格差异、潜在 SQL 变更点。
    - **Auto-Fill**：根据分析结果填充模板中的 `[TITLE]`、`[DESC]`、`[MODULES]`、优先级分批与初始风险项。
    - **Commitment**：生成文件后，自动进入开发执行流程；若环境支持多代理，则按任务书执行并行开发。

---

### $sync [description]
**Description**: 增量更新当前任务文档的进度、实现记录与阶段性影响说明。

**Execution Logic**:
1. 定位当前活动任务文档，按“最近修改的 `task-*.md`”规则选择目标文件。
2. 读取最新代码变更、文件改动、最近新增的接口/服务/SQL，并与任务清单交叉比对。
3. **进度打勾**：将已完成的任务项更新为 `[x]`；未完成项保留 `[ ]`。
4. **沉淀记录**：在“实现记录与排错”区块末尾追加 `description`。
5. **阶段性总结**：若本轮已经出现明显的影响范围变化，可同步更新“交付影响总结”中的模块或核心变更说明。
6. 若 `description` 包含“修复”“排查”“回滚”“兼容”等关键词，优先在记录中强调问题、原因、处理方式和最终结果。

---

### $finalize-impact [description]
**Description**: 在开发完成后自动收口交付影响范围，补充文件定位、数据库变更记录与 Mermaid 逻辑流程图。

**Execution Logic**:
1. 定位当前活动任务文档。
2. 扫描本轮改动文件，优先参考：
    - Git diff / 工作区改动文件
    - 新增或修改的 `Controller`、`Service`、`Mapper`、`Mapper.xml`、`sql/*.sql`
    - 任务实现记录中出现的核心类、方法、接口、表名、缓存键
3. 回填“交付影响总结”区块：
    - 影响模块
    - 影响类型（接口 / 服务 / 持久层 / 数据库 / 缓存 / 权限 / 文档）
    - 核心变更摘要
4. 回填“文件与代码定位”区块：
    - 使用 `path:line` 记录主类、主方法、关键 SQL、关键 XML 语句位置。
    - 每条记录都附带一句说明“这个位置改了什么”。
5. 回填“数据库变更记录”区块：
    - 若检测到 `sql/` 脚本、DDL、初始化数据或核心 SQL 变更，则提取关键 SQL 语句或摘要写入文档。
    - 若只是普通查询条件微调，也应至少记录受影响的 Mapper/XML 位置与 SQL 意图。
    - 若未涉及数据库修改，写明“无数据库变更”。
6. 生成“逻辑流程图”区块：
    - 默认输出 Mermaid `flowchart TD`。
    - 图中至少包含：入口层、核心服务层、持久层/外部依赖层。
    - 若存在缓存、权限校验、审计、事务、异步、分支判断，应以辅助节点或注释分支展示。
    - 若是多角色、多时序交互场景，可改用 `sequenceDiagram`。
7. 若传入 `description`，将其写入“交付影响总结”或“实现记录与排错”末尾，作为最终收口说明。

**Output Rules**:
- 文件定位不少于 3 条；大任务不少于 5 条。
- 若涉及数据库改动，SQL 摘要优先保留关键 `CREATE / ALTER / INSERT / UPDATE / DELETE` 语句，而不是只写“已修改数据库”。
- Mermaid 图保持 5 到 10 个节点，保证可读性，避免把所有细节都塞入图中。

---

### $wrap-up
**Description**: 结项校验，完成文档收口并生成 Commit。

**Execution Logic**:
1. 校验任务文档中所有 `[ ]` 是否已完成；若未完成，明确列出剩余项和阻塞原因。
2. 若“交付影响总结”“文件与代码定位”“数据库变更记录”“逻辑流程图”仍为空，先自动执行一次 `$finalize-impact`。
3. 运行 `mvn -q install`、`mvn -q -pl ruoyi-admin -am -DskipTests compile` 或项目定义的验证脚本。
4. 将验证命令、结果、失败原因或跳过原因回写到任务文档的“验证记录”中。
5. 基于“实现记录与排错”“交付影响总结”“数据库变更记录”生成符合 Git 规范的 Commit Message。
6. 若本轮包含 SQL 变更，结项摘要中必须显式说明“涉及数据库脚本变更”。

---

## Te

标题: 购买了cursor pro，怎么才能最大化利用
作者: #10096
板块: #开发调优
编号: 1723208
帖子: https://linux.do/t/topic/1723208
时间: 2026-03-11 11:16:02
摘要:

5.4不让用了，购买了cursor pro，怎么才能最大化利用，一直没看懂计费规则，auto是可以无限使用吗

标题: 一个Team拉100个人能用几天
作者: #liheng
板块: #搞七捻三
编号: 1723209
帖子: https://linux.do/t/topic/1723209
时间: 2026-03-11 11:16:05
摘要:

每天搞一个Team，然后拉100个成员是不是可以爽用GPT 5.4了

标题: 要重构一个大单体业务服务, 要做微服务化, 目前文档缺失, 有没有好用的AI工具可以借助
作者: #ZyGui
板块: #搞七捻三
编号: 1723214
帖子: https://linux.do/t/topic/1723214
时间: 2026-03-11 11:16:55
摘要:

有没有好用的AI工具, 让他帮我把这个屎山项目进行一个汇总分析, 各业务域进行分类。我想先借用AI来进行一次可视化分析, 梳理完项目结构后, 再进行下一步

标题: 打算开通智谱的pro会员。有用过的佬友评价值不值的开，还是说继续用中转？
作者: #木匠师傅
板块: #国产替代
编号: 1723228
帖子: https://linux.do/t/topic/1723228
时间: 2026-03-11 11:18:27
摘要:

如题，看到每天智谱会员每天还要十点开抢，好奇模型真的跟官网介绍的跟 opus 4.5差不多吗？ 有深度体验的佬友，能分享一下吗？

标题: 为什么线上值机就只有这么点位置能选
作者: #kasonye
板块: #搞七捻三
编号: 1723252
帖子: https://linux.do/t/topic/1723252
时间: 2026-03-11 11:21:21
摘要:

很久没去坐飞机了，都忘了要早点预约值机。今天一看位置就只有几个，服了。。。不知道线下有没有多点座位能选。

标题: 求教 像这种gemini pro邀请链接 值几个大米？
作者: #yybbtech
板块: #搞七捻三
编号: 1723259
帖子: https://linux.do/t/topic/1723259
时间: 2026-03-11 11:22:16
摘要:

RT.

想赚几个零花钱 这东西能邀10人 每人1-4月pro试用 一次性买断的话 能卖几个大米呀？

标题: 我宣布，天才程序员暂时陨落
作者: #擒⋅始皇
板块: #搞七捻三
编号: 1723262
帖子: https://linux.do/t/topic/1723262
时间: 2026-03-11 11:22:34
摘要:

现在还有什么渠道白嫖opus4.6吗 
gpt-5.4和gpt-5.3-codex在敲代码上，又如何取舍呢

标题: 关于徽章的问题
作者: #Soniat
板块: #搞七捻三
编号: 1723266
帖子: https://linux.do/t/topic/1723266
时间: 2026-03-11 11:22:50
摘要:

就是有时点亮了徽章，但是过几天发现徽章又没了，不晓得是被取消了还是怎么的？不知道咋判定的

标题: 各位佬们公司AI报销的额度大概是多少啊
作者: #z1056544889
板块: #开发调优
编号: 1723267
帖子: https://linux.do/t/topic/1723267
时间: 2026-03-11 11:22:55
摘要:

rt，想和公司谈一下报销AI的事，不知道提多少合适，小公司可能负担不了太多

标题: 积分可以购买吗，想买wong站邀请码，但是只有222了
作者: #砚台
板块: #搞七捻三
编号: 1723270
帖子: https://linux.do/t/topic/1723270
时间: 2026-03-11 11:23:54
摘要:

或者有没有大佬卖一个，哭

标题: 黑白公益啥时候VIP改LDC了
作者: #Mu_Ke
板块: #搞七捻三
编号: 1723272
帖子: https://linux.do/t/topic/1723272
时间: 2026-03-11 11:24:20
摘要:

这下VIP都蹭不起了，公益站的模型老是失效，有人遇到过么。
我装了WokeBuddy,用的佬的api，直接403了，是不是协议没写对。openai协议

标题: codex 智能体是什么？
作者: #一只羊蝎子
板块: #搞七捻三
编号: 1723277
帖子: https://linux.do/t/topic/1723277
时间: 2026-03-11 11:24:58
摘要:

刚才看 openai 的定价页面，看到这玩意儿，从未听说过

https://chatgpt.com/zh-Hans-CN/pricing

标题: 想认真经营自己的 GitHub，也想参与别人的项目，求仙人指路
作者: #郑绰
板块: #开发调优
编号: 1723280
帖子: https://linux.do/t/topic/1723280
时间: 2026-03-11 11:25:16
摘要:

各位佬好，想来请教一下大家。
这是我的github：bigdataliuchuang (bigdataliuchuang) · GitHub
最近有个比较明确的想法，就是想把 GitHub 这块认真做起来，不只是单纯注册个号放着。
我现在比较想知道的是：
• 自己的 GitHub 一开始更适合放什么东西
• 像我这种背景适合参与什么类型的项目
• 是先自己做点仓库出来，还是先去给别人项目提 PR 更好
• 有没有适合大数据 / Python / 工具类方向参与的项目推荐
我不是想一下子搞多大，主要是想把这个事情慢慢做起来，别一直停留在“想参与”这个阶段。
如果各位愿意给点建议，感激不尽。
求仙人指路。
一方面想慢慢整理和完善自己的 GitHub，做一些能持续积累的东西；另一方面也想尝试参与一些别人的项目，真正接触协作、提 issue、提 PR、看代码、做贡献这些事情。

标题: windows 下 Claude Code cli 统计消耗情况
作者: #捕获异常但不处理
板块: #搞七捻三
编号: 1723282
帖子: https://linux.do/t/topic/1723282
时间: 2026-03-11 11:25:22
摘要:

纯水贴，之前看别人截图都有实时消耗统计，感觉很牛逼（别人有的我也要有），
首先在控制台执行命令命令
npm install -g ccusage

来下载安装 ccusage
然后找到配置文件(没有就创建 settings.json)目录类似：
C:\Users\(你的登录用户名)\.claude\settings.json
添加或更新
"statusLine": {
  "type": "command",
  "command": "npx ccusage statusline"
}

配置好后，不出意外就能正常看到类似下面的统计信息了。

如果没生效，可以尝试重开控制台。

标题: 电视极限二选一
作者: #可乐地狱猫
板块: #搞七捻三
编号: 1723291
帖子: https://linux.do/t/topic/1723291
时间: 2026-03-11 11:27:11
摘要:

前提：上一台海信用了十年昨天烧屏了，打算换一台
目前看中了海信e5q和海尔q60c（预算有限2500左右）
都是55寸和4+64，前者价格国补后2486，后者实体店看的叠国补后接近2600
核心需求：给父母买的，不打游戏，基本看网络电视剧和投屏看直播，长期使用起码要5年
bb时间：现在电视可真便宜，一台手机的价格换一台不错的电视

标题: 腾讯 QClaw (OpenClaw) 技术深度解析：架构、鉴权与PJ实录
作者: #语录均沾
板块: #搞七捻三
编号: 1723295
帖子: https://linux.do/t/topic/1723295
时间: 2026-03-11 11:28:06
摘要:

以下内容全部由 opencode 完成、生成。

1. 概述 / Overview
QClaw 是腾讯电脑管家团队开发的一款基于 Electron 的 AI 助手应用，其核心是一个名为 “openclaw” 的全功能 AI Agent 框架。从架构上看，它与 Anthropic 的 Claude Code 或开源的 OpenCode 高度相似，具备工具调用（Tool Use）、浏览器自动化、技能系统（Skills）和插件扩展能力。
目前 QClaw 版本为 1.4.0，处于内测阶段，强制要求微信扫码登录并验证邀请码（Invite Code）才能使用。本文将从技术角度深入剖析其架构设计、认证鉴权流程，并分享如何通过前端 Patch 绕过邀请码限制，以及如何配置自定义模型提供商（Model Provider）来实现 “白嫖” 使用。

免责声明：本文仅供技术交流与学习，旨在分析 Electron 应用安全与 Agent 架构设计。请勿将本文内容用于非法用途，尊重软件厂商版权。


2. 技术架构分析 / Architecture
QClaw 采用了典型的 Electron + Node.js Backend + Cloud Services 三层架构，结构清晰，职责分明。
第一层：Electron Shell (app.asar)
这一层是应用的"躯壳"，负责原生能力桥接和 UI 呈现。

主进程 (Main Process)

入口：out/main/index.js
职责：负责窗口管理、IPC 通信路由、ConfigManager（配置管理）、ProcessManager（子进程管理）以及 CrashReporter。它并不包含 AI 逻辑，只是一个宿主环境。


预加载脚本 (Preload)

文件：out/preload/index.mjs
职责：通过 contextBridge 暴露 window.electronAPI 给渲染层。提供的能力包括：窗口控制、进程生命周期管理、配置读写、RUM (Real User Monitoring) 上报、以及 Session 管理。


渲染进程 (Renderer)

目录：out/renderer/
技术栈：Vue 3 + Vite，采用 SPA（单页应用）模式。
关键路由：

/wx-login: 微信扫码登录页
/init-loading: 资源加载与初始化页
/chat: 核心对话交互页


核心组件：

WXLoginView: 负责微信登录轮询与邀请码前置检查。
ChatIndex: AI 对话主界面。
InviteCodeModal: 阻断未授权用户的弹窗组件。
WeChatRemoteModal: 微信远程控制的绑定弹窗。





第二层：OpenClaw Backend (Node.js Subprocess)
这是应用的"大脑"，一个独立的 Node.js 进程，位于 Resources/openclaw/ 目录。

Gateway Server: 默认监听 localhost:28789，提供 WebSocket 和 HTTP 接口供渲染层调用。
模型系统 (Model System): 内置了对多种模型源的支持，包括 openai-completions (通用兼容), anthropic-messages, google-generative-ai 等。
插件系统 (Plugins):

wechat-access: 实现通过企业微信远程控制 Agent 的核心插件。
content-security: 内容安全插件，负责对输入输出进行合规性过滤。


技能系统 (Skills): 预装了一系列工具集：

browser-use / playwright: 浏览器自动化能力。
imap-smtp-email: 邮件处理能力。
xiaohongshu: 小红书相关操作技能。
humanize-ai-text: 文本润色工具。


配置存储: 默认配置位于 Resources/openclaw/config/openclaw.json，用户个性化配置存储于 ~/.qclaw/openclaw.json。

第三层：Tencent Cloud Services
这是应用的"云端"，负责鉴权、模型中转和远程连接。

Auth Gateway: jprx.m.qq.com (生产环境)，负责微信登录态流转。
AI API Endpoint: mmgrcalltoken.3g.qq.com/aizone/v1。这是官方默认的模型提供商 (Provider: qclaw)，所有请求经此转发。
WeChat Remote: wss://mmgrcalltoken.3g.qq.com/agentwss，用于维持远程控制的长连接。
关键 API 接口:

data/4026: 微信登录换票 (wxLogin)
data/4055: 创建 AI 服务 API Key (createApiKey)
data/4056: 检查邀请码状态 (checkInviteCode)
data/4057: 提交激活邀请码 (submitInviteCode)
data/4064: 内容安全审查




3. 认证流程分析 / Auth Flow
QClaw 的认证链条设计非常严密，分为身份认证和服务授权两个阶段：

微信扫码 (Identity):
用户在前端扫码，获取 wx_login_code。
登录换票 (Login Exchange):
调用 data/4026 接口，用 code 换取 jwt_token (用户身份凭证) 和 channel_token。
获取密钥 (API Key Generation):
调用 data/4055 接口，为当前用户生成一个用于访问 qclaw 模型服务的 API Key。
权限门禁 (Gatekeeper):
前端调用 data/4056 (checkInviteCode) 检查该用户是否已激活。

已激活：进入 Chat 界面，API Key 在服务端生效。
未激活：前端弹出 InviteCodeModal，阻断操作。


激活鉴权 (Activation):
用户输入邀请码，调用 data/4057 (submitInviteCode)。服务端验证通过后，将该用户的 API Key 标记为"活跃"。

关键安全机制：
即使你在前端绕过了步骤 4 的检查，强制进入了 Chat 界面，但由于步骤 5 未完成，你手中的 API Key 在服务端仍然是"未激活"状态。当你尝试发送消息时，mmgrcalltoken.3g.qq.com 会直接返回 403 Forbidden：This API key has not been activated. Please enter an invitation code to activate.
这意味着：单纯的前端破解只能让你"看见"界面，无法使用官方的 AI 模型服务。

4. 破解过程 / Bypass Process
要完整解锁 QClaw，我们需要两步走：前端界面绕过 + 后端模型替换。
Step 1: 解包 app.asar
首先，我们需要提取 Electron 的核心代码包。
# 假设已安装 asar 工具 (npm install -g asar)
npx asar extract /Applications/QClaw.app/Contents/Resources/app.asar /tmp/qclaw-extracted

Step 2: 前端逻辑 Patch (界面绕过)
我们需要修改渲染进程中的两个关键文件，跳过邀请码检查逻辑。
目标 A：登录页 (out/renderer/assets/WXLoginView-BZlJJJpy.js)

定位：搜索 checkInviteCode 关键字，找到登录成功后的回调逻辑。
原逻辑：Z=async o=>{...await v.checkInviteCode({user_id:x.value})...}
修改方案：直接短路该函数，不发请求，直接执行回调。
Patch 代码：// 将原有逻辑替换为直接放行
Z = async o => {
  console.log("[WXLoginView] 邀请码检查已跳过，直接继续");
  o(); // 执行后续登录回调
}



目标 B：聊天主页 (out/renderer/assets/index-BRreSJaD.js)

定位：这是 Chat 页面初始化的入口，会再次进行二次校验。
原逻辑：i=async B=>{...const Q=yt.getUserId();...checkInviteCode...}
修改方案：强制设为已验证状态。
Patch 代码：// 强制设置已验证标志
i = async B => {
  a.value = !0; // 设置 verified = true
  // 这里的 a 变量对应源码中的 inviteCodeVerified 状态
  // 这个状态还会传递给 OnboardingGuide 组件，避免新手引导卡住
  await B();
}