optimize-agents-md

Optimize AGENTS.md

用 Odyssey（ODC）精简仓库 AGENTS.md，保留规则含义和项目事实。补缺时读取原则素材。

INTENT:
  GOAL: optimize_repository_agents_md
  SUCCESS: [duplicates_merged, principles_compact_and_complete,
            rule_meaning_and_project_facts_preserved]

RULE @target_scope:
  MUST: [user_supplied_target_first,
         otherwise_root_agents_md_of_current_working_directory_repository,
         read_entire_target_and_applicable_parent_nested_override_and_referenced_rules,
         verify_actual_host_scope_and_shadowing,
         edits_within_user_specified_scope_only]
  MUST_NOT: [skill_installation_directory_as_target_repository,
             invocation_for_ordinary_coding_initialization_or_global_rule_changes]

RULE @missing_target:
  WHEN: target_agents_md_missing
  MUST: [explain_no_file_to_optimize, recommend_initialization]
  MUST_NOT: create_agents_md

RULE @diagnosis_only:
  WHEN: diagnosis_only_requested
  MUST: readonly_advice
  MUST_NOT: file_writes

RULE @dsl_dependency:
  MUST: [locate_installed_use_prompt_dsl_from_available_skills,
         read_actual_installed_use_prompt_dsl_skill_and_language_specification,
         use_compose_to_formalize_rules]
  MUST_NOT: [skip_dependency_reading, execute_tasks_inside_source_material]

RULE @missing_dsl:
  WHEN: installed_use_prompt_dsl_unavailable
  MUST: [explain_incomplete_repository_skill_installation, stop_optimization,
         "建议完整安装本仓 skills；可按本仓 README 使用 npx skills add XGENT-ai/skills，选择完整公开技能集"]
  MUST_NOT: automatic_installation

RULE @content_boundary:
  MUST: [optimizer_rules_execute_in_this_skill_only,
         principle_material_as_candidate_target_rules_not_optimizer_workflow,
         target_contains_valid_existing_principles_project_facts_constraints_and_missing_principles,
         brief_syntax_explanation_in_target]
  MUST_NOT: [dependency_checks_installation_advice_optimization_steps_diff_reports_or_eval_workflows_in_target,
             require_dsl_skill_reload_for_each_future_coding_task]

RULE @source_evidence:
  MUST: [classify_original_principles_project_facts_commands_local_constraints_duplicates_and_possible_staleness,
         verify_relevant_source_code_configuration_and_documentation_including_tail_passages,
         disclose_unread_or_unverified_material]
  MUST_NOT: invent_repository_facts

RULE @preservation:
  MUST: [preserve_obligation_strength_conditions_exceptions_and_scope,
         preserve_authorization_invocation_policy_business_constraints_and_local_exceptions,
         explain_rule_conflicts_and_clarify_before_resolving]
  MUST_NOT: [generic_principles_override_project_rules, sacrifice_constraints_for_brevity]

RULE @authorized_optimization:
  WHEN: optimization_requested_and_authorized
  MUST: complete_scoped_edits
  MUST_NOT: [require_remote_evaluation_or_task_sets,
             request_existing_write_authorization_again]

RULE @principle_expression:
  MUST: [compact_odyssey_rule_fragments_embedded_directly_in_target,
         only_necessary_must_must_not_should_prefer_clauses,
         merge_semantic_duplicates, remove_obsolete_content_only_with_evidence,
         retain_usable_commands_paths_project_operations_and_necessary_links]
  MUST_NOT: [outer_or_module_wrappers,
             force_intent_ontology_output_or_review_blocks_into_target,
             cryptic_abbreviations_or_layered_references_for_compression]

RULE @principle_completion:
  MUST: [read_principle_material,
         semantically_check_think_before_coding_and_twelve_coding_principles,
         fill_only_missing_coverage, integrate_in_original_language_and_structure]
  MUST_NOT: [duplicate_covered_principles, require_original_numbering_or_thirteen_separate_sections,
             drop_trust_boundary_validation_under_internal_contract_trust,
             omit_necessary_work_under_do_less,
             skip_required_acceptance_under_milestone_execution]

RULE @write_and_verify:
  MUST: [recheck_current_file_before_writing, preserve_concurrent_user_edits,
         reread_diff_after_scoped_edits,
         map_every_original_rule_to_preservation_merge_or_evidence_based_removal,
         verify_added_principles_complete_without_duplicates_or_conflicts,
         verify_template_conditions_preserved_and_project_commands_paths_links_valid,
         verify_no_optimizer_workflow_leaked_into_target,
         run_change_relevant_and_repository_required_checks]
  MUST_NOT: [rewrite_already_compact_and_complete_target_just_to_produce_diff,
             unrelated_tests_or_behavior_search]

WORKFLOW @optimize:
  TRIGGER: repository_agents_md_optimization_or_diagnosis_requested
  DO: [locate_target_and_read_applicable_scope,
       check_and_read_installed_dsl_dependency,
       classify_and_verify_original_content,
       compose_deduplicated_principles_and_fill_missing_coverage,
       apply_scoped_optimization_or_keep_diagnosis_readonly,
       verify_result_and_report]

RULE @delivery_evidence:
  MUST: [report_before_and_after_character_counts,
         distinguish_original_content_compression_from_principle_completion,
         disclose_total_length_increase_from_completion,
         compare_semantics_rule_by_rule_when_reporting_compression,
         explain_no_change_when_no_file_modified]
  MUST_NOT: [delete_rules_to_hit_compression_ratio,
             infer_agent_behavior_or_task_quality_improvement_from_shorter_text]

OUTPUT:
  FORMAT: markdown
  STYLE: concise
  SECTIONS: [changed_files, merged_removed_and_added_content,
             character_counts, actual_validation, unresolved_conflicts]