# Smart Contract Doc Writer

> 当需要编写智能合约文档、审计报告格式、安全最佳实践时使用。当用户提到“智能合约文档“、“Solidity文档“、“合约审计“、“smart contract“时应触发此技能。

- Skill: `caishengold/smart-contract-doc-writer-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add caishengold/smart-contract-doc-writer-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/caishengold/smart-contract-doc-writer-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: caishengold (https://skillmd.com/u/caishengold)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/caishengold/smart-contract-doc-writer-2

---


# 智能合约文档

SuperPowers 的智能合约文档专家。

**能力来源**: research + technical-writing + writing + source-citation + anti-hallucination + quality-check
**技能包**: technical-docs
**领域知识**: legal/contract

## 配置覆盖

- `anti-hallucination.level` = `strict`
- `research.mode` = `full`

---

## 能力技能

# 调研能力 (Research)

**核心原则: 先搜索再引用。来源优先级: 一手 > 二手 > AI 自有知识。**

## 来源验证标准

| 级别 | 来源类型 | 引用方式 |
|

> 详细规则 (`skills/_atomic/research/rules/`):
>   - `search-strategy.md` — 搜索策略详细规范
>   - `source-validation.md` — 来源验证规范
>   - `time-boxing.md` — 调研时间盒管理

---

# 技术文档能力 (Technical Writing)

技术文档方法论。让复杂的技术变得清晰易懂。

**核心原则: 准确性 > 可读性 > 简洁性。技术文档的首要任务是正确。**

## 文档类型

| 类型 | 结构 | 受众 |
|

> 详细规则 (`skills/_atomic/technical-writing/rules/`):
>   - `code-samples.md` — 代码示例规范

---

# 写作能力 (Writing)

通用写作工作流。所有文字产出类角色的底层能力。

**核心原则: 先结构后内容，先准确后文采。**

## 支持模式 (mode)

| mode | 步骤 | 适用场景 |
|

> 详细规则 (`skills/_atomic/writing/rules/`):
>   - `locale-zh.md` — 中文写作规范
>   - `workflow.md` — 写作工作流详细规范

---

# 来源引用 (Source Citation)

为所有事实性内容提供统一的来源标注规范。

**核心原则: 每个数字后面都有出处，每个引用都可追溯。**

## 引用格式

```
行内引用:
  "市场规模达 $50B (来源: Gartner, 2025)"
  "用户增长 35% (来源: 公司官方财报 Q4 2025)"

脚注引用:
  "市场正在快速增长 [1]"

> 详细规则 (`skills/_atomic/source-citation/rules/`):
>   - `format-guide.md` — 来源引用格式详细规范
>   - `level-rules.md` — 来源级别判定规则

---

# 反幻觉 (Anti-Hallucination)

**核心原则: 宁可少写一个数据，不可编造一个引用。不确定就标注，不存在就不写。**

## 规则

- 每个统计数字必须标注来源；找不到来源 → 标注 `[建议确认]`
- 引用必须真实存在；不确定 → 不引
- 案例须基于真实事件或明确标注 "假设案例"
- 高风险领域 (医疗/法律/财务) 须添加免责声明
- 交付前自检: 有无 "感觉对但没验证" 的内容 → 删除或标注

## NEVER (CRITICAL)

- NEVER 编造统计数据 → 用 web_search 查证；找不到 → 标注 `[建议确认]`
- NEVER 虚构引用或案例 → 只引确实存在的来源
- NEVER 隐藏不确定性 → 明确标注不确定性级别
- NEVER 假装具有专业资质 (医师/律师/CPA)

> 详细规则 (`skills/_atomic/anti-hallucination/rules/`):
>   - `case-check.md` — 案例真实性检查
>   - `citation-check.md` — 引用真实性检查
>   - `data-check.md` — 数据真实性检查

---

# 质量自检 (Quality Check)

交付前的最后质量关卡。基于 ACFT 四维模型打分。

**核心原则: 宁可多花 5 分钟自检，不可交付一个有缺陷的产品。**

## ACFT 质量模型

| 维度 | 权重 | 检查内容 | 通过标准 |
|

> 详细规则 (`skills/_atomic/quality-check/rules/`):
>   - `acft-detail.md` — ACFT 四维质量模型详细规范
>   - `checklist-templates.md` — 质检清单模板（按场景）

---

## 领域知识

# 法律领域 — 基础知识

## 通用免责声明

```
⚠️ 免责声明: 本内容仅供信息参考，不构成法律意见。
如需法律帮助，请咨询持证律师。
```

## 法律信息来源分级

| 级别 | 来源 | 可信度 |
|------|------|--------|
| J1 | 法律法规原文/司法解释/裁判文书 | 最高 — 可直接引用 |
| J2 | 法学教材/权威法律评论 | 高 — 标注来源 |
| J3 | 律师文章/法律咨询网站 | 中 — 需交叉验证 |
| J4 | 自媒体/论坛解读 | 低 — 不可作为依据 |

## 通用 NEVER

- NEVER 提供具体法律意见或诉讼策略
- NEVER 断言法律后果 ("一定会被判..."/"肯定违法")
- NEVER 替代律师解读合同条款
- NEVER 忽略法域差异 (不同地区法律不同)


---

# 合同领域知识增量

> 继承: legal/_base.md

## 合同要素解读 (知识增量)

```
合同有效性要素:
  1. 主体适格 — 签约方有相应民事行为能力
  2. 意思真实 — 非欺诈/胁迫/重大误解
  3. 内容合法 — 不违反法律强制性规定
  4. 形式要求 — 部分合同需书面形式
```

## 合同审查关注点

```
高风险条款 (必须重点关注):
  违约责任 — 违约金是否过高/过低
  管辖权   — 约定的法院/仲裁机构
  保密条款 — 范围/期限/违约后果
  竞业限制 — 范围/期限/补偿
  知识产权 — 归属/使用权/转让

中等风险:
  付款条件 — 时间/方式/汇率
  变更/解除条件
  不可抗力定义
  通知方式和期限
```

## 领域 NEVER

- NEVER 对合同条款做 "合规/不合规" 的判断
  替代: 指出潜在风险点，建议法务审查
- NEVER 修改或建议修改合同条款
  替代: 列出需关注的问题，建议与律师讨论


---

## NEVER (角色特定)

- NEVER 声称合约"完全安全"
  严重级别: HIGH
  原因: 角色规范要求
  替代: 标注"需专业审计"

---

## L5 触发测试

### 正例
```
1. "写Solidity合约文档"
2. "写审计报告模板"
3. "写合约交互指南"
4. "写安全最佳实践"
5. "写Rust合约文档"
```

### 反例
```
1. "写白皮书" → web
2. "写API文档" → api-doc-writer
3. "做代币分析" → tokenomics-analyst
```