Initial commit: Flutter 无书应用项目

2026-03-30 02:35:31 +08:00
commit 9175ff9905
566 changed files with 103261 additions and 0 deletions
--- a/.trae/skills/planning-with-files/docs/opencode.md
+++ b/.trae/skills/planning-with-files/docs/opencode.md
@@ -0,0 +1,113 @@
+# OpenCode IDE Support
+
+## Overview
+
+planning-with-files works with OpenCode as a personal or project skill.
+
+## Installation
+
+See [docs/installation.md](installation.md) for detailed installation instructions.
+
+### Quick Install (Global)
+
+```bash
+mkdir -p ~/.config/opencode/skills
+cd ~/.config/opencode/skills
+git clone https://github.com/OthmanAdi/planning-with-files.git
+```
+
+### Quick Install (Project)
+
+```bash
+mkdir -p .opencode/skills
+cd .opencode/skills
+git clone https://github.com/OthmanAdi/planning-with-files.git
+```
+
+## Usage with Superpowers Plugin
+
+If you have [obra/superpowers](https://github.com/obra/superpowers) OpenCode plugin:
+
+```
+Use the use_skill tool with skill_name: "planning-with-files"
+```
+
+## Usage without Superpowers
+
+Manually read the skill file when starting complex tasks:
+
+```bash
+cat ~/.config/opencode/skills/planning-with-files/planning-with-files/SKILL.md
+```
+
+## oh-my-opencode Compatibility
+
+oh-my-opencode has Claude Code compatibility for skills. To use planning-with-files with oh-my-opencode:
+
+### Step 1: Install the skill
+
+```bash
+mkdir -p ~/.config/opencode/skills/planning-with-files
+cp -r .opencode/skills/planning-with-files/* ~/.config/opencode/skills/planning-with-files/
+```
+
+### Step 2: Configure oh-my-opencode
+
+Add the skill to your `~/.config/opencode/oh-my-opencode.json` (or `.opencode/oh-my-opencode.json` for project-level):
+
+```json
+{
+  "skills": {
+    "sources": [
+      { "path": "~/.config/opencode/skills/planning-with-files", "recursive": false }
+    ],
+    "enable": ["planning-with-files"]
+  },
+  "disabled_skills": []
+}
+```
+
+### Step 3: Verify loading
+
+Ask the agent: "Do you have access to the planning-with-files skill? Can you create task_plan.md?"
+
+### Troubleshooting
+
+If the agent forgets the planning rules:
+
+1. **Check skill is loaded**: The skill should appear in oh-my-opencode's recognized skills
+2. **Explicit invocation**: Tell the agent "Use the planning-with-files skill for this task"
+3. **Check for conflicts**: If using superpowers plugin alongside oh-my-opencode, choose one method:
+   - Use oh-my-opencode's native skill loading (recommended)
+   - OR use superpowers' `use_skill` tool, but not both
+
+## Known Limitations
+
+### Session Catchup
+
+The `session-catchup.py` script currently has limited support for OpenCode due to different session storage formats:
+
+- **Claude Code**: Uses `.jsonl` files at `~/.claude/projects/`
+- **OpenCode**: Uses `.json` files at `~/.local/share/opencode/storage/session/`
+
+When you run `/clear` in OpenCode, session catchup will detect OpenCode and show a message. **Workaround**: Manually read `task_plan.md`, `progress.md`, and `findings.md` to catch up after clearing context.
+
+Full OpenCode session parsing support is planned for a future release.
+
+## Verification
+
+**Global:**
+```bash
+ls -la ~/.config/opencode/skills/planning-with-files/planning-with-files/SKILL.md
+```
+
+**Project:**
+```bash
+ls -la .opencode/skills/planning-with-files/planning-with-files/SKILL.md
+```
+
+## Learn More
+
+- [Installation Guide](installation.md)
+- [Quick Start](quickstart.md)
+- [Workflow Diagram](workflow.md)