ThinkCMF6 开发手册 Skill

一个面向 ThinkCMF6 的中文 Skills 包，支持 Codex、Claude Code、OpenCode、Cursor、GitHub Copilot等多种AI辅助编码工具。

这个项目能做什么

• 提供 ThinkCMF6 官方手册知识源：references/handbook.md
• 面向插件、模板、API、系统函数等场景给出可执行建议
• 提供多工具可直接复用的导入模板：integration/

目录说明

• SKILL.md：技能定义与触发说明
• references/handbook.md：核心索引知识库（仅模块与路径索引）
• agents/openai.yaml：OpenAI/Codex 元数据
• integration/：各工具导入模板
• scripts/：可选再生成脚本（非必需）

scripts文件（无须手动执行）

• scripts/crawl_thinkcmf_docs.py：
  • 用于从 ThinkCMF6 官方文档重新爬取最新 markdown。
  • 按官网目录结构重建 references/docs/ 多层文件夹。
  • 自动重写 references/handbook.md 为轻量索引（不灌入大段正文）。
• scripts/reorganize_output_docs.py：
  • 旧版整理脚本，面向历史 output/ 结构的目录重排与导航生成。
  • 当前主流程已迁移到 references/，该脚本仅用于兼容早期产物或回溯对比。

---

安装与导入（按工具）

1) Codex（CLI / ChatGPT Codex）

安装到本机技能目录：

$target = "$env:USERPROFILE\\.codex\\skills\\thinkcmf6-dev-manual"
New-Item -ItemType Directory -Force "$env:USERPROFILE\\.codex\\skills" | Out-Null
Copy-Item -Recurse -Force "...\thinkcmf" $target

对话中调用：

使用 $thinkcmf6-dev-manual 解决 ThinkCMF6 开发问题：...

---

2) Claude Code

导入方式（推荐项目级）：

1. 打开项目规则文件（如 CLAUDE.md，或你的团队约定规则文件）。
2. 复制 integration/claude-system-prompt.md 全文到规则文件。
3. 确保规则文件中保留：references/handbook.md。

---

3) OpenCode

导入方式（Profile/Agent）：

1. 新建或编辑 OpenCode 的 profile/agent。
2. 将 integration/opencode-system-prompt.md 作为 system prompt。
3. 若支持知识文件挂载，添加：references/handbook.md。

---

4) Cursor

导入方式（Project Rules）：

1. 创建文件：.cursor/rules/thinkcmf6.mdc
2. 复制 integration/cursor-rule.mdc 内容。
3. 在 Cursor 中直接问 ThinkCMF6 场景问题即可触发。

---

5) GitHub Copilot（VS Code / JetBrains）

导入方式（仓库指令）：

1. 创建或更新：.github/copilot-instructions.md
2. 复制 integration/copilot-instructions.md 内容。
3. 提问时显式提及 ThinkCMF6 关键词（插件/模板/API/cmf_函数）。

---

通用验证（所有工具）

导入完成后，使用以下 3 个问题做 smoke test：

1. ThinkCMF6 插件后台菜单注解怎么写？给最小示例。
2. cmf_get_option 和 cmf_set_option 推荐使用流程？
3. API 资源控制器模板下，成功返回与错误返回建议结构？

通过标准：回答能引用手册语义，并给出可执行代码或配置示例。

常见问题

• 问题：工具没有按手册回答。
  • 处理：确认导入模板中仍引用 references/handbook.md。
• 问题：换机器后路径失效。
  • 处理：本项目全部采用相对路径，确保 references/ 目录被完整复制。

版权与来源

• 文档来源：https://www.thinkcmf.com/docs/cmf6/#/
• 官方仓库：https://github.com/thinkcmf/thinkcmf/tree/6.0
• 开源协议：MIT License