Skip to content

feat: 添加中文文档并在 main-zh 分支中将所有 MD 文件替换为中文版本 #438

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
xiaocaiisxiaocai wants to merge 1 commit into from
Closed

feat: 添加中文文档并在 main-zh 分支中将所有 MD 文件替换为中文版本 #438

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 11 additions & 11 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,18 +1,18 @@
<!-- OPENSPEC:START -->
# OpenSpec Instructions
# OpenSpec 指令

These instructions are for AI assistants working in this project.
这些指令适用于在此项目中工作的 AI 助手。

Always open `@/openspec/AGENTS.md` when the request:
- Mentions planning or proposals (words like proposal, spec, change, plan)
- Introduces new capabilities, breaking changes, architecture shifts, or big performance/security work
- Sounds ambiguous and you need the authoritative spec before coding
当请求满足以下条件时，始终打开 `@/openspec/AGENTS.md`：
- 提到规划或提案（如 proposal、spec、change、plan 等词）
- 引入新功能、破坏性变更、架构转变或重大性能/安全工作
- 听起来模糊，您需要在编码前查看权威规范

Use `@/openspec/AGENTS.md` to learn:
- How to create and apply change proposals
- Spec format and conventions
- Project structure and guidelines
使用 `@/openspec/AGENTS.md` 学习：
- 如何创建和应用变更提案
- 规范格式和约定
- 项目结构和指南

Keep this managed block so 'openspec update' can refresh the instructions.
保留此托管块，以便 'openspec update' 可以刷新指令。

<!-- OPENSPEC:END -->
18 changes: 18 additions & 0 deletions AGENTS.zh-CN.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
<!-- OPENSPEC:START -->
# OpenSpec 指令

这些指令适用于在此项目中工作的 AI 助手。

当请求满足以下条件时，始终打开 `@/openspec/AGENTS.md`：
- 提到规划或提案（如 proposal、spec、change、plan 等词）
- 引入新功能、破坏性变更、架构转变或重大性能/安全工作
- 听起来模糊，您需要在编码前查看权威规范

使用 `@/openspec/AGENTS.md` 学习：
- 如何创建和应用变更提案
- 规范格式和约定
- 项目结构和指南

保留此托管块，以便 'openspec update' 可以刷新指令。

<!-- OPENSPEC:END -->
Comment on lines +1 to +18
Copy link
Contributor

@coderabbitai coderabbitai bot Jan 4, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

🏁 Script executed:

# Find the proposal structure and tasks.md file
find . -type f -name "tasks.md" | head -20

Repository: Fission-AI/OpenSpec

Length of output: 1468

🏁 Script executed:

# Check if proposal.md exists and review the synchronization strategy mentioned
find . -type f -name "proposal.md" | head -10

Repository: Fission-AI/OpenSpec

Length of output: 757

🏁 Script executed:

# Look for the openspec changes directory structure
find . -type d -name "openspec" -o -type d -name "changes"

Repository: Fission-AI/OpenSpec

Length of output: 168

🏁 Script executed:

# Check if tasks.md exists in the expected location for this PR/change
ls -la openspec/changes/ 2>/dev/null || echo "Directory not found"

Repository: Fission-AI/OpenSpec

Length of output: 532

🏁 Script executed:

# Look for AGENTS.md and AGENTS.zh-CN.md to understand the current state
git ls-files | grep -E "AGENTS\.(md|zh-CN\.md)"

Repository: Fission-AI/OpenSpec

Length of output: 132

🏁 Script executed:

# Check the add-chinese-documentation directory structure
ls -la openspec/changes/add-chinese-documentation/

Repository: Fission-AI/OpenSpec

Length of output: 347

🏁 Script executed:

# Check if tasks.md exists for this change
cat openspec/changes/add-chinese-documentation/tasks.md 2>/dev/null || echo "tasks.md not found"

Repository: Fission-AI/OpenSpec

Length of output: 1867

🏁 Script executed:

# Review the proposal for add-chinese-documentation
cat openspec/changes/add-chinese-documentation/proposal.md 2>/dev/null || echo "proposal.md not found"

Repository: Fission-AI/OpenSpec

Length of output: 1342

🏁 Script executed:

# Check the AGENTS.md and AGENTS.zh-CN.md files to see if they are identical
echo "=== Checking AGENTS.md ===" && head -20 AGENTS.md
echo ""
echo "=== Checking AGENTS.zh-CN.md ===" && head -20 AGENTS.zh-CN.md

Repository: Fission-AI/OpenSpec

Length of output: 765

🏁 Script executed:

