内容
# 工具列表
**im-not-ai v2.0 + 공정엔지니어(PE) 스타일 확장판**
[](LICENSE)
> 原作： [epoko77-ai/im-not-ai](https://github.com/epoko77-ai/im-not-ai) (MIT)
> 扩展： [dreamworker0/urimal-for-socialworker](https://github.com/dreamworker0/urimal-for-socialworker) (MIT)
---
## 这是什么？
技术报告·分析文档 **没有AI味道，以 공정엔지니어 风格** 修订的工具。
| 转换前 | 转换后 |
|---------|---------|
| "⭐ 结论是，在本节中可以确认。" | "[核心] 在本节中确认。" |
| H1~H5 各小节说明文 (6个，1200字) | 假设比较表 1个 + 2-诊断原则 2行 |
| "~发生"， "~是必要的" | "~发生ます"， "~是必要的です" |
| 说明性散文中心 | 命令型项目符号 (`▶`) + 表格中心 |
---
## 原版 im-not-ai v2.0 新增内容
### 공정엔지니어(PE) 规则 5条
| 规则 | 内容 | 效果 |
|------|------|------|
| PE-1 背景知识压缩 | 工程师已经知道的说明 → 删除或 1行总结 | 篇幅 20~30%↓ |
| PE-2 说明文 → 命令型 | "~做是因為" → `▶` 项目符号 | 可读性↑ |
| PE-3 假设小节 → 总结表 | H1~H5 个别叙述 → 假设比较表 1个 | 篇幅 40%↓ |
| PE-4 述语命令化 | "确认します" → "确认する" | 工程师文体 |
| PE-5 篇幅目标 | 原版对比 40~50% 压缩 | 核心集中 |
### 维持项目 (在PE规则中绝对禁止删除)
- 数值·规格·基准值 (PCE 18.2%， n=12 等)
- 表格全体
- Decision Gate 规则
- 风险对策
- 测量项目列表
---
## MCP 工具
可以连接到Claude Code并通过 `mcp__cng-ui__doc_humanize` 调用。
### 安装 (以cng-ui MCP为准)
```bash
# 1. 将 humanize.py 复制到 cng-ui MCP 目录
cp mcp/humanize.py /root/projects/cng-ui-mcp/
# 2. 在 server.py 中导入并注册工具 (参考 mcp/server_patch.py)
# 或者参考 README 的 "server.py 补丁" 部分
```
### server.py 补丁
```python
# 在 server.py 开头导入中添加
import humanize as HZ
# 在底部添加 @mcp.tool() 模块
@mcp.tool()
def doc_humanize(content: str, mode: str = "v20pe", file_path: str = "") -> str:
"""将文档修订为 im-not-ai v2.0 + 공정엔지니어(PE) 风格。
file_path: 如果提供文件路径，则读取文件内容而不是 content。
mode: 'v20pe'(默认) | 'v20'(修订) | 'pe'(PE压缩)
返回值(JSON):
applied — 应用的机器规则列表
content — 应用机器规则后的文本
guidance — Claude 应该额外应用的判断规则
"""
if file_path:
from pathlib import Path
p = Path(file_path)
if not p.exists():
import json
return json.dumps({"error": f"文件不存在: {file_path}"}, ensure_ascii=False)
content = p.read_text(encoding="utf-8")
if not content.strip():
import json
return json.dumps({"error": "需要 content 或 file_path"}, ensure_ascii=False)
import json
result = HZ.humanize(content, mode=mode)
result["modes"] = HZ.MODES
return json.dumps(result, ensure_ascii=False, indent=2)
```
### 使用方法
```python
# 在 Claude Code 中
mcp__cng-ui__doc_humanize(
file_path="/var/www/reports/my_report.html",
mode="v20pe" # v20 | pe | v20pe
)
```
返回值中的 `content` 包含应用了机器规则的文本，`guidance` 包含Claude应该额外应用的判断规则。
---
## Claude Code 技能安装
```bash
# 将技能复制到 Claude Code 技能目录
cp -r .claude/skills/humanize-pe ~/.claude/skills/
```
之后在对话中通过 `/humanize-pe` 或相关提示激活。
---
## 示例
虚拟场景：钙钛矿薄膜旋转涂覆均匀度改进（PSC-A 小型模块）
- **原始AI草案**：表情符号，转移语，翻译语，名词结尾，H1~H3详细描述
- **v2.0 修订后**：S1·S2模式去除，敬语转换，代名词修正
- **PE 改装后**：篇幅压缩至 ~55%，假设比较表整合，命令型项目符号转换
| 示例 | 链接 |
|------|------|
| 转换前 (AI 草案) | [before.html](https://yazzang-homelab.github.io/im-not-ai-pe/examples/before.html) |
| 转换后 (v2.0 + PE) | [after\_pe.html](https://yazzang-homelab.github.io/im-not-ai-pe/examples/after_pe.html) |
| 原始·v2.0·v2.0+PE 3段比较 | [diff\_v20\_vs\_original.html](https://yazzang-homelab.github.io/im-not-ai-pe/examples/diff_v20_vs_original.html) |
---
## 规则总结 (v2.0 + PE 整合)
完整规则请参考 [`rules/pe-rules.md`](rules/pe-rules.md)。
### 机器自动应用 (humanize.py)
| 规则 | 内容 | 严重程度 |
|------|------|--------|
| C-5 | 表情符号去除及文本转换 | S1 |
| D-1 | 结算轴心删除 (结论是·因此·总结为) | S1 |
| C-11 | 连接词后面逗号去除 | S1 |
| 翻译语 | 本节→本节， 本案例→本案例等 | S1 |
| 强调符号 | ⭐→[核心]， ★→[1优先级] | S1 |
### Claude 判断应用 (传递给 guidance)
| 规则 | 内容 | 严重程度 |
|------|------|--------|
| 述语完成 | 名词结尾 → 敬语 (~20项) | S1 |
| A-15 | 推测→断言 ("~将会" → "~是") | S2 |
| A-16 | 代名词直接修正 (그→具体名词) | S1 |
| PE-1~5 | 说明文压缩·命令型·假设表整合 | PE |
---
## 等级标准 (v2.0)
| 等级 | 条件 |
|------|------|
| **A** | S1=0项， S2≤2项， 变更率 10~25% |
| B | S1≤2项， S2≤5项， 变更率 10~30% |
| C | S1≤5项 或 变更率 30~50% |
| D | S1 6项+， 变更率 50%+ |
---
## 许可证
MIT License — 原作者 표시 의무：
- epoko77-ai (im-not-ai)
- dreamworker0 (urimal-for-socialworker)
详细内容请参考 [LICENSE](LICENSE)。
