# it-althusser/csdn-writer-skills architecture

> Architecture diagram of the GitHub repository it-althusser/csdn-writer-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/it-althusser/csdn-writer-skills
- Repository: https://github.com/it-althusser/csdn-writer-skills

## Overview

这是一个供 Codex 使用的 CSDN 技术博客写作 skill，而非运行时应用。主要流程是用户提供笔记、项目材料、草稿或评分反馈，skill 判定文章类型并约束材料边界，再按证据补充、文章架构、正文撰写和交付检查推进。知识点文、课程笔记文、项目功能文及低分重写各有不同规则；项目功能文才展开 Controller 到 SQL 的闭环。README 说明了工作流，但未提供实现源码，因此图中只表示文档明确描述的调用和资料关系。

Main entry points: [`skills/csdn-tech-blog-writer/references/core-writing-protocol.md`](https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/core-writing-protocol.md) (正文撰写), [`skills/csdn-tech-blog-writer/SKILL.md`](https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/SKILL.md) (文章类型判定), [`skills/csdn-tech-blog-writer/references/few-shot-examples.md`](https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/few-shot-examples.md) (写作示例), [`skills/csdn-tech-blog-writer/references/style-rules.md`](https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/style-rules.md) (风格规则)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_intake["输入与分流"]
  node_skill["触发与规则<br/>[SKILL.md]"]
  node_protocol["写作协议"]
  node_classification["文章类型判定<br/>[SKILL.md]"]
  node_boundary["材料边界"]
  node_course["课程笔记规则"]
end

subgraph group_writing["证据与写作"]
  node_evidence["代码与文档补证"]
  node_outline["文章架构"]
  node_project["项目功能闭环"]
  node_draft["正文撰写"]
  node_examples["写作示例"]
  node_style["风格规则<br/>[style-rules.md]"]
  node_rewrite["低分重写"]
end

subgraph group_delivery["校验与交付"]
  node_review["脱敏与自检"]
  node_article["可发布文章"]
end

node_user(("用户"))
node_codex["Codex"]
node_ctx7["ctx7 文档查询"]

node_user -->|"提交材料与请求"| node_codex
node_codex -->|"触发 skill"| node_skill
node_skill -->|"读取协议"| node_protocol
node_skill -->|"判定类型"| node_classification
node_classification -->|"约束材料"| node_boundary
node_boundary -.->|"课程笔记时遵循"| node_course
node_protocol -->|"规定补证"| node_evidence
node_evidence -.->|"查询当前文档"| node_ctx7
node_protocol -->|"组织架构"| node_outline
node_classification -.->|"项目文时展开"| node_project
node_outline -->|"确认后撰写"| node_draft
node_examples -.->|"提供范例"| node_draft
node_style -->|"约束表达"| node_draft
node_classification -.->|"低分反馈时重写"| node_rewrite
node_rewrite -->|"重选主线"| node_draft
node_draft -->|"检查正文"| node_review
node_review -->|"交付文章"| node_article

click node_skill "https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/SKILL.md"
click node_protocol "https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/core-writing-protocol.md"
click node_classification "https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/SKILL.md"
click node_boundary "https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/core-writing-protocol.md"
click node_course "https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/course-note-blogging.md"
click node_evidence "https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/core-writing-protocol.md"
click node_outline "https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/core-writing-protocol.md"
click node_project "https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/core-writing-protocol.md"
click node_draft "https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/core-writing-protocol.md"
click node_examples "https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/few-shot-examples.md"
click node_style "https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/style-rules.md"
click node_rewrite "https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/core-writing-protocol.md"
click node_review "https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/core-writing-protocol.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_skill,node_protocol,node_classification,node_boundary,node_course toneBlue
class node_evidence,node_outline,node_project,node_draft,node_examples,node_style,node_rewrite toneAmber
class node_review,node_article toneMint
class node_user,node_codex,node_ctx7 toneIndigo
```

## Components

### 输入与分流

- [触发与规则](https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/SKILL.md): `skills/csdn-tech-blog-writer/SKILL.md`
- [写作协议](https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/core-writing-protocol.md): `skills/csdn-tech-blog-writer/references/core-writing-protocol.md`
- [文章类型判定](https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/SKILL.md): `skills/csdn-tech-blog-writer/SKILL.md`
- [材料边界](https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/core-writing-protocol.md): `skills/csdn-tech-blog-writer/references/core-writing-protocol.md`
- [课程笔记规则](https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/course-note-blogging.md): `skills/csdn-tech-blog-writer/references/course-note-blogging.md`

### 证据与写作

- [代码与文档补证](https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/core-writing-protocol.md): `skills/csdn-tech-blog-writer/references/core-writing-protocol.md`
- [文章架构](https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/core-writing-protocol.md): `skills/csdn-tech-blog-writer/references/core-writing-protocol.md`
- [项目功能闭环](https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/core-writing-protocol.md): `skills/csdn-tech-blog-writer/references/core-writing-protocol.md`
- [正文撰写](https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/core-writing-protocol.md): `skills/csdn-tech-blog-writer/references/core-writing-protocol.md`
- [写作示例](https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/few-shot-examples.md): `skills/csdn-tech-blog-writer/references/few-shot-examples.md`
- [风格规则](https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/style-rules.md): `skills/csdn-tech-blog-writer/references/style-rules.md`
- [低分重写](https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/core-writing-protocol.md): `skills/csdn-tech-blog-writer/references/core-writing-protocol.md`

### 校验与交付

- [脱敏与自检](https://github.com/it-althusser/csdn-writer-skills/blob/main/skills/csdn-tech-blog-writer/references/core-writing-protocol.md): `skills/csdn-tech-blog-writer/references/core-writing-protocol.md`
- **可发布文章**

### Other components

- **用户**
- **Codex**
- **ctx7 文档查询**

## Connections

- 用户 → Codex: 提交材料与请求
- Codex → 触发与规则: 触发 skill
- 触发与规则 → 写作协议: 读取协议
- 触发与规则 → 文章类型判定: 判定类型
- 文章类型判定 → 材料边界: 约束材料
- 材料边界 → 课程笔记规则: 课程笔记时遵循
- 写作协议 → 代码与文档补证: 规定补证
- 代码与文档补证 → ctx7 文档查询: 查询当前文档
- 写作协议 → 文章架构: 组织架构
- 文章类型判定 → 项目功能闭环: 项目文时展开
- 文章架构 → 正文撰写: 确认后撰写
- 写作示例 → 正文撰写: 提供范例
- 风格规则 → 正文撰写: 约束表达
- 文章类型判定 → 低分重写: 低分反馈时重写
- 低分重写 → 正文撰写: 重选主线
- 正文撰写 → 脱敏与自检: 检查正文
- 脱敏与自检 → 可发布文章: 交付文章