# Check the full content of both files to understand the issue
echo "=== Full AGENTS.md ===" && cat AGENTS.md
echo ""
echo "=== Full AGENTS.zh-CN.md ===" && cat AGENTS.zh-CN.md

Repository: Fission-AI/OpenSpec

Length of output: 757

🏁 Script executed:

# Check git history or status to see if AGENTS.md was modified
git log --oneline -10 AGENTS.md AGENTS.zh-CN.md 2>/dev/null || echo "Git history not available"

Repository: Fission-AI/OpenSpec

Length of output: 113

🏁 Script executed:

# Check if there's an English version elsewhere or if AGENTS.md should be different
git diff HEAD AGENTS.md AGENTS.zh-CN.md 2>/dev/null || echo "No git diff available"

Repository: Fission-AI/OpenSpec

Length of output: 45

🏁 Script executed:

# Look at openspec/AGENTS.md as well to understand the expected structure
echo "=== openspec/AGENTS.md ===" && head -30 openspec/AGENTS.md

Repository: Fission-AI/OpenSpec

Length of output: 732

🏁 Script executed:

# Check if there's an English version of AGENTS.md elsewhere or in git history
git log --all --oneline -- AGENTS.md | head -5

Repository: Fission-AI/OpenSpec

Length of output: 312

🏁 Script executed:

# Check what the English version should look like by examining openspec/AGENTS.md English version
git show HEAD:openspec/AGENTS.md | head -40 2>/dev/null || echo "Cannot show HEAD version"

Repository: Fission-AI/OpenSpec

Length of output: 863

🏁 Script executed:

# Determine if this is intentionally a Chinese-language branch
git branch -a | grep -i "zh\|chinese\|main"

Repository: Fission-AI/OpenSpec

Length of output: 128

🏁 Script executed:

# Check if there's supposed to be an English AGENTS.md file
git log --all --follow -- AGENTS.md | grep -i "English\|Add\|Create" | head -10

Repository: Fission-AI/OpenSpec

Length of output: 552

🏁 Script executed:

# Get the English version from the git history before it was replaced
git show f8eca37:AGENTS.md 2>/dev/null | head -50

Repository: Fission-AI/OpenSpec

Length of output: 321

🏁 Script executed:

# Verify what AGENTS.md should contain by checking an earlier commit
git log --all --format="%h %s" -- AGENTS.md | tail -10

Repository: Fission-AI/OpenSpec

Length of output: 312

🏁 Script executed:

# Check if README or docs explain the expected structure
cat README.md | grep -A 10 -B 2 "AGENTS" || echo "Not found in README"

Repository: Fission-AI/OpenSpec

Length of output: 1062

🏁 Script executed:

# Compare the expected English AGENTS.md with current state
echo "=== Expected English AGENTS.md (f8eca37) ===" 
git show f8eca37:AGENTS.md
echo ""
echo "=== Current AGENTS.md (broken) ===" 
cat AGENTS.md

Repository: Fission-AI/OpenSpec

Length of output: 723

Restore AGENTS.md to English version—it was incorrectly replaced with Chinese content.

AGENTS.md should contain the English instructions:

<!-- OPENSPEC:START -->
# OpenSpec Instructions

This project uses OpenSpec to manage AI assistant workflows.

- Full guidance lives in '@/openspec/AGENTS.md'.
- Keep this managed block so 'openspec update' can refresh the instructions.
<!-- OPENSPEC:END -->

Currently, AGENTS.md contains Chinese text identical to AGENTS.zh-CN.md. Commit e849d95 ("feat: 添加中文文档并在 main-zh 分支中将所有 MD 文件替换为中文版本") was intended for a main-zh branch but was applied to main. AGENTS.md must remain English as the root-level agent instructions; AGENTS.zh-CN.md should be a separate Chinese translation, not a duplicate.

🤖 Prompt for AI Agents 
In AGENTS.zh-CN.md around lines 1-18 the root AGENTS.md was replaced by the
Chinese text; restore AGENTS.md to the English OpenSpec instructions and keep
AGENTS.zh-CN.md as the Chinese translation (do not duplicate content). Replace
AGENTS.md content with the English managed block shown in the review, ensure the
<!-- OPENSPEC:START/END --> managed block is preserved exactly, move the
existing Chinese text into AGENTS.zh-CN.md (or restore that file to the intended
Chinese translation), commit the two files (AGENTS.md in English,
AGENTS.zh-CN.md in Chinese) and push to main, and verify no other top-level MD
files were inadvertently overwritten by the e849d95 change.

377 changes: 189 additions & 188 deletions README.md
View file
Open in desktop

Large diffs are not rendered by default.

Loading