kawagiri/TenkajinKB
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
TenkajinKB/AGENTS.md
daixiawu 0acd30f10a 新增内容
2026-07-02 22:14:21 +08:00

8.4 KiB
Raw Permalink Blame History

# AGENTS.md

This file provides guidance to Codex (Codex.ai/code) when working with this repository.

Repository Overview

This is a Creative Project External Brain Library (创意企划外脑库) — a personal knowledge management system for creative projects, research, and inspiration collection.

Repository Structure

00_System/ — 系统基础设施

Project-wide infrastructure, tooling, and configuration.

  • Codex/ — project-local Codex assets migrated from Claude Code: skills, memory, migration manifest.
  • schemas/ — 数据结构定义（如 acg-game.yaml）
  • Tags/ — 标签体系定义（关联类型、创作研究、知识状态）
  • Config/ — 全局配置

01_Active_Projects/ — 推进中的企划

Current active creative projects in progress. Each project has its own subdirectory with documentation.

Current Projects:

  • TH1_EmpireFantasy/ — 《帝国幻想乡~TOHOTOPIA》游戏设计文档 (4X strategy game combining Touhou × historical civilizations)

02_Knowledge_Base/ — 知识库

Organized knowledge assets, research, and reference materials.

  • GameDesign/ — 游戏设计理论与方法论
  • History/ — 历史研究资料
  • WorldBuilding/ — 世界观构建技巧
  • References/ — 参考资料、竞品分析

03_Inbox/ — 收集箱

Raw inputs waiting to be processed and organized.

  • Unsorted/ — 未分类的素材、笔记、灵感
  • ToProcess/ — 待处理的阅读清单、待看内容

Root-level utilities — 根目录工具脚本

  • Dashboard/ — 旧版仪表盘；当前实际位置仍在根目录，不要假设存在 00_System/Dashboard/。
  • start-server.py / start-dashboard.bat — 本地开发服务器启动脚本
  • parse_data.py, count_families.py, generate_map.py — 数据处理工具

NOTE TO AI ASSISTANTS: This structure overview is a guide, not an exhaustive listing. Always use file system tools (rg --files, ls, grep) to find files. Do not assume a file does not exist just because it is not listed here.

Working Principles

  1. Projects contain actionable work-in-progress.
  2. Knowledge Base contains distilled, categorized knowledge.
  3. Inbox is a temporary holding area; items should be reviewed and moved to KB or Projects.
  4. Keep Claude legacy files as references only. CLAUDE.md is retained for historical compatibility; this AGENTS.md is the Codex entrypoint.
  5. Do not migrate or load Claude runtime history (sessions, history, todos, tasks, telemetry, cache) for normal project work.

Project-Local Codex Assets

Project-local Codex assets live under 00_System/Codex/:

  • skills/ — migrated Claude skills, converted to Codex-compatible SKILL.md frontmatter.
  • memory/PROJECT_MEMORY.md — distilled project rules and user preferences for daily use.
  • memory_raw/ — original Claude project memory files for traceability.
  • migration_manifest.md — migration source paths, date, and validation notes.

When a task touches AI image/video prompting, Touhou character design, X-series prompt projects, niji7, Nano Banana 2, or Seedance 2.0, read 00_System/Codex/memory/PROJECT_MEMORY.md first, then load the relevant raw memory or skill only if needed.

Skills Available

These skills are project-local. They are not copied into C:\Users\daixiawu\.codex\skills; use the paths below when a trigger appears.

  • graphify (00_System/Codex/skills/graphify/SKILL.md) — Transform folders/content into knowledge graphs with clustered communities, HTML, JSON, and audit report.

    • Trigger: /graphify

  • knowledge-base (00_System/Codex/skills/knowledge-base/SKILL.md) — 知识库数据结构框架，定义 KnowledgeNode、Tag、CreativeWork 等核心实体。

    • Trigger: /kb

  • acg-research (00_System/Codex/skills/acg-research/SKILL.md) — ACG知识库构建系统总说明。多Agent协作管线的完整文档，新模型先读这个。

    • Trigger: /acg-research

  • research-game (00_System/Codex/skills/research-game/SKILL.md) — 一键串联搜集→验证→提炼→整合全流程。

    • Trigger: /research-game <游戏名>

  • collect-game (00_System/Codex/skills/collect-game/SKILL.md) — 从网络搜集指定游戏的结构化原始数据。

    • Trigger: /collect-game <游戏名>

  • verify-game (00_System/Codex/skills/verify-game/SKILL.md) — 交叉验证搜集数据的准确性。

    • Trigger: /verify-game <游戏英文短名>

  • distill-game (00_System/Codex/skills/distill-game/SKILL.md) — 从验证数据中提取设计洞察与结构化分析。

    • Trigger: /distill-game <游戏英文短名>

  • integrate-game (00_System/Codex/skills/integrate-game/SKILL.md) — 将分析结果写入知识库并建立关联。

    • Trigger: /integrate-game <游戏英文短名>

  • seedance-prompt (00_System/Codex/skills/seedance-prompt/SKILL.md) — Seedance 2.0 核心提示词生成器。

    • Trigger: /seedance-prompt

  • seedance-review (00_System/Codex/skills/seedance-review/SKILL.md) — Seedance 2.0 失败诊断器。

    • Trigger: /seedance-review

  • seedance-storyboard (00_System/Codex/skills/seedance-storyboard/SKILL.md) — Seedance 2.0 分镜编排器。

    • Trigger: /seedance-storyboard

  • openrouter-seedance (00_System/Codex/skills/openrouter-seedance/SKILL.md) — 通过 OpenRouter 提交、轮询并下载 Seedance 2.0 视频生成任务，供本地 X 项目调用实际模型。

    • Trigger: /openrouter-seedance、通过 OpenRouter 调用 Seedance 2.0、X 项目实际生成视频

  • imagegen (00_System/Codex/skills/imagegen/SKILL.md) — 生成或编辑位图图像资产；包含提示词规范、透明背景后处理、OpenAI 图像 API/CLI 兜底脚本和参考文档。

    • Trigger: /imagegen、$imagegen、生成图片、编辑图片、透明背景、图像资产、img2、生图

  • comfyui-maintenance (00_System/Codex/skills/comfyui-maintenance/SKILL.md) — ComfyUI 本地安装、更新、审计、Wan/Wan2.x 模型库存、自定义节点、GPU/CPU 启动与 CUDA/PyTorch/驱动诊断。

    • Trigger: /comfyui-maintenance、ComfyUI 安装/更新/维护、Wan/Wan2.x 模型安装、ComfyUI GPU/CUDA 报错

  • pre-check-existing-resources (00_System/Codex/skills/pre-check-existing-resources/SKILL.md) — 创建或修改资源前检查是否已有现成资源，避免重复创建。

    • Trigger: 创建新项目、修改现有代码、添加功能模块前

  • prompt-standard-check (00_System/Codex/skills/prompt-standard-check/SKILL.md) — 所有 X 系列出图 prompt 标准比对；输出前先确认目标项目是否有严格 prompt 要求，按标准结构、风格、参数和模块占比核对；输出必须是完整可直接复制的整段 prompt，不给片段 prompt、替换段落或单独负面词，并在回复中写明“已经和标准prompt比对”。

    • Trigger: 任意 X 系列出图 prompt / prompt 改写 / 材质精修 / X02 / X22 / 动物皮套 / 卡丁车 / 小人国场景 / 东方角色潮玩

  • midjourney-folder-map (00_System/Codex/skills/midjourney-folder-map/SKILL.md) — Midjourney 网页生成前的 X 系列 folder URL 映射；普通 X 项目使用 https://www.midjourney.com/organize?folder=X编号，如 X27 使用 https://www.midjourney.com/organize?folder=X27；shoes 项目例外 URL 待用户补充，不要擅自猜。

    • Trigger: Midjourney 网页生成、organize folder、X 项目出图、X27、folder 映射

Project Memory Highlights

  • 出图 prompt 默认禁止画面出现文字、汉字、字母、数字、书写笔迹、抽象记号、计数划痕、符号。
  • 写东方角色 prompt 前必须查证发色、发型、瞳色、身材和标志物，不要按种族/职业/姓氏脑补。
  • niji7 不支持 --cref / --cw；不要默认加 --style raw；画幅走 --ar。
  • X 系列双人 CP prompt 遵循 X08 稳定范式；X11 是“东方角色识别符 + 统一水手服基底”的改造系列。
  • 所有 X 系列出图 prompt 必须先与项目标准比对，并输出完整可直接复制的整段 prompt，不给片段或单独负面词。
  • 用户工具链：niji7、Nano Banana 2、Seedance 2.0、剪映 / Pr。

Subagent 调度偏好

  • 跨 3+ 文件的探索/搜索 → 走 Explore subagent，主线只收摘要。
  • 单文件读取、已知路径的 grep → 主线直接做，不要起 subagent。
  • 写代码任务卡住 ≥2 轮没进展 → 起 Plan subagent 重新规划，而不是继续硬调。