메뉴
BasicKnowledge 写作技能：在 BasicKnowledge/ 下撰写新文章或新模块时，确保风格、结构、质量与现有内容一致。Use when: 新建知识模块、撰写技术文章、扩展现有模块内容。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | basic-knowledge-writing |
| description | BasicKnowledge 写作技能：在 BasicKnowledge/ 下撰写新文章或新模块时，确保风格、结构、质量与现有内容一致。Use when: 新建知识模块、撰写技术文章、扩展现有模块内容。 |
指导在 BasicKnowledge/ 下创建新模块或撰写新文章，使其在结构、命名、语言风格、排版规范上与现有内容保持一致。
BasicKnowledge/
├── 模块名/ ← 下划线连接的英文短名（如 deep_learning）
│ ├── introduction.md ← 必须存在，模块总览与索引入口
│ ├── 主题文件.md ← 单一概念一个文件
│ └── 子模块目录/ ← 可选，内容足够独立时拆分
│ └── introduction.md ← 子模块同样需要入口
introduction.md 作为入口。BasicKnowledge/ 根目录直接放内容文件，必须放在子模块中。| 类型 | 格式 | 示例 |
|---|---|---|
| 单一概念 | 概念名.md | transformer.md、gate.md、cnn.md |
| 对比/关联 | 概念A_and_概念B.md | sql_and_rag.md、meta_and_auto.md |
| 入口文件 | introduction.md | 固定名称，不可变 |
math_foundations.md），不用驼峰或连字符。01_fundamentals.md）。每个 introduction.md 遵循 5 层递进结构：
用一句话回答"这个模块讲什么"。可引用上层模块或外部背景建立语境。
用表格列出模块内所有文件与内容简介，附相对路径链接：
| 文件 | 内容简介 |
|------|---------|
| [transformer.md](./transformer.md) | Transformer 架构深度解析 |
递进式讲述学科发展，标注关键年份与里程碑，每阶段配短评。技术类模块此层必须；哲学类模块可替换为"思想演进"。
指明推荐阅读顺序、前置知识、应用场景。
根据内容类型选择对应风格：
| 类型 | 特征 | 适用模块 |
|---|---|---|
| 概念类 | LaTeX 数学推导主导、引理-证明风格、少代码 | deep_learning/、llm/transformer.md |
| 工程类 | 表格密集、编号实践建议、伪代码或代码框架 | llm/engineering.md、agent_workflow/ |
| 哲学类 | 对话式叙述、类比与隐喻、明确价值判断 | meta_code/、data_tech/introduction.md |
同一模块内可混合多种风格，但单个文件应以一种风格为主。
注意力机制（Self-Attention）。# 一级标题 ← 文件主标题，仅 1 个
## 二级标题 ← 核心章节，通常 3-6 个
### 三级标题 ← 小节展开
#### 四级标题 ← 偶尔使用，保持可读性
## 一、xxx、## 二、xxx）或直接用标题。| 场景 | 格式 |
|---|---|
| 行内公式 | $x = \mathbf{w}^T \mathbf{x} + b$ |
| 独立公式 | $$...$$ 单独成行 |
| 向量 | \mathbf{x}（粗体小写） |
| 矩阵 | \mathbf{W}（粗体大写） |
| 标量 | 普通字体 |
| 推导过程 | 用 \implies 或 aligned 环境 |
```python。```text 或不标注语言。[gate.md](./gate.md)。[transformer.md](../llm/transformer.md)。见下文第 X 小节，不使用 HTML 锚点。BasicKnowledge/ 下。introduction.md：按 5 层模板撰写，先完成第 1-3 层，后续迭代补充 4-5 层。.md 文件。introduction.md 表格中链接所有子文件。docs/architecture/repository-structure.md 中登记新模块及其文件。.md 文件，遵循命名规范。introduction.md，在概念速写表中添加新条目。docs/architecture/repository-structure.md。BasicKnowledge/ 根目录放内容文件。introduction.md。introduction.md 必须包含文件索引表（第 3 层）。docs/architecture/repository-structure.md。.md 文件使用 UTF-8 编码。通用 Python 开发门禁技能。统一执行 Ruff 与 Pyright，并支持多目录目标与自动发现。
为 GitHub 仓库配置 SSH 推送能力的复用技能。Use when: 终端无法通过 HTTPS push、需要把仓库 remote 切到 SSH、需要生成或复用 SSH key 并挂到 GitHub 账号。
用 TypeScript 和 Codex SDK 构建单线程 worker-reviewer 状态机。维护 plan.md 与 memory.md，让 worker 连续工作、让 reviewer 无状态审核并最多回退 20 轮。
Meta SKILL 集合：用于创建和维护各类 SKILL 本身。Use when: 新建技能、创建 CI 门禁技能、技能结构验收、技能重构。
并行子 Agent 写作技能：将多文件写作任务分解为独立模块，用 runSubagent（全权限）在 .agent_cache 任务区域内并行创作；通过 brief.md、outline.md、deliverables.json 约束共享上下文与接口，再由主 Agent 收敛提升。Use when: 需要同时生成多个 md 文件、重构并拆分现有文档、批量创建模块骨架。
管理和读取工作区目录文档。使用该技能可了解文件/目录用途、读取 agent 专用备注，或在创建/修改文件后更新文档。