zrwangems/dsh-zrwang-plugin / ars/skills/academic-paper
academic-paper
Flagged学术论文写作:按 IMRaD 或领域结构成稿,含大纲、论证地图、双语摘要、图表与题注、引用格式转换、返修与逐条回复、AI 使用声明。Triggers: write a paper, academic paper, paper outline, revise paper, reviewer comments, rebuttal, citation check, abstract | 写论文, 论文大纲, 修改论文, 审稿意见, 返修, 审稿回复, 引文核对, 写摘要。
references/academic_writing_style.md
View on GitHub> 输出语言(本 DSH 集成强制):所有面向用户的文字、稿件、摘要、评审与报告一律使用**简体中文**;英文术语与引文保持英文。文中的 `zh-TW` / `zh-tw-en` 只是上游语言代码与脚本参数,不代表要用繁体输出。用户明确要求其他语言时以用户为准。
>
> 多角色执行(评审团、十阶段流水线、角色扮演)必须使用 DSH 的 Agent Team 工具(`spawn_teammate`、`team_task_*`、`wait_agent`、`send_message`);当前会话看不到这些工具,说明用户没开 Agent Team,必须先提示用户开启,不得退化成单会话顺序扮演。
# Academic Writing Style Guide
Used by `draft_writer_agent` and `peer_reviewer_agent`.
## Core Principles
### 1. Precision
- Use the most specific term available
- Define technical terms on first use
- Avoid ambiguous pronouns ("this," "it") without clear antecedents
### 2. Conciseness
- Eliminate filler words and redundant phrases
- One idea per sentence (or clearly connected ideas)
- Prefer short sentences for complex ideas
### 3. Objectivity
- Base claims on evidence, not opinion
- Use hedging for uncertain claims
- Acknowledge limitations and alternative interpretations
### 4. Formality
- Use full forms ("do not" over "don't")
- Use formal academic vocabulary; reserve colloquialisms and slang for informal writing
- Use third person unless discipline conventions allow first person
## Register Adjustment by Discipline
### Sciences (Natural, Applied)
```
Register: Formal, impersonal, method-focused
Voice: Passive voice common ("was measured," "were analyzed")
Terminology: Precise measurements, SI units, statistical notation
Example: "The sample was heated to 350°C for 2 hours, yielding a conversion rate of 87.3% (SD = 2.1)."
```
### Social Sciences
```
Register: Formal, theory-informed, participant-aware
Voice: Active voice encouraged, first person for researcher decisions
Terminology: Theoretical constructs, operationalized variables
Example: "We employed semi-structured interviews to explore how participants understood institutional change (N = 24)."
```
### Humanities
```
Register: Formal, argument-driven, interpretive
Voice: First person acceptable for arguments, active voice
Terminology: Close reading vocabulary, theoretical language
Example: "I argue that the text's spatial metaphors reveal an underlying anxiety about institutional permanence."
```
### Engineering / CS
```
Register: Formal, problem-solution oriented, specification-precise
Voice: Passive common for methods, active for contributions
Terminology: Technical specifications, performance metrics
Example: "The proposed algorithm achieves O(n log n) complexity, outperforming the baseline by 34% on the benchmark dataset."
```
### Education
```
Register: Formal, practice-oriented, stakeholder-aware
Voice: Active voice, first person for reflexive practice
Terminology: Pedagogical concepts, assessment language
Example: "The intervention improved student metacognitive awareness, as evidenced by a significant increase in self-regulation scores (t(45) = 3.21, p = .002, d = 0.72)."
```
### Medicine / Health
```
Register: Formal, evidence-hierarchy conscious, clinical precision
Voice: Passive for methods, active for findings
Terminology: Clinical terms, diagnostic criteria, statistical reporting
Example: "Patients receiving the intervention showed a 40% reduction in readmission rates (RR = 0.60, 95% CI [0.45, 0.80], p = .001)."
```
## Hedging and Strength Language
### Hedging (for uncertain or qualified claims)
| Strength | Hedging Devices | Example |
|----------|----------------|---------|
| Weak | may, might, could, possibly | "This may suggest a correlation." |
| Moderate | suggests, indicates, appears | "The data suggest a positive trend." |
| Strong | demonstrates, establishes, confirms | "The evidence demonstrates a clear link." |
### When to Hedge
- Results that need replication
- Causal claims from correlational data
- Generalizations from limited samples
- Interpretations with alternative explanations
### When NOT to Hedge
- Reporting factual data: "The response rate was 78%." (not "appeared to be")
- Describing methodology: "We used thematic analysis." (not "we attempted to use")
- Well-established facts: "Earth orbits the Sun." (not "may orbit")
## Transition Words and Phrases
### Addition
moreover, furthermore, in addition, additionally, similarly, likewise
### Contrast
however, nevertheless, in contrast, on the other hand, conversely, whereas
### Cause/Effect
therefore, consequently, as a result, thus, hence, accordingly
### Example
for example, for instance, specifically, in particular, such as, namely
### Sequence
first, second, third, subsequently, finally, meanwhile
### Summary
in summary, to conclude, overall, taken together, in short
### Concession
although, despite, while, granted that, notwithstanding
## Paragraph Construction
### A Common Academic Paragraph Shape (TEEL, optional)
1. **T**opic sentence — states the paragraph's main point
2. **E**vidence — data, citations, examples that support the point
3. **E**xplanation — interpret the evidence, connect to argument
4. **L**ink — connect to the next paragraph or back to thesis
### Example
> **[T]** AI-assisted quality assurance has shown promise in improving evaluation consistency across institutions. **[E]** Smith (2024) found that institutions using AI tools reported a 23% reduction in inter-rater variance, while Chen and Wang (2023) documented improved agreement on scoring rubrics (κ = 0.82 vs. 0.64). **[E]** These findings suggest that algorithmic assistance can mitigate the subjective biases inherent in human evaluation, particularly when assessors have varying levels of experience. **[L]** However, the reliance on AI tools also raises concerns about the loss of contextual judgment, which the following section addresses.
## Common Style Errors
### Wordiness
| Wordy | Concise |
|-------|---------|
| in order to | to |
| due to the fact that | because |
| a large number of | many |
| at the present time | currently / now |
| it is important to note that | notably |
| in the event that | if |
| has the ability to | can |
| with regard to | regarding / about |
| in spite of the fact that | despite / although |
| conduct an investigation of | investigate |
### Vague Language
| Vague | Precise |
|-------|---------|
| "many studies" | "several studies (e.g., Chen, 2023; Smith, 2024)" |
| "a significant impact" | "a 23% increase in retention rates" |
| "in recent years" | "since 2020" or "over the past five years" |
| "some researchers" | Name them with citations |
| "it is well known that" | Cite the source or remove |
### Tense Usage
| Section | Tense | Example |
|---------|-------|---------|
| Literature review (reporting findings) | Past | "Smith (2024) found that..." |
| Literature review (ongoing state) | Present | "The theory posits that..." |
| Methodology | Past | "Data were collected through..." |
| Results | Past | "The analysis revealed..." |
| Discussion (interpreting) | Present | "These findings suggest..." |
| Conclusion (implications) | Present/Future | "This has implications for... / Future research should..." |
## Chinese Academic Writing (zh-TW) Conventions
### Register
- Use written/formal language; avoid colloquial expressions
- Prefer active voice (Chinese rarely uses passive)
- Mainly short sentences; avoid overly long subordinate clauses
- Use "this study" (ben yan jiu) rather than "we" (wo men)
### Common Academic Expressions
| English | Romanized Chinese |
|------|------|
| This study aims to | Ben Yan Jiu Zhi Zai |
| The findings indicate | Yan Jiu Jie Guo Xian Shi |
| It is worth noting | Zhi De Zhu Yi De Shi |
| In conclusion | Zong Shang Suo Shu |
| Based on the above analysis | Gen Ju Shang Shu Fen Xi |
| Further research is needed | Wei Lai Yan Jiu Ke Jin Yi Bu Tan Tao |
### Avoiding Translationese
- Incorrect: "was found to be" (bei fa xian shi) → Correct: "Results show" (jie guo xian shi)
- Incorrect: "This is because" (zhe shi yin wei) → Correct: "The reason lies in" (yuan yin zai yu)
- Incorrect: "In the aspect of..." (zai...fang mian) → Correct: State directly
- Incorrect: "It is worth being pointed out that" (zhi de bei zhi chu de shi) → Correct: "It is worth noting that" (zhi de zhu yi de shi)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |