Skip to content

docs(manual): rewrite the AI writing guide in skill style - #230

Open
m1ngsama wants to merge 1 commit into
mainfrom
docs/ai-assisted-writing-skill-style
Open

m1ngsama wants to merge 1 commit into
mainfrom
docs/ai-assisted-writing-skill-style

Conversation

@m1ngsama

Copy link
Copy Markdown
Member

改了什么

tutorial/manual/ai-assisted-writing.md 改成 skill 风格的写法,同一页同时给文档撰写者和 agent 读。原有的事实、提示词和归档红线都保留。

  • 开头一段说明两位读者各读什么,并给出核心规则。
  • 新增“什么时候该用”:给 agent 的 name + description 触发描述。
  • 新增“不可通融的规则”:事实归作者;归档只整理,不补全。
  • 新增“流程”:agent 的编号步骤。
  • 原来的“可以 / 不要交给它”两节合并为一张表。
  • 核实一节改题为“你负责核实什么”,内容不变。
  • 约束里补上“非常”“极大”这类没有数字的形容,与站点词汇规则一致。

检查

  • pnpm run ci:lint:markdown、pnpm run ci:lint:eslint 通过
  • pnpm test -- --run:174 passed
  • pnpm docs:build 通过
  • pnpm run ci:verify 在 Windows 上报告 43 条 “anchor targets a missing page”。原因是 checks/verify-dist.mjs 用 globSync('**/*.html') 得到反斜杠路径,而链接解析用正斜杠,跨页锚点全部对不上。这条问题在许多未改动的页面上同样出现,不是本页引入的。已确认本页用到的 #新建一页、#验证要看构建产物、#本站的编者按标记 在构建产物中都存在。Linux CI 上不受影响。

🤖 Generated with Claude Code

Restructure 用 AI 帮忙写文档 so the same page serves the writer and the
agent. Add a trigger description, two standing rules, a numbered process,
and merge the do/don't lists into one table. The prompt and the checklists
stay as they were.

Co-Authored-By: Claude Code <noreply@anthropic.com>
@m1ngsama
m1ngsama requested a review from sheepkinn as a code owner November 12, 2026 14:02
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying documents with  Cloudflare Pages  Cloudflare Pages

Latest commit: 3e3405d
Status: ✅  Deploy successful!
Preview URL: https://131f6c35.documents-dq4.pages.dev
Branch Preview URL: https://docs-ai-assisted-writing-ski.documents-dq4.pages.dev

View logs

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant