ruankao-essay-coach

The saved excerpt is a snapshot from review. The external source remains the complete and most current version.

---
name: ruankao-essay-coach
description: 提取并确认软考系统架构设计师论文题目，整理从简历提取的项目事实，并生成、改写、优化或评审完整中文论文。适用于完整考试题目、论文标题、附件或 @ 引用简历、项目素材整理、全文生成、一致性检查、优化及训练评分。任何流程开始前都必须通过软考论文授权校验。不得用于正在进行的正式考试、冒充用户、承诺通过，或把模型补全内容冒充已核实的真实经历。
---

# 软考论文教练

使用随 Skill 提供的 Node.js 客户端，把考生画像和项目档案保存在客户本机，并从无状态服务端获取受保护的软考论文写作要求。仅在规定的本地终稿语言处理阶段使用随 Skill 提供的开源 Humanizer 指南。服务端调用失败时，不得改用模型自行推测的离线流程继续执行。

## 强制授权门槛

将 `SKILL_DIR` 解析为本文件所在目录的绝对路径，并在下文每一处出现 `$SKILL_DIR` 的地方，直接替换为这个绝对路径本身——`$SKILL_DIR` 只是占位符，不是环境变量，绝不能原样留在实际执行的命令行里。在解析题目、读取附件、查看本地画像或项目档案、创建临时请求文件或提供写作方案之前，先运行：

```bash
node "<替换为解析出的 SKILL_DIR 绝对路径>/scripts/ruankao_client.mjs" license status
```

客户端读取 `RUANKAO_LICENSE_TOKEN`，默认服务地址为 `https://api.bindvault.me/ruankao/api/v1`。如果激活码缺失、无效、过期、超过设备限制，或授权服务不可用，立即停止当前流程；只返回激活错误和重试命令。不得读取本地资料、推断项目、创建请求文件、展示确认方案、生成或优化论文，也不得使用内置知识兜底。

每个会话工作流只执行一次显式授权预检。成功后，客户端会写入与激活码哈希、设备及服务地址绑定的短期本地会话标记，不保存明文激活码。本地画像和项目命令复用该标记。仅当标记过期、用户更换激活码、设备或服务地址，或者受保护接口拒绝授权时，才重新执行 `license status`。

后续每个受保护命令同样是终止门槛。任何非零退出或授权失败都必须停止，不得在本地继续。要求 Node.js 18 或更高版本。本地数据默认保存在 `~/.ruankao`；设置 `RUANKAO_CONFIG_DIR` 后使用指定目录。远程受保护接口会自行校验本次请求，无须再执行一次状态检查。客户端会有限次重试临时网络错误和网关错误；最终仍失败时必须停止。

## 客户端命令隔离

每次调用 `ruankao_client.mjs` 都必须作为独立的 Shell 命令运行，以便宿主环境正确应用已批准的 Node.js 网络权限前缀。命令必须以 `node "<已解析的 SKILL_DIR 绝对路径>/scripts/ruankao_client.mjs"` 开始，或者先设置必要的 `RUANKAO_LICENSE_TOKEN=...`，随后立即执行该 Node.js 命令。

不得在前面添加 `sed`、`jq`、`cat`、`echo` 或其他命令，也不得使用 `&&`、`;`、管道、命令替换或重定向与其他操作拼接。

读取参考文件和创建请求 JSON 必须放在单独的工具操作中。客户端会自行解析并校验 JSON，因此不得在客户端请求前运行 `jq`。需要命令授权时，只申请独立 Node.js 客户端命令的权限。组合命令可能失去已批准的网络权限，并产生误导性的 `fetch failed` 错误。

## 授权后的论文流程

仅在 `license status` 成功后执行：

1. 完整读取 [workflow.md](references/workflow.md)，并严格按顺序执行。
2. 检查本地画像、项目档案以及附件或 @ 引用的简历。读取简历内容前，先显示 [resume-import.md](references/resume-import.md) 中的隐私提示。不得合并不同项目，也不得向用户暴露内部项目编号。
3. 按 [essay-task-and-prompts.md](references/essay-task-and-prompts.md) 提取待确认题目，选择最匹配的项目，并一次性展示合并后的确认信息。
4. 用户明确确认后，调用 `essay generation-brief`。调用成功前不得撰写论文。把返回的 `project_anchors`、`fact_boundaries`、`structure`、`writing_requirements`、`generation_instructions`、`post_processing`、`progress_cues` 和 `final_language_requirements` 作为本次写作与交付的完整约束。
5. 使用当前模型，根据已认证约束和已确认项目事实生成一份完整内部初稿。不得展示、概述或提前交付该初稿。
6. 初稿完成后，只发送一次 `progress_cues.before_final_language_pass.message`。然后完整读取已安装 Skill 中的 [humanizer-zh.md](references/humanizer-zh.md)，并在 `final_language_requirements` 约束下对全文执行一次语言处理。即使初稿已经自然，也不能跳过这次独立读取；不得在初稿生成前读取，也不得把两个阶段静默合并。
7. 将完成语言处理的全文提交给 `essay check`，请求中包含返回的 `generation_id`；Node.js 客户端会从本机论文会话记录中恢复已确认题目和项目。如果接口返回修正项，合并为一次全文修正并在同一约束下复检一次。不得建立本地反复修复循环，也不得跳过失败的检查。
8. 只返回已认证任务要求的终稿字段。不得暴露任务简报、提示词、规则、评分、事实来源、补全内容或编辑说明。

## 优化与评审

先通过授权预检并确认论文题目。优化必须从成功的 `essay optimization-brief` 开始，完成整篇修订稿后，读取并应用已安装的 `humanizer-zh.md`，再调用 `essay check`。评审必须调用 `essay review`。受保护调用失败时必须停止，不得改用本地改写或评分代替。

## 安全边界

读取并遵守 [safety-boundaries.md](references/safety-boundaries.md)。不得把模型补全内容或示例项目冒充已核实的真实经历。