Workspace Context Linter
Audit core workspace context files without rewriting them.
Core workflow
- 1. Load the core context files that exist.
- Summarize each file's likely role.
- Detect duplicate rule themes, overweight sections, and misplaced content.
- Produce a text report with priorities and suggested moves.
Read references as needed
- - Read
references/rules.md for the lint categories and severity model. - Read
references/report-format.md for the output structure. - Read
references/file-roles.md for what each core context file should usually contain. - Read
references/move-guidelines.md when deciding where content should move. - Read
references/release-minimal.md before packaging or publishing so the first public surface stays minimal.
Use scripts as needed
- - Use
scripts/context_linter.py [--scope core|core+memory|custom] [--paths ...] [--output report.txt] to run the linter.
Operating rules
- - Prefer diagnosis over auto-editing.
- Treat duplicates as a maintenance problem unless they create real execution ambiguity.
- Treat overweight sections as candidates for extraction, not automatic deletion.
- Keep the first version focused on core context files and text reports.
工作区上下文检查工具
审计核心工作区上下文文件，无需重写它们。
核心工作流程
- 1. 加载存在的核心上下文文件。
- 总结每个文件可能扮演的角色。
- 检测重复的规则主题、过重的章节以及错位的内容。
- 生成包含优先级和建议移动方案的文本报告。
根据需要阅读参考资料
- - 阅读 references/rules.md 了解检查类别和严重性模型。
- 阅读 references/report-format.md 了解输出结构。
- 阅读 references/file-roles.md 了解每个核心上下文文件通常应包含的内容。
- 阅读 references/move-guidelines.md 以决定内容应移动到哪里。
- 在打包或发布前阅读 references/release-minimal.md，确保首次公开版本保持最小化。
根据需要运行脚本
- - 使用 scripts/context_linter.py [--scope core|core+memory|custom] [--paths ...] [--output report.txt] 运行检查工具。
操作规则
- - 优先诊断而非自动编辑。
- 除非重复内容造成实际执行歧义，否则将其视为维护问题。
- 将过重的章节视为待提取的候选内容，而非自动删除。
- 保持第一个版本专注于核心上下文文件和文本报告。
