resolve-fixme
Find all FIXME comments across the codebase and fully implement the work they describe. Use when the user asks to fix, resolve, or address FIXME comments, or when running the "fixme" command. Runs a discovery script to find every FIXME, expands multiline comment blocks, groups related FIXMEs across files into a single implementation task, completes the full underlying code changes, removes the FIXME comments only after the work is done, and verifies that no FIXMEs remain.
- License 许可
- Apache-2.0
- 所属仓库
- rizrmd/furcode
- 最近更新
- 2026-10-31
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- resolve-fixme
- description
- Find all FIXME comments across the codebase and fully implement the work they describe. Use when the user asks to fix, resolve, or address FIXME comments, or when running the "fixme" command. Runs a discovery script to find every FIXME, expands multiline comment blocks, groups related FIXMEs across files into a single implementation task, completes the full underlying code changes, removes the FIXME comments only after the work is done, and verifies that no FIXMEs remain.
02 资源文件 1
- 脚本scripts/find-fixme.sh3.4 KB
03 SKILL.md 正文
Resolve FIXME Comments
Workflow
1. Run the discovery script
Execute the script from the repository root to collect all FIXMEs with context:
bash .forge/skills/resolve-fixme/scripts/find-fixme.sh [PATH]
PATHis optional; omit it to search the entire working directory.- The script prints each FIXME with 2 lines of context before and 5 lines after, along with the exact file path and line number.
- Skips
.git/,target/,node_modules/, andvendor/. - Requires either
rg(ripgrep) orgrep+python3.
2. Expand each FIXME into its full instruction
Do not rely on the discovery output alone.
For every hit:
- Open the file and read around the reported line.
- Expand the FIXME to include the entire comment block.
- Treat all consecutive related comment lines as part of the same instruction.
Important:
- A FIXME may be multiline. The line containing
FIXMEis often only the beginning. - The real instruction may continue on following comment lines and may contain the actual implementation details.
- Do not interpret or edit a FIXME until you have read the full block.
For each expanded FIXME, capture:
- file path
- start line and end line of the full comment block
- a short summary of what that FIXME is asking for
3. Consolidate related FIXMEs across files
Before editing code, review all expanded FIXMEs together.
Many FIXMEs describe different facets of the same underlying task across multiple files. For example:
- one file may describe a domain type that needs to be introduced
- another may describe a parameter that should disappear once that type exists
- another may describe a service, repo, or UI update needed to complete the same refactor
Group such FIXMEs into a single implementation task.
When grouping, look for:
- shared vocabulary
- references to the same type, service, repo, parameter, or feature
- comments that clearly describe prerequisite and follow-up changes in different files
- comments that only make sense when read together
For each group, produce one consolidated understanding of the task:
- all files and line ranges involved
- the complete implementation required across the group
- the order in which the changes should be made
Do not resolve grouped FIXMEs one file at a time in isolation. Resolve the whole task consistently.
4. Implement every FIXME completely
Every FIXME must be resolved. There is no skip path.
Work through each grouped task until the underlying implementation is complete:
- Read any additional files needed to understand the design.
- Create or modify the required code, types, services, repos, tests, configs, or templates.
- Propagate the change through every affected file in the group.
- Remove each FIXME comment only after the work it describes has actually been implemented.
Critical rule: Never delete or rewrite a FIXME comment unless the underlying implementation is finished. The comment is a record of required work. Removing it before completing that work is a failure.
If the FIXME implies a larger refactor, do the refactor. If it requires creating new supporting code, create it. Do not stop at the first local change if the comment clearly implies additional follow-through elsewhere.
5. Verify
After resolving all FIXMEs:
- Run the project's standard verification step:
cargo insta test --accept
- Re-run the discovery script:
bash .forge/skills/resolve-fixme/scripts/find-fixme.sh [PATH]
- Confirm that no FIXME comments remain in the targeted scope.
Notes
- Prefer targeted fixes, but do not under-scope the work when multiple FIXMEs describe one larger task.
- Read broadly before editing when the intent is ambiguous.
- Consistency matters more than locality: grouped FIXMEs should lead to one coherent implementation.
- The job is not to clean up comments. The job is to complete the implementation those comments are pointing at.
04 同仓库更多 Skills
github-pr-description
Generate and create pull request descriptions automatically using GitHub CLI. Use when the user asks to create a PR, generate a PR description, make a pull request, or submit changes for review. Analyzes git diff and commit history to create comprehensive, meaningful PR descriptions that explain what changed, why it matters, and how to test it.
execute-plan
Execute structured task plans with status tracking. Use when the user provides a plan file path in the format `plans/{current-date}-{task-name}-{version}.md` or explicitly asks you to execute a plan file.
create-skill
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends your capabilities with specialized knowledge, workflows, or tool integrations.
test-skill
A test skill with resources
minimal-skill
A minimal skill with no resources
write-release-notes
Generate engaging, high-energy release notes for a given version tag. Fetches the release from GitHub, retrieves every linked PR's title and description, then synthesizes all changes into a polished, user-facing release note with an enthusiastic tone. Use when the user asks to write, generate, or create release notes for a version (e.g. "write release notes for v1.32.0", "generate release notes for the latest release", "create changelog for v2.0").