docs: split bilingual readme and improve repo discoverability

Author: cuixiaoling

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,17 @@
+name: Bug report
+description: Report a reproducible bug
+title: "[Bug]: "
+labels: [bug]
+body:
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,17 @@
+name: Feature request
+description: Propose an enhancement
+title: "[Feature]: "
+labels: [enhancement]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposal
+    validations:
+      required: true

.github/pull_request_template.md

@@ -0,0 +1,7 @@
+## Summary
+
+## Validation
+
+- [ ] `ruff check .`
+- [ ] `pytest -q`
+- [ ] README/examples updated if behavior changed

CODE_OF_CONDUCT.md

@@ -0,0 +1,7 @@
+# Code of Conduct
+
+Be respectful, specific, and constructive.
+
+- Discuss behavior, not people.
+- Provide reproducible context when reporting issues.
+- Keep collaboration professional and solution-focused.

CONTRIBUTING.md

@@ -0,0 +1,18 @@
+# Contributing
+
+## Setup
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+ruff check .
+pytest -q
+```
+
+## Contribution Rules
+
+- Keep behavior aligned with `SKILL.md` and `references/` contracts.
+- Preserve MarkdownFlow syntax correctness and interaction determinism.
+- Add tests for any core generation behavior change.
+- Update docs/examples when interface behavior changes.

README.md

@@ -1,5 +1,7 @@
 # mdf-teaching-script-generator
 
+[中文文档](./README.zh-CN.md)
+
 Generate runnable lesson-level MarkdownFlow teaching scripts from structured lesson materials with controlled interaction and reusable variable flow.
 
 ## Use Cases

README.zh-CN.md

@@ -0,0 +1,68 @@
+# mdf-teaching-script-generator
+
+[English README](./README.md)
+
+将结构化课节素材生成可运行的 lesson 级 MarkdownFlow 授课提示词，保证交互可控、变量可复用、结构稳定。
+
+## 适用场景
+
+- 将已分段课程素材批量转为按课节运行的 MarkdownFlow 提示词。
+- 在保持教学结构稳定的前提下，按课节替换具体内容。
+- 在课节内进行变量采集与后续分流反馈。
+
+## 边界说明
+
+- 仅负责生成“单节授课提示词”，不负责整课打包发布。
+- 不改写上游课程事实口径，不替代课程内容审校。
+- 输入应为结构化课节对象（已完成清洗/分段）。
+
+## 3 分钟快速开始
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+mdf-teaching-script-generator --input examples/lesson_input.json --output output/lesson_output.json
+python -m json.tool output/lesson_output.json | head -n 40
+```
+
+## 最小可运行示例
+
+输入文件：[`examples/lesson_input.json`](./examples/lesson_input.json)
+
+输出包含：
+- `lesson_id`
+- `lesson_title`
+- `mdf_script`
+- `used_variables`
+- `depends_on_lessons`
+
+## 架构：Skill Core + Adapters
+
+- Skill Core：[`src/mdf_teaching_script_generator/core.py`](./src/mdf_teaching_script_generator/core.py)
+  - 平台无关的课节脚本生成逻辑。
+- CLI Adapter：[`src/mdf_teaching_script_generator/cli.py`](./src/mdf_teaching_script_generator/cli.py)
+  - 可在本地与流水线直接运行。
+- OpenClaw Adapter：[`adapters/openclaw`](./adapters/openclaw)
+- Claude Adapter：[`adapters/claude`](./adapters/claude)
+- Codex Adapter：[`adapters/codex`](./adapters/codex)
+
+## 多 Agent 兼容
+
+- OpenClaw 调用示例：[`examples/openclaw_call.md`](./examples/openclaw_call.md)
+- Claude 调用示例：[`examples/claude_call.md`](./examples/claude_call.md)
+- Codex 调用示例：[`examples/codex_call.md`](./examples/codex_call.md)
+
+## 与 AI-Shifu 的关系
+
+该仓库是 AI-Shifu 课程生产链路中的可复用技能组件之一。
+
+- 官网：https://ai-shifu.com
+
+## 开发
+
+```bash
+pip install -e ".[dev]"
+ruff check .
+pytest -q
+```