@pzy560117/codex-harness 0.1.4 → 0.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (463) hide show
  1. package/README.md +1 -1
  2. package/package-source/AGENTS.md +48 -0
  3. package/package-source/PACKAGE.md +49 -0
  4. package/package-source/README.md +85 -0
  5. package/package-source/docs/codex-harness-engineering/templates/AGENTS.md +51 -0
  6. package/package-source/docs/codex-harness-engineering/templates/bootstrap-codex-harness.ps1 +780 -0
  7. package/package-source/docs/codex-harness-engineering/templates/ci/AGENTS.md +15 -0
  8. package/package-source/docs/codex-harness-engineering/templates/ci/github-action-codex-review.yml +110 -0
  9. package/package-source/docs/codex-harness-engineering/templates/ci/github-action-codex-task.yml +46 -0
  10. package/package-source/docs/codex-harness-engineering/templates/config/AGENTS.md +19 -0
  11. package/package-source/docs/codex-harness-engineering/templates/config/agents/architect.toml +18 -0
  12. package/package-source/docs/codex-harness-engineering/templates/config/agents/backend-worker.toml +15 -0
  13. package/package-source/docs/codex-harness-engineering/templates/config/agents/docs-researcher.toml +14 -0
  14. package/package-source/docs/codex-harness-engineering/templates/config/agents/docs-worker.toml +16 -0
  15. package/package-source/docs/codex-harness-engineering/templates/config/agents/explorer.toml +15 -0
  16. package/package-source/docs/codex-harness-engineering/templates/config/agents/failure-triage.toml +19 -0
  17. package/package-source/docs/codex-harness-engineering/templates/config/agents/frontend-worker.toml +15 -0
  18. package/package-source/docs/codex-harness-engineering/templates/config/agents/harness-writer.toml +16 -0
  19. package/package-source/docs/codex-harness-engineering/templates/config/agents/planner.toml +16 -0
  20. package/package-source/docs/codex-harness-engineering/templates/config/agents/readonly-research.toml +14 -0
  21. package/package-source/docs/codex-harness-engineering/templates/config/agents/reviewer.toml +14 -0
  22. package/package-source/docs/codex-harness-engineering/templates/config/agents/security-reviewer.toml +16 -0
  23. package/package-source/docs/codex-harness-engineering/templates/config/agents/stage1-reviewer.toml +16 -0
  24. package/package-source/docs/codex-harness-engineering/templates/config/agents/stage2-reviewer.toml +17 -0
  25. package/package-source/docs/codex-harness-engineering/templates/config/agents/test-planner.toml +18 -0
  26. package/package-source/docs/codex-harness-engineering/templates/config/agents/test-runner.toml +15 -0
  27. package/package-source/docs/codex-harness-engineering/templates/config/agents/visual-reviewer.toml +16 -0
  28. package/package-source/docs/codex-harness-engineering/templates/config/codex-agent-roles.md +24 -0
  29. package/package-source/docs/codex-harness-engineering/templates/config/codex-config.toml +38 -0
  30. package/package-source/docs/codex-harness-engineering/templates/config/codex-readme.md +67 -0
  31. package/package-source/docs/codex-harness-engineering/templates/config/env-check.ps1 +44 -0
  32. package/package-source/docs/codex-harness-engineering/templates/config/env.example +13 -0
  33. package/package-source/docs/codex-harness-engineering/templates/config/global-AGENTS.md +40 -0
  34. package/package-source/docs/codex-harness-engineering/templates/config/global-config.toml +19 -0
  35. package/package-source/docs/codex-harness-engineering/templates/config/mcp-config.toml +38 -0
  36. package/package-source/docs/codex-harness-engineering/templates/config/rules/agents.md +118 -0
  37. package/package-source/docs/codex-harness-engineering/templates/config/rules/coding-style.md +57 -0
  38. package/package-source/docs/codex-harness-engineering/templates/config/rules/constitution.md +290 -0
  39. package/package-source/docs/codex-harness-engineering/templates/config/rules/git.rules +41 -0
  40. package/package-source/docs/codex-harness-engineering/templates/config/rules/harness.rules +29 -0
  41. package/package-source/docs/codex-harness-engineering/templates/config/rules/patterns.md +59 -0
  42. package/package-source/docs/codex-harness-engineering/templates/config/rules/safety.rules +35 -0
  43. package/package-source/docs/codex-harness-engineering/templates/config/rules/testing.md +34 -0
  44. package/package-source/docs/codex-harness-engineering/templates/context/AGENTS.md +19 -0
  45. package/package-source/docs/codex-harness-engineering/templates/context/API_MAP.md +18 -0
  46. package/package-source/docs/codex-harness-engineering/templates/context/CHANGELOG_AI.md +11 -0
  47. package/package-source/docs/codex-harness-engineering/templates/context/CURRENT_TASK.md +114 -0
  48. package/package-source/docs/codex-harness-engineering/templates/context/DB_SCHEMA.md +14 -0
  49. package/package-source/docs/codex-harness-engineering/templates/context/DECISIONS.md +12 -0
  50. package/package-source/docs/codex-harness-engineering/templates/context/KNOWN_ISSUES.md +12 -0
  51. package/package-source/docs/codex-harness-engineering/templates/context/PROJECT_CONTEXT.md +14 -0
  52. package/package-source/docs/codex-harness-engineering/templates/context/architecture-brief.md +58 -0
  53. package/package-source/docs/codex-harness-engineering/templates/context/dev-plan.md +166 -0
  54. package/package-source/docs/codex-harness-engineering/templates/context/feature-pack.md +101 -0
  55. package/package-source/docs/codex-harness-engineering/templates/context/repo-map.md +102 -0
  56. package/package-source/docs/codex-harness-engineering/templates/context/service-dependency-matrix.yaml +25 -0
  57. package/package-source/docs/codex-harness-engineering/templates/contracts/AGENTS.md +17 -0
  58. package/package-source/docs/codex-harness-engineering/templates/contracts/README.md +24 -0
  59. package/package-source/docs/codex-harness-engineering/templates/contracts/openapi.yaml +182 -0
  60. package/package-source/docs/codex-harness-engineering/templates/contracts/orval.config.ts +20 -0
  61. package/package-source/docs/codex-harness-engineering/templates/contracts/prism-usage.md +41 -0
  62. package/package-source/docs/codex-harness-engineering/templates/design/AGENTS.md +21 -0
  63. package/package-source/docs/codex-harness-engineering/templates/design/ai-image-brief.md +122 -0
  64. package/package-source/docs/codex-harness-engineering/templates/design/assets/README.md +24 -0
  65. package/package-source/docs/codex-harness-engineering/templates/design/component-map.md +45 -0
  66. package/package-source/docs/codex-harness-engineering/templates/design/design-brief.md +183 -0
  67. package/package-source/docs/codex-harness-engineering/templates/design/design-tokens.json +88 -0
  68. package/package-source/docs/codex-harness-engineering/templates/design/frontend-architecture.md +165 -0
  69. package/package-source/docs/codex-harness-engineering/templates/design/image-to-frontend-spec.md +120 -0
  70. package/package-source/docs/codex-harness-engineering/templates/design/screen-states.md +157 -0
  71. package/package-source/docs/codex-harness-engineering/templates/design/ui-image-review.md +60 -0
  72. package/package-source/docs/codex-harness-engineering/templates/design/visual-parity-review.md +124 -0
  73. package/package-source/docs/codex-harness-engineering/templates/docs/AGENTS.md +19 -0
  74. package/package-source/docs/codex-harness-engineering/templates/docs/architecture-constraints.md +97 -0
  75. package/package-source/docs/codex-harness-engineering/templates/docs/code-semantics-and-navigation.md +54 -0
  76. package/package-source/docs/codex-harness-engineering/templates/docs/code-style-and-naming.md +116 -0
  77. package/package-source/docs/codex-harness-engineering/templates/docs/demo-readme.md +73 -0
  78. package/package-source/docs/codex-harness-engineering/templates/docs/directory-structure-template.md +88 -0
  79. package/package-source/docs/codex-harness-engineering/templates/docs/env-and-deployment-template.md +60 -0
  80. package/package-source/docs/codex-harness-engineering/templates/docs/frontend-quality-rules.md +165 -0
  81. package/package-source/docs/codex-harness-engineering/templates/docs/governance-auto-repair.md +82 -0
  82. package/package-source/docs/codex-harness-engineering/templates/docs/harness-architecture.md +78 -0
  83. package/package-source/docs/codex-harness-engineering/templates/docs/install-manifest-governance.md +307 -0
  84. package/package-source/docs/codex-harness-engineering/templates/docs/knowledge-architecture.md +241 -0
  85. package/package-source/docs/codex-harness-engineering/templates/docs/knowledge-import.md +108 -0
  86. package/package-source/docs/codex-harness-engineering/templates/docs/knowledge-lint.md +98 -0
  87. package/package-source/docs/codex-harness-engineering/templates/docs/mcp-knowledge-governance.md +24 -0
  88. package/package-source/docs/codex-harness-engineering/templates/docs/new-project-checklist.md +7 -0
  89. package/package-source/docs/codex-harness-engineering/templates/docs/new-project-usage.md +216 -0
  90. package/package-source/docs/codex-harness-engineering/templates/docs/project-agents-template.md +211 -0
  91. package/package-source/docs/codex-harness-engineering/templates/docs/prompt-knowledge-integration.md +100 -0
  92. package/package-source/docs/codex-harness-engineering/templates/docs/regression-rules.md +47 -0
  93. package/package-source/docs/codex-harness-engineering/templates/docs/requirement-prep-kit/README.md +3 -0
  94. package/package-source/docs/codex-harness-engineering/templates/docs/rule-governance.md +98 -0
  95. package/package-source/docs/codex-harness-engineering/templates/docs/service-dependency-matrix.md +70 -0
  96. package/package-source/docs/codex-harness-engineering/templates/docs/spec-to-ui-to-code-workflow.md +196 -0
  97. package/package-source/docs/codex-harness-engineering/templates/docs/task-session-strategy.md +133 -0
  98. package/package-source/docs/codex-harness-engineering/templates/docs/team-knowledge-sync.md +187 -0
  99. package/package-source/docs/codex-harness-engineering/templates/docs/trace-format.md +86 -0
  100. package/package-source/docs/codex-harness-engineering/templates/governance/AGENTS.md +18 -0
  101. package/package-source/docs/codex-harness-engineering/templates/governance/branch-protection-checklist.md +50 -0
  102. package/package-source/docs/codex-harness-engineering/templates/governance/feedback-evolution-loop.md +55 -0
  103. package/package-source/docs/codex-harness-engineering/templates/governance/retry-budget.yaml +30 -0
  104. package/package-source/docs/codex-harness-engineering/templates/governance/risk-levels.yaml +53 -0
  105. package/package-source/docs/codex-harness-engineering/templates/governance/sandbox-policy.md +13 -0
  106. package/package-source/docs/codex-harness-engineering/templates/hooks/AGENTS.md +15 -0
  107. package/package-source/docs/codex-harness-engineering/templates/hooks/hook-stop-verify.ps1 +871 -0
  108. package/package-source/docs/codex-harness-engineering/templates/hooks/hooks.json +40 -0
  109. package/package-source/docs/codex-harness-engineering/templates/knowledge/AGENTS.md +16 -0
  110. package/package-source/docs/codex-harness-engineering/templates/knowledge/catalog.md +6 -0
  111. package/package-source/docs/codex-harness-engineering/templates/knowledge/decisions/DECISION-HARNESS-001.md +39 -0
  112. package/package-source/docs/codex-harness-engineering/templates/knowledge/guidelines/GUIDELINE-RULES-001.md +30 -0
  113. package/package-source/docs/codex-harness-engineering/templates/knowledge/knowledge-catalog.md +41 -0
  114. package/package-source/docs/codex-harness-engineering/templates/package-assets/.specify/memory/constitution.md +72 -0
  115. package/package-source/docs/codex-harness-engineering/templates/package-assets/.specify/scripts/powershell/check-prerequisites.ps1 +148 -0
  116. package/package-source/docs/codex-harness-engineering/templates/package-assets/.specify/scripts/powershell/common.ps1 +137 -0
  117. package/package-source/docs/codex-harness-engineering/templates/package-assets/.specify/scripts/powershell/create-new-feature.ps1 +279 -0
  118. package/package-source/docs/codex-harness-engineering/templates/package-assets/.specify/scripts/powershell/setup-plan.ps1 +61 -0
  119. package/package-source/docs/codex-harness-engineering/templates/package-assets/.specify/scripts/powershell/update-agent-context.ps1 +448 -0
  120. package/package-source/docs/codex-harness-engineering/templates/package-assets/.specify/templates/agent-file-template.md +28 -0
  121. package/package-source/docs/codex-harness-engineering/templates/package-assets/.specify/templates/checklist-template.md +40 -0
  122. package/package-source/docs/codex-harness-engineering/templates/package-assets/.specify/templates/e2e-plan-template.md +38 -0
  123. package/package-source/docs/codex-harness-engineering/templates/package-assets/.specify/templates/plan-template.md +393 -0
  124. package/package-source/docs/codex-harness-engineering/templates/package-assets/.specify/templates/spec-template.md +307 -0
  125. package/package-source/docs/codex-harness-engineering/templates/package-assets/.specify/templates/tasks-template.md +244 -0
  126. package/package-source/docs/codex-harness-engineering/templates/package-assets/AGENTS.md +19 -0
  127. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/architecture/constraints.md +98 -0
  128. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/AGENTS.md +25 -0
  129. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/README.md +198 -0
  130. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/START-HERE.md +66 -0
  131. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/agent-ecosystem-practices.md +140 -0
  132. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/best-practices.md +267 -0
  133. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/codex-global-rules-example.md +292 -0
  134. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/AGENTS.md +14 -0
  135. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/goal-templates.md +380 -0
  136. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/AGENTS.md +14 -0
  137. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/README.md +64 -0
  138. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/contracts/openapi.yaml +25 -0
  139. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/contracts/orval.config.ts +20 -0
  140. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/design/ai-image-brief.md +44 -0
  141. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/design/component-map.md +17 -0
  142. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/design/design-brief.md +58 -0
  143. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/design/frontend-architecture.md +107 -0
  144. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/design/image-to-frontend-spec.md +72 -0
  145. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/design/screen-states.md +25 -0
  146. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/design/ui-image-review.md +38 -0
  147. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/product/difficulty-research.md +39 -0
  148. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/product/page-inventory.md +5 -0
  149. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/product/prd-lite.md +41 -0
  150. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/product/requirement-interface-matrix.md +32 -0
  151. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/product/state-matrix.yaml +14 -0
  152. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/packages/api-client/generated/model/Ticket.ts +6 -0
  153. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/packages/api-client/generated/ticket-api.ts +35 -0
  154. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/packages/api-client/http-client.ts +8 -0
  155. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/packages/ui/TicketFilterBar.tsx +72 -0
  156. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/plans/features/ticket-filter.dev-plan.md +48 -0
  157. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/progress.txt +1 -0
  158. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/stories/TicketFilterBar.stories.tsx +33 -0
  159. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/task.json +54 -0
  160. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/traces/DEMO-TICKET-FILTER-001-20260422-120000.json +74 -0
  161. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/verify.ps1 +42 -0
  162. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/global-rules-and-bootstrap.md +415 -0
  163. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/goal-harness-integration-guide.md +364 -0
  164. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/implementation-flow.md +290 -0
  165. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/implementation-guide.md +25 -0
  166. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/knowledge-surface-map.md +186 -0
  167. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/mode-matrix.md +57 -0
  168. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/new-project-usage.md +176 -0
  169. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/project-agents-template.md +168 -0
  170. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/spec-to-ui-to-code-workflow.md +196 -0
  171. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/superpowers-codex-solo-builder-playbook.md +676 -0
  172. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/AGENTS.md +22 -0
  173. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/context/AGENTS.md +14 -0
  174. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/context/API_MAP.md +18 -0
  175. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/context/CURRENT_TASK.md +89 -0
  176. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/context/dev-plan.md +166 -0
  177. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/contracts/AGENTS.md +14 -0
  178. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/contracts/README.md +24 -0
  179. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/contracts/prism-usage.md +41 -0
  180. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/AGENTS.md +14 -0
  181. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/component-map.md +45 -0
  182. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/design-brief.md +183 -0
  183. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/design-tokens.json +88 -0
  184. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/frontend-architecture.md +165 -0
  185. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/image-to-frontend-spec.md +120 -0
  186. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/screen-states.md +157 -0
  187. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/visual-parity-review.md +124 -0
  188. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/docs/AGENTS.md +14 -0
  189. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/docs/env-and-deployment-template.md +60 -0
  190. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/docs/frontend-quality-rules.md +161 -0
  191. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/docs/regression-rules.md +47 -0
  192. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/docs/trace-format.md +86 -0
  193. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/product/AGENTS.md +14 -0
  194. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/product/prd-lite.md +166 -0
  195. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/product/state-matrix.yaml +116 -0
  196. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/prompts/AGENTS.md +14 -0
  197. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/prompts/implement-one-task.md +150 -0
  198. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/prompts/repair-one-finding.md +70 -0
  199. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/spec/11-security-design.md +43 -0
  200. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/spec/AGENTS.md +14 -0
  201. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/testing/AGENTS.md +14 -0
  202. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/testing/EVIDENCE_PROTOCOL.md +54 -0
  203. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/testing/NATURAL_LANGUAGE_TEST_CASES.md +690 -0
  204. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/testing/REGRESSION_PLAN.md +28 -0
  205. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/testing/TEST_STRATEGY.md +98 -0
  206. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/testing/TRACEABILITY_MATRIX.md +23 -0
  207. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/testing/verify-matrix.md +51 -0
  208. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/AGENTS.md +165 -0
  209. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/CHANGELOG.md +149 -0
  210. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/CLAUDE.md +61 -0
  211. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/CODE_OF_CONDUCT.md +83 -0
  212. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/CONTRIBUTING.md +465 -0
  213. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/README.md +1390 -0
  214. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/SECURITY.md +53 -0
  215. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/SPONSORING.md +43 -0
  216. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/SPONSORS.md +59 -0
  217. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/TROUBLESHOOTING.md +446 -0
  218. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/architect.md +232 -0
  219. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/build-error-resolver.md +119 -0
  220. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/chief-of-staff.md +155 -0
  221. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/code-reviewer.md +238 -0
  222. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/cpp-build-resolver.md +91 -0
  223. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/cpp-reviewer.md +79 -0
  224. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/database-reviewer.md +94 -0
  225. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/doc-updater.md +110 -0
  226. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/docs-lookup.md +68 -0
  227. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/e2e-runner.md +110 -0
  228. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/go-build-resolver.md +95 -0
  229. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/go-reviewer.md +83 -0
  230. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/harness-optimizer.md +35 -0
  231. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/java-build-resolver.md +154 -0
  232. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/java-reviewer.md +105 -0
  233. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/kotlin-build-resolver.md +119 -0
  234. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/loop-operator.md +37 -0
  235. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/planner.md +215 -0
  236. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/python-reviewer.md +106 -0
  237. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/pytorch-build-resolver.md +122 -0
  238. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/refactor-cleaner.md +92 -0
  239. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/rust-build-resolver.md +149 -0
  240. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/rust-reviewer.md +95 -0
  241. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/security-reviewer.md +112 -0
  242. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/tdd-guide.md +96 -0
  243. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/agents/typescript-reviewer.md +122 -0
  244. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/aside.md +173 -0
  245. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/build-fix.md +64 -0
  246. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/checkpoint.md +78 -0
  247. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/claw.md +51 -0
  248. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/code-review.md +43 -0
  249. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/context-budget.md +29 -0
  250. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/cpp-build.md +173 -0
  251. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/cpp-review.md +140 -0
  252. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/cpp-test.md +257 -0
  253. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/docs.md +32 -0
  254. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/e2e.md +389 -0
  255. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/eval.md +122 -0
  256. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/evolve.md +194 -0
  257. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/go-build.md +183 -0
  258. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/go-review.md +156 -0
  259. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/go-test.md +274 -0
  260. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/gradle-build.md +72 -0
  261. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/harness-audit.md +72 -0
  262. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/instinct-export.md +67 -0
  263. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/instinct-import.md +117 -0
  264. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/instinct-status.md +59 -0
  265. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/kotlin-build.md +176 -0
  266. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/kotlin-review.md +144 -0
  267. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/kotlin-test.md +315 -0
  268. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/learn-eval.md +117 -0
  269. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/learn.md +70 -0
  270. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/loop-start.md +33 -0
  271. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/loop-status.md +25 -0
  272. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/model-route.md +27 -0
  273. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/multi-backend.md +162 -0
  274. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/multi-execute.md +321 -0
  275. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/multi-frontend.md +162 -0
  276. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/multi-plan.md +278 -0
  277. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/plan.md +118 -0
  278. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/pm2.md +283 -0
  279. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/projects.md +39 -0
  280. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/promote.md +41 -0
  281. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/prompt-optimize.md +37 -0
  282. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/prune.md +31 -0
  283. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/python-review.md +319 -0
  284. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/quality-gate.md +30 -0
  285. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/refactor-clean.md +83 -0
  286. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/resume-session.md +154 -0
  287. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/rules-distill.md +11 -0
  288. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/rust-build.md +189 -0
  289. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/rust-review.md +146 -0
  290. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/rust-test.md +311 -0
  291. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/setup-pm.md +83 -0
  292. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/skill-create.md +176 -0
  293. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/skill-health.md +54 -0
  294. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/tdd.md +330 -0
  295. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/test-coverage.md +69 -0
  296. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/update-codemaps.md +73 -0
  297. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/update-docs.md +86 -0
  298. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/verify.md +60 -0
  299. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/contexts/dev.md +23 -0
  300. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/contexts/research.md +30 -0
  301. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/contexts/review.md +25 -0
  302. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/examples/CLAUDE.md +100 -0
  303. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/examples/django-api-CLAUDE.md +308 -0
  304. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/examples/go-microservice-CLAUDE.md +267 -0
  305. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/examples/rust-api-CLAUDE.md +285 -0
  306. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/examples/saas-nextjs-CLAUDE.md +166 -0
  307. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/examples/user-CLAUDE.md +118 -0
  308. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/hooks/README.md +220 -0
  309. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/plugins/README.md +89 -0
  310. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/the-openclaw-guide.md +471 -0
  311. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/the-security-guide.md +206 -0
  312. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/README.md +60 -0
  313. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/app/Mobile_App_Production_Readiness_Framework_/347/247/273/345/212/250/347/253/257/345/205/250/345/271/263/345/217/260/347/224/237/344/272/247/345/217/257/344/270/212/347/272/277/350/247/204/350/214/203.md +2457 -0
  314. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/app/catalog.md +33 -0
  315. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/architecture.md +358 -0
  316. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/common/AI_Coding_Production_Control_Framework_AI/345/206/231/345/256/214/347/232/204/344/273/243/347/240/201/345/246/202/344/275/225/344/270/215/345/244/261/346/216/247.md +2055 -0
  317. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/common/catalog.md +34 -0
  318. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/initial-content.md +296 -0
  319. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/integration-roadmap.md +221 -0
  320. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/architecture-constraints.md +95 -0
  321. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/code-semantics-and-navigation.md +17 -0
  322. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/code-style-and-naming.md +116 -0
  323. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/frontend-quality-rules.md +138 -0
  324. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/governance-auto-repair.md +82 -0
  325. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/mcp-knowledge-governance.md +24 -0
  326. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/service-dependency-matrix.md +55 -0
  327. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/speckit-requirements-gate.md +260 -0
  328. package/package-source/docs/codex-harness-engineering/templates/package-assets/root/PACKAGE.md +49 -0
  329. package/package-source/docs/codex-harness-engineering/templates/package-assets/root/README.md +52 -0
  330. package/package-source/docs/codex-harness-engineering/templates/package-assets/root/init-project.ps1 +51 -0
  331. package/package-source/docs/codex-harness-engineering/templates/package-assets/root/install-agent-here.ps1 +57 -0
  332. package/package-source/docs/codex-harness-engineering/templates/package-assets/root/install-agent.ps1 +2506 -0
  333. package/package-source/docs/codex-harness-engineering/templates/package-assets/root/install-user.ps1 +29 -0
  334. package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/agents.md +115 -0
  335. package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/coding-style.md +57 -0
  336. package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/constitution.md +290 -0
  337. package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/git.rules +41 -0
  338. package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/harness.rules +29 -0
  339. package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/patterns.md +59 -0
  340. package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/safety.rules +35 -0
  341. package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/testing.md +34 -0
  342. package/package-source/docs/codex-harness-engineering/templates/package-assets/scripts/ai-workflow/check-ai-sync-drift.ps1 +205 -0
  343. package/package-source/docs/codex-harness-engineering/templates/package-assets/scripts/ai-workflow/sync-ai-config-to-targets.ps1 +826 -0
  344. package/package-source/docs/codex-harness-engineering/templates/package-assets/scripts/ai-workflow/sync-targets.example.json +35 -0
  345. package/package-source/docs/codex-harness-engineering/templates/package-assets/scripts/harness/harness-governance-check.ps1 +864 -0
  346. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/HOW_TO_USE_SKILLS.md +91 -0
  347. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/academic-mermaid-diagrams/SKILL.md +172 -0
  348. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/ai-config-git-sync/SKILL.md +152 -0
  349. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/ai-config-git-sync/references/command-recipes.md +92 -0
  350. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/ai-ui-prompts/SKILL.md +350 -0
  351. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/allure-report/SKILL.md +230 -0
  352. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/allure-report/examples/usage.md +99 -0
  353. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/allure-report/scripts/view-allure.ps1 +28 -0
  354. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/api-auto-testing/SKILL.md +329 -0
  355. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/api-contract-template/SKILL.md +88 -0
  356. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/api-design/SKILL.md +139 -0
  357. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/api-integration/SKILL.md +302 -0
  358. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/architect/SKILL.md +211 -0
  359. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/auto-commit/SKILL.md +324 -0
  360. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/backend-patterns/SKILL.md +582 -0
  361. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/baseline-ui/SKILL.md +85 -0
  362. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/better-icons/SKILL.md +129 -0
  363. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/brand-design-md/README.md +215 -0
  364. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/brand-design-md/SKILL.md +191 -0
  365. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/browser-e2e-testing/SKILL.md +305 -0
  366. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/build-error-resolver/SKILL.md +532 -0
  367. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/build-fix/SKILL.md +34 -0
  368. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/business-rule-spec/SKILL.md +99 -0
  369. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/celery-tasks/SKILL.md +95 -0
  370. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/checkpoint/SKILL.md +79 -0
  371. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/cicd/SKILL.md +167 -0
  372. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/claude-openrouter-clash-debug/SKILL.md +100 -0
  373. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/claude-openrouter-clash-debug/references/windows-openrouter-clash-playbook.md +94 -0
  374. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/claude-openrouter-clash-debug/scripts/diagnose-openrouter-route.ps1 +282 -0
  375. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/claude-openrouter-clash-debug/scripts/ensure-openrouter-rule.ps1 +101 -0
  376. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/clickhouse-io/SKILL.md +429 -0
  377. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/code-review/SKILL.md +171 -0
  378. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/code-reviewer/SKILL.md +104 -0
  379. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/coding-standards/SKILL.md +520 -0
  380. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/consistency-checklist/SKILL.md +57 -0
  381. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/continuous-learning/SKILL.md +80 -0
  382. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/continuous-learning/config.json +18 -0
  383. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/continuous-learning/evaluate-session.sh +60 -0
  384. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/core-rules/SKILL.md +78 -0
  385. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/data-flow-spec/SKILL.md +63 -0
  386. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/database/SKILL.md +147 -0
  387. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/deep-interview/SKILL.md +154 -0
  388. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/django-drf/SKILL.md +97 -0
  389. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/doc-updater/SKILL.md +452 -0
  390. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/docker/SKILL.md +216 -0
  391. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/docx/SKILL.md +105 -0
  392. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/e2e/SKILL.md +364 -0
  393. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/e2e-runner/SKILL.md +708 -0
  394. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/error-handling/SKILL.md +245 -0
  395. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/eval/SKILL.md +125 -0
  396. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/eval-harness/SKILL.md +226 -0
  397. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/example-skill/README.md +37 -0
  398. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/example-skill/SKILL.md +141 -0
  399. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/example-skill/examples/usage.md +76 -0
  400. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/example-skill/resources/config.json +21 -0
  401. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/example-skill/scripts/helper.py +24 -0
  402. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/exception-handling-spec/SKILL.md +88 -0
  403. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/find-skill/SKILL.md +95 -0
  404. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/fixing-accessibility/SKILL.md +136 -0
  405. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/fixing-metadata/SKILL.md +111 -0
  406. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/fixing-motion-performance/SKILL.md +151 -0
  407. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/frontend-design/SKILL.md +58 -0
  408. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/frontend-first-workflow/SKILL.md +187 -0
  409. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/frontend-patterns/SKILL.md +631 -0
  410. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/fullstack-workflow/SKILL.md +85 -0
  411. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/git-workflow/SKILL.md +108 -0
  412. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/git-xianyu-analyzer/SKILL.md +346 -0
  413. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/git-xianyu-analyzer/scripts/download_images.py +112 -0
  414. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/github-research/SKILL.md +213 -0
  415. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/glue-coding/SKILL.md +389 -0
  416. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/glue-coding-workflow/SKILL.md +230 -0
  417. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/harness-surface-sync/SKILL.md +204 -0
  418. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/harness-surface-sync/references/current-repo-sync-matrix.md +150 -0
  419. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/harness-surface-sync/references/stale-patterns.md +65 -0
  420. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/agents/openai.yaml +4 -0
  421. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/adapt.md +190 -0
  422. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/animate.md +173 -0
  423. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/audit.md +134 -0
  424. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/bolder.md +113 -0
  425. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/brand.md +104 -0
  426. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/clarify.md +174 -0
  427. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/cognitive-load.md +106 -0
  428. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/color-and-contrast.md +105 -0
  429. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/colorize.md +154 -0
  430. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/craft.md +138 -0
  431. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/critique.md +213 -0
  432. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/delight.md +302 -0
  433. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/distill.md +111 -0
  434. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/document.md +427 -0
  435. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/extract.md +70 -0
  436. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/harden.md +347 -0
  437. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/heuristics-scoring.md +234 -0
  438. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/interaction-design.md +195 -0
  439. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/layout.md +141 -0
  440. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/live.md +513 -0
  441. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/motion-design.md +99 -0
  442. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/onboard.md +234 -0
  443. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/optimize.md +258 -0
  444. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/overdrive.md +130 -0
  445. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/personas.md +178 -0
  446. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/polish.md +232 -0
  447. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/product.md +62 -0
  448. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/quieter.md +99 -0
  449. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/responsive-design.md +114 -0
  450. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/shape.md +136 -0
  451. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/impeccable/reference/spatial-design.md +100 -0
  452. package/package-source/install-manifest.json +523 -0
  453. package/package-source/install-manifest.schema.json +80 -0
  454. package/package-source/tools/install/ai-workflow/check-ai-sync-drift.ps1 +205 -0
  455. package/package-source/tools/install/ai-workflow/sync-ai-config-to-targets.ps1 +826 -0
  456. package/package-source/tools/install/ai-workflow/sync-targets.example.json +35 -0
  457. package/package-source/tools/install/bootstrap-codex-harness.ps1 +776 -0
  458. package/package-source/tools/install/env-check.ps1 +40 -0
  459. package/package-source/tools/install/init-project.ps1 +51 -0
  460. package/package-source/tools/install/install-agent-here.ps1 +57 -0
  461. package/package-source/tools/install/install-agent.ps1 +2513 -0
  462. package/package-source/tools/install/install-user.ps1 +29 -0
  463. package/package.json +1 -1
@@ -0,0 +1,162 @@
1
+ # 后端 - 后端导向开发
2
+
3
+ 后端导向的工作流程(研究 → 构思 → 规划 → 执行 → 优化 → 评审),由 Codex 主导。
4
+
5
+ ## 使用方法
6
+
7
+ ```bash
8
+ /backend <backend task description>
9
+ ```
10
+
11
+ ## 上下文
12
+
13
+ * 后端任务:$ARGUMENTS
14
+ * Codex 主导,Gemini 作为辅助参考
15
+ * 适用场景:API 设计、算法实现、数据库优化、业务逻辑
16
+
17
+ ## 你的角色
18
+
19
+ 你是 **后端协调者**,为服务器端任务协调多模型协作(研究 → 构思 → 规划 → 执行 → 优化 → 评审)。
20
+
21
+ **协作模型**:
22
+
23
+ * **Codex** – 后端逻辑、算法(**后端权威,可信赖**)
24
+ * **Gemini** – 前端视角(**后端意见仅供参考**)
25
+ * **Claude (自身)** – 协调、规划、执行、交付
26
+
27
+ ***
28
+
29
+ ## 多模型调用规范
30
+
31
+ **调用语法**:
32
+
33
+ ```
34
+ # 新会话调用
35
+ Bash({
36
+ command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend codex - \"$PWD\" <<'EOF'
37
+ ROLE_FILE: <角色提示路径>
38
+ <TASK>
39
+ 需求: <增强后的需求(若未增强则为 $ARGUMENTS)>
40
+ 上下文: <来自先前阶段的项目上下文与分析>
41
+ </TASK>
42
+ OUTPUT: 期望的输出格式
43
+ EOF",
44
+ run_in_background: false,
45
+ timeout: 3600000,
46
+ description: "简要描述"
47
+ })
48
+
49
+ # 恢复会话调用
50
+ Bash({
51
+ command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend codex resume <SESSION_ID> - \"$PWD\" <<'EOF'
52
+ ROLE_FILE: <角色提示路径>
53
+ <TASK>
54
+ 需求: <增强后的需求(若未增强则为 $ARGUMENTS)>
55
+ 上下文: <来自先前阶段的项目上下文与分析>
56
+ </TASK>
57
+ OUTPUT: 期望的输出格式
58
+ EOF",
59
+ run_in_background: false,
60
+ timeout: 3600000,
61
+ description: "简要描述"
62
+ })
63
+ ```
64
+
65
+ **角色提示词**:
66
+
67
+ | 阶段 | Codex |
68
+ |-------|-------|
69
+ | 分析 | `~/.claude/.ccg/prompts/codex/analyzer.md` |
70
+ | 规划 | `~/.claude/.ccg/prompts/codex/architect.md` |
71
+ | 评审 | `~/.claude/.ccg/prompts/codex/reviewer.md` |
72
+
73
+ **会话复用**:每次调用返回 `SESSION_ID: xxx`,在后续阶段使用 `resume xxx`。在第 2 阶段保存 `CODEX_SESSION`,在第 3 和第 5 阶段使用 `resume`。
74
+
75
+ ***
76
+
77
+ ## 沟通准则
78
+
79
+ 1. 在回复开头使用模式标签 `[Mode: X]`,初始值为 `[Mode: Research]`
80
+ 2. 遵循严格序列:`Research → Ideation → Plan → Execute → Optimize → Review`
81
+ 3. 需要时(例如确认/选择/批准)使用 `AskUserQuestion` 工具进行用户交互
82
+
83
+ ***
84
+
85
+ ## 核心工作流程
86
+
87
+ ### 阶段 0:提示词增强(可选)
88
+
89
+ `[Mode: Prepare]` - 如果 ace-tool MCP 可用,调用 `mcp__ace-tool__enhance_prompt`,**将原始的 $ARGUMENTS 替换为增强后的结果,用于后续的 Codex 调用**。如果不可用,则按原样使用 `$ARGUMENTS`。
90
+
91
+ ### 阶段 1:研究
92
+
93
+ `[Mode: Research]` - 理解需求并收集上下文
94
+
95
+ 1. **代码检索**(如果 ace-tool MCP 可用):调用 `mcp__ace-tool__search_context` 来检索现有的 API、数据模型、服务架构。如果不可用,则使用内置工具:`Glob` 用于文件发现,`Grep` 用于符号/API 搜索,`Read` 用于上下文收集,`Task`(探索代理)用于更深入的探索。
96
+ 2. 需求完整性评分(0-10):>=7 继续,<7 停止并补充
97
+
98
+ ### 阶段 2:构思
99
+
100
+ `[Mode: Ideation]` - Codex 主导的分析
101
+
102
+ **必须调用 Codex**(遵循上述调用规范):
103
+
104
+ * ROLE\_FILE:`~/.claude/.ccg/prompts/codex/analyzer.md`
105
+ * 需求:增强后的需求(或未增强时的 $ARGUMENTS)
106
+ * 上下文:来自阶段 1 的项目上下文
107
+ * 输出:技术可行性分析、推荐解决方案(至少 2 个)、风险评估
108
+
109
+ **保存 SESSION\_ID**(`CODEX_SESSION`)以供后续阶段复用。
110
+
111
+ 输出解决方案(至少 2 个),等待用户选择。
112
+
113
+ ### 阶段 3:规划
114
+
115
+ `[Mode: Plan]` - Codex 主导的规划
116
+
117
+ **必须调用 Codex**(使用 `resume <CODEX_SESSION>` 以复用会话):
118
+
119
+ * ROLE\_FILE:`~/.claude/.ccg/prompts/codex/architect.md`
120
+ * 需求:用户选择的解决方案
121
+ * 上下文:阶段 2 的分析结果
122
+ * 输出:文件结构、函数/类设计、依赖关系
123
+
124
+ Claude 综合规划,在用户批准后保存到 `.claude/plan/task-name.md`。
125
+
126
+ ### 阶段 4:实施
127
+
128
+ `[Mode: Execute]` - 代码开发
129
+
130
+ * 严格遵循已批准的规划
131
+ * 遵循现有项目的代码规范
132
+ * 确保错误处理、安全性、性能优化
133
+
134
+ ### 阶段 5:优化
135
+
136
+ `[Mode: Optimize]` - Codex 主导的评审
137
+
138
+ **必须调用 Codex**(遵循上述调用规范):
139
+
140
+ * ROLE\_FILE:`~/.claude/.ccg/prompts/codex/reviewer.md`
141
+ * 需求:评审以下后端代码变更
142
+ * 上下文:git diff 或代码内容
143
+ * 输出:安全性、性能、错误处理、API 合规性问题列表
144
+
145
+ 整合评审反馈,在用户确认后执行优化。
146
+
147
+ ### 阶段 6:质量评审
148
+
149
+ `[Mode: Review]` - 最终评估
150
+
151
+ * 对照规划检查完成情况
152
+ * 运行测试以验证功能
153
+ * 报告问题和建议
154
+
155
+ ***
156
+
157
+ ## 关键规则
158
+
159
+ 1. **Codex 的后端意见是可信赖的**
160
+ 2. **Gemini 的后端意见仅供参考**
161
+ 3. 外部模型**对文件系统零写入权限**
162
+ 4. Claude 处理所有代码写入和文件操作
@@ -0,0 +1,321 @@
1
+ # 执行 - 多模型协同执行
2
+
3
+ 多模型协同执行 - 从计划获取原型 → Claude 重构并实施 → 多模型审计与交付。
4
+
5
+ $ARGUMENTS
6
+
7
+ ***
8
+
9
+ ## 核心协议
10
+
11
+ * **语言协议**:与工具/模型交互时使用**英语**,与用户沟通时使用用户的语言
12
+ * **代码主权**:外部模型**零文件系统写入权限**,所有修改由 Claude 执行
13
+ * **脏原型重构**:将 Codex/Gemini 统一差异视为“脏原型”,必须重构为生产级代码
14
+ * **止损机制**:当前阶段输出未经验证前,不得进入下一阶段
15
+ * **前提条件**:仅在用户明确回复“Y”到 `/ccg:plan` 输出后执行(如果缺失,必须先确认)
16
+
17
+ ***
18
+
19
+ ## 多模型调用规范
20
+
21
+ **调用语法**(并行:使用 `run_in_background: true`):
22
+
23
+ ```
24
+ # 恢复会话调用(推荐)- 实现原型
25
+ Bash({
26
+ command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend <codex|gemini> {{GEMINI_MODEL_FLAG}}resume <SESSION_ID> - \"$PWD\" <<'EOF'
27
+ ROLE_FILE: <role prompt path>
28
+ <TASK>
29
+ Requirement: <task description>
30
+ Context: <plan content + target files>
31
+ </TASK>
32
+ OUTPUT: Unified Diff Patch ONLY. Strictly prohibit any actual modifications.
33
+ EOF",
34
+ run_in_background: true,
35
+ timeout: 3600000,
36
+ description: "简要描述"
37
+ })
38
+
39
+ # 新建会话调用 - 实现原型
40
+ Bash({
41
+ command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend <codex|gemini> {{GEMINI_MODEL_FLAG}}- \"$PWD\" <<'EOF'
42
+ ROLE_FILE: <role prompt path>
43
+ <TASK>
44
+ Requirement: <task description>
45
+ Context: <plan content + target files>
46
+ </TASK>
47
+ OUTPUT: Unified Diff Patch ONLY. Strictly prohibit any actual modifications.
48
+ EOF",
49
+ run_in_background: true,
50
+ timeout: 3600000,
51
+ description: "简要描述"
52
+ })
53
+ ```
54
+
55
+ **审计调用语法**(代码审查 / 审计):
56
+
57
+ ```
58
+ Bash({
59
+ command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend <codex|gemini> {{GEMINI_MODEL_FLAG}}resume <SESSION_ID> - \"$PWD\" <<'EOF'
60
+ ROLE_FILE: <role prompt path>
61
+ <TASK>
62
+ Scope: 审计最终的代码变更。
63
+ Inputs:
64
+ - 已应用的补丁 (git diff / final unified diff)
65
+ - 涉及的文件 (必要时提供相关摘录)
66
+ Constraints:
67
+ - 请勿修改任何文件。
68
+ - 请勿输出假设有文件系统访问权限的工具命令。
69
+ </TASK>
70
+ OUTPUT:
71
+ 1) 一个按优先级排序的问题列表 (严重程度, 文件, 理由)
72
+ 2) 具体的修复方案;如果需要更改代码,请包含在一个用围栏代码块包裹的 Unified Diff Patch 中。
73
+ EOF",
74
+ run_in_background: true,
75
+ timeout: 3600000,
76
+ description: "简要描述"
77
+ })
78
+ ```
79
+
80
+ **模型参数说明**:
81
+
82
+ * `{{GEMINI_MODEL_FLAG}}`:当使用 `--backend gemini` 时,替换为 `--gemini-model gemini-3-pro-preview`(注意尾随空格);对于 codex 使用空字符串
83
+
84
+ **角色提示**:
85
+
86
+ | 阶段 | Codex | Gemini |
87
+ |-------|-------|--------|
88
+ | 实施 | `~/.claude/.ccg/prompts/codex/architect.md` | `~/.claude/.ccg/prompts/gemini/frontend.md` |
89
+ | 审查 | `~/.claude/.ccg/prompts/codex/reviewer.md` | `~/.claude/.ccg/prompts/gemini/reviewer.md` |
90
+
91
+ **会话重用**:如果 `/ccg:plan` 提供了 SESSION\_ID,使用 `resume <SESSION_ID>` 来重用上下文。
92
+
93
+ **等待后台任务**(最大超时 600000ms = 10 分钟):
94
+
95
+ ```
96
+ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
97
+ ```
98
+
99
+ **重要**:
100
+
101
+ * 必须指定 `timeout: 600000`,否则默认 30 秒会导致过早超时
102
+ * 如果 10 分钟后仍未完成,继续使用 `TaskOutput` 轮询,**切勿终止进程**
103
+ * 如果因超时而跳过等待,**必须调用 `AskUserQuestion` 询问用户是继续等待还是终止任务**
104
+
105
+ ***
106
+
107
+ ## 执行工作流
108
+
109
+ **执行任务**:$ARGUMENTS
110
+
111
+ ### 阶段 0:读取计划
112
+
113
+ `[Mode: Prepare]`
114
+
115
+ 1. **识别输入类型**:
116
+ * 计划文件路径(例如 `.claude/plan/xxx.md`)
117
+ * 直接任务描述
118
+
119
+ 2. **读取计划内容**:
120
+ * 如果提供了计划文件路径,读取并解析
121
+ * 提取:任务类型、实施步骤、关键文件、SESSION\_ID
122
+
123
+ 3. **执行前确认**:
124
+ * 如果输入是“直接任务描述”或计划缺少 `SESSION_ID` / 关键文件:先与用户确认
125
+ * 如果无法确认用户已回复“Y”到计划:在继续前必须再次确认
126
+
127
+ 4. **任务类型路由**:
128
+
129
+ | 任务类型 | 检测 | 路由 |
130
+ |-----------|-----------|-------|
131
+ | **前端** | 页面、组件、UI、样式、布局 | Gemini |
132
+ | **后端** | API、接口、数据库、逻辑、算法 | Codex |
133
+ | **全栈** | 包含前端和后端 | Codex ∥ Gemini 并行 |
134
+
135
+ ***
136
+
137
+ ### 阶段 1:快速上下文检索
138
+
139
+ `[Mode: Retrieval]`
140
+
141
+ **如果 ace-tool MCP 可用**,使用它进行快速上下文检索:
142
+
143
+ 基于计划中的“关键文件”列表,调用 `mcp__ace-tool__search_context`:
144
+
145
+ ```
146
+ mcp__ace-tool__search_context({
147
+ query: "<基于计划内容的语义查询,包括关键文件、模块、函数名>",
148
+ project_root_path: "$PWD"
149
+ })
150
+ ```
151
+
152
+ **检索策略**:
153
+
154
+ * 从计划的“关键文件”表中提取目标路径
155
+ * 构建语义查询,涵盖:入口文件、依赖模块、相关类型定义
156
+ * 如果结果不足,添加 1-2 次递归检索
157
+
158
+ **如果 ace-tool MCP 不可用**,使用 Claude Code 内置工具作为后备方案:
159
+
160
+ 1. **Glob**:从计划的“关键文件”表中查找目标文件(例如,`Glob("src/components/**/*.tsx")`)
161
+ 2. **Grep**:在代码库中搜索关键符号、函数名、类型定义
162
+ 3. **Read**:读取发现的文件以收集完整的上下文
163
+ 4. **Task (探索代理)**:对于更广泛的探索,使用 `Task` 和 `subagent_type: "Explore"`
164
+
165
+ **检索后**:
166
+
167
+ * 组织检索到的代码片段
168
+ * 确认实施所需的完整上下文
169
+ * 进入阶段 3
170
+
171
+ ***
172
+
173
+ ### 阶段 3:原型获取
174
+
175
+ `[Mode: Prototype]`
176
+
177
+ **基于任务类型路由**:
178
+
179
+ #### 路由 A:前端/UI/样式 → Gemini
180
+
181
+ **限制**:上下文 < 32k 令牌
182
+
183
+ 1. 调用 Gemini(使用 `~/.claude/.ccg/prompts/gemini/frontend.md`)
184
+ 2. 输入:计划内容 + 检索到的上下文 + 目标文件
185
+ 3. 输出:`Unified Diff Patch ONLY. Strictly prohibit any actual modifications.`
186
+ 4. **Gemini 是前端设计权威,其 CSS/React/Vue 原型是最终的视觉基线**
187
+ 5. **警告**:忽略 Gemini 的后端逻辑建议
188
+ 6. 如果计划包含 `GEMINI_SESSION`:优先使用 `resume <GEMINI_SESSION>`
189
+
190
+ #### 路由 B:后端/逻辑/算法 → Codex
191
+
192
+ 1. 调用 Codex(使用 `~/.claude/.ccg/prompts/codex/architect.md`)
193
+ 2. 输入:计划内容 + 检索到的上下文 + 目标文件
194
+ 3. 输出:`Unified Diff Patch ONLY. Strictly prohibit any actual modifications.`
195
+ 4. **Codex 是后端逻辑权威,利用其逻辑推理和调试能力**
196
+ 5. 如果计划包含 `CODEX_SESSION`:优先使用 `resume <CODEX_SESSION>`
197
+
198
+ #### 路由 C:全栈 → 并行调用
199
+
200
+ 1. **并行调用**(`run_in_background: true`):
201
+ * Gemini:处理前端部分
202
+ * Codex:处理后端部分
203
+ 2. 使用 `TaskOutput` 等待两个模型的完整结果
204
+ 3. 每个模型使用计划中相应的 `SESSION_ID` 作为 `resume`(如果缺失则创建新会话)
205
+
206
+ **遵循上面 `IMPORTANT` 中的 `Multi-Model Call Specification` 指令**
207
+
208
+ ***
209
+
210
+ ### 阶段 4:代码实施
211
+
212
+ `[Mode: Implement]`
213
+
214
+ **Claude 作为代码主权执行以下步骤**:
215
+
216
+ 1. **读取差异**:解析 Codex/Gemini 返回的统一差异补丁
217
+
218
+ 2. **心智沙盒**:
219
+ * 模拟将差异应用到目标文件
220
+ * 检查逻辑一致性
221
+ * 识别潜在冲突或副作用
222
+
223
+ 3. **重构与清理**:
224
+ * 将“脏原型”重构为**高度可读、可维护、企业级代码**
225
+ * 移除冗余代码
226
+ * 确保符合项目现有代码标准
227
+ * **除非必要,不要生成注释/文档**,代码应具有自解释性
228
+
229
+ 4. **最小范围**:
230
+ * 更改仅限于需求范围
231
+ * **强制审查**副作用
232
+ * 进行针对性修正
233
+
234
+ 5. **应用更改**:
235
+ * 使用编辑/写入工具执行实际修改
236
+ * **仅修改必要代码**,绝不影响用户的其他现有功能
237
+
238
+ 6. **自验证**(强烈推荐):
239
+ * 运行项目现有的 lint / 类型检查 / 测试(优先考虑最小相关范围)
240
+ * 如果失败:先修复回归问题,然后进入阶段 5
241
+
242
+ ***
243
+
244
+ ### 阶段 5:审计与交付
245
+
246
+ `[Mode: Audit]`
247
+
248
+ #### 5.1 自动审计
249
+
250
+ **更改生效后,必须立即并行调用** Codex 和 Gemini 进行代码审查:
251
+
252
+ 1. **Codex 审查**(`run_in_background: true`):
253
+ * ROLE\_FILE:`~/.claude/.ccg/prompts/codex/reviewer.md`
254
+ * 输入:更改的差异 + 目标文件
255
+ * 重点:安全性、性能、错误处理、逻辑正确性
256
+
257
+ 2. **Gemini 审查**(`run_in_background: true`):
258
+ * ROLE\_FILE:`~/.claude/.ccg/prompts/gemini/reviewer.md`
259
+ * 输入:更改的差异 + 目标文件
260
+ * 重点:可访问性、设计一致性、用户体验
261
+
262
+ 使用 `TaskOutput` 等待两个模型的完整审查结果。优先重用阶段 3 的会话(`resume <SESSION_ID>`)以确保上下文一致性。
263
+
264
+ #### 5.2 整合与修复
265
+
266
+ 1. 综合 Codex + Gemini 的审查反馈
267
+ 2. 按信任规则权衡:后端遵循 Codex,前端遵循 Gemini
268
+ 3. 执行必要的修复
269
+ 4. 根据需要重复阶段 5.1(直到风险可接受)
270
+
271
+ #### 5.3 交付确认
272
+
273
+ 审计通过后,向用户报告:
274
+
275
+ ```markdown
276
+ ## 执行完成
277
+
278
+ ### 变更摘要
279
+ | 文件 | 操作 | 描述 |
280
+ |------|-----------|-------------|
281
+ | path/to/file.ts | 已修改 | 描述 |
282
+
283
+ ### 审计结果
284
+ - Codex: <通过/发现 N 个问题>
285
+ - Gemini: <通过/发现 N 个问题>
286
+
287
+ ### 建议
288
+ 1. [ ] <建议的测试步骤>
289
+ 2. [ ] <建议的验证步骤>
290
+
291
+ ```
292
+
293
+ ***
294
+
295
+ ## 关键规则
296
+
297
+ 1. **代码主权** – 所有文件修改由 Claude 执行,外部模型零写入权限
298
+ 2. **脏原型重构** – Codex/Gemini 输出视为草稿,必须重构
299
+ 3. **信任规则** – 后端遵循 Codex,前端遵循 Gemini
300
+ 4. **最小更改** – 仅修改必要代码,无副作用
301
+ 5. **强制审计** – 更改后必须执行多模型代码审查
302
+
303
+ ***
304
+
305
+ ## 使用方法
306
+
307
+ ```bash
308
+ # Execute plan file
309
+ /ccg:execute .claude/plan/feature-name.md
310
+
311
+ # Execute task directly (for plans already discussed in context)
312
+ /ccg:execute implement user authentication based on previous plan
313
+ ```
314
+
315
+ ***
316
+
317
+ ## 与 /ccg:plan 的关系
318
+
319
+ 1. `/ccg:plan` 生成计划 + SESSION\_ID
320
+ 2. 用户用“Y”确认
321
+ 3. `/ccg:execute` 读取计划,重用 SESSION\_ID,执行实施
@@ -0,0 +1,162 @@
1
+ # 前端 - 前端聚焦开发
2
+
3
+ 前端聚焦的工作流(研究 → 构思 → 规划 → 执行 → 优化 → 评审),由 Gemini 主导。
4
+
5
+ ## 使用方法
6
+
7
+ ```bash
8
+ /frontend <UI task description>
9
+ ```
10
+
11
+ ## 上下文
12
+
13
+ * 前端任务: $ARGUMENTS
14
+ * Gemini 主导,Codex 作为辅助参考
15
+ * 适用场景: 组件设计、响应式布局、UI 动画、样式优化
16
+
17
+ ## 您的角色
18
+
19
+ 您是 **前端协调器**,为 UI/UX 任务协调多模型协作(研究 → 构思 → 规划 → 执行 → 优化 → 评审)。
20
+
21
+ **协作模型**:
22
+
23
+ * **Gemini** – 前端 UI/UX(**前端权威,可信赖**)
24
+ * **Codex** – 后端视角(**前端意见仅供参考**)
25
+ * **Claude(自身)** – 协调、规划、执行、交付
26
+
27
+ ***
28
+
29
+ ## 多模型调用规范
30
+
31
+ **调用语法**:
32
+
33
+ ```
34
+ # 新会话调用
35
+ Bash({
36
+ command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend gemini --gemini-model gemini-3-pro-preview - \"$PWD\" <<'EOF'
37
+ ROLE_FILE: <角色提示文件路径>
38
+ <TASK>
39
+ 需求: <增强后的需求(若未增强则为$ARGUMENTS)>
40
+ 上下文: <来自先前阶段的项目上下文与分析>
41
+ </TASK>
42
+ OUTPUT: 期望的输出格式
43
+ EOF",
44
+ run_in_background: false,
45
+ timeout: 3600000,
46
+ description: "简要描述"
47
+ })
48
+
49
+ # 恢复会话调用
50
+ Bash({
51
+ command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend gemini --gemini-model gemini-3-pro-preview resume <SESSION_ID> - \"$PWD\" <<'EOF'
52
+ ROLE_FILE: <角色提示文件路径>
53
+ <TASK>
54
+ 需求: <增强后的需求(若未增强则为$ARGUMENTS)>
55
+ 上下文: <来自先前阶段的项目上下文与分析>
56
+ </TASK>
57
+ OUTPUT: 期望的输出格式
58
+ EOF",
59
+ run_in_background: false,
60
+ timeout: 3600000,
61
+ description: "简要描述"
62
+ })
63
+ ```
64
+
65
+ **角色提示词**:
66
+
67
+ | 阶段 | Gemini |
68
+ |-------|--------|
69
+ | 分析 | `~/.claude/.ccg/prompts/gemini/analyzer.md` |
70
+ | 规划 | `~/.claude/.ccg/prompts/gemini/architect.md` |
71
+ | 评审 | `~/.claude/.ccg/prompts/gemini/reviewer.md` |
72
+
73
+ **会话重用**: 每次调用返回 `SESSION_ID: xxx`,在后续阶段使用 `resume xxx`。在阶段 2 保存 `GEMINI_SESSION`,在阶段 3 和 5 使用 `resume`。
74
+
75
+ ***
76
+
77
+ ## 沟通指南
78
+
79
+ 1. 以模式标签 `[Mode: X]` 开始响应,初始为 `[Mode: Research]`
80
+ 2. 遵循严格顺序: `Research → Ideation → Plan → Execute → Optimize → Review`
81
+ 3. 需要时(例如确认/选择/批准)使用 `AskUserQuestion` 工具进行用户交互
82
+
83
+ ***
84
+
85
+ ## 核心工作流
86
+
87
+ ### 阶段 0: 提示词增强(可选)
88
+
89
+ `[Mode: Prepare]` - 如果 ace-tool MCP 可用,调用 `mcp__ace-tool__enhance_prompt`,**用增强后的结果替换原始的 $ARGUMENTS,供后续 Gemini 调用使用**。如果不可用,则按原样使用 `$ARGUMENTS`。
90
+
91
+ ### 阶段 1: 研究
92
+
93
+ `[Mode: Research]` - 理解需求并收集上下文
94
+
95
+ 1. **代码检索**(如果 ace-tool MCP 可用):调用 `mcp__ace-tool__search_context` 来检索现有的组件、样式、设计系统。如果不可用,使用内置工具:`Glob` 用于文件发现,`Grep` 用于组件/样式搜索,`Read` 用于上下文收集,`Task`(探索代理)用于更深层次的探索。
96
+ 2. 需求完整性评分(0-10分):>=7 继续,<7 停止并补充
97
+
98
+ ### 阶段 2: 构思
99
+
100
+ `[Mode: Ideation]` - Gemini 主导的分析
101
+
102
+ **必须调用 Gemini**(遵循上述调用规范):
103
+
104
+ * ROLE\_FILE: `~/.claude/.ccg/prompts/gemini/analyzer.md`
105
+ * 需求: 增强后的需求(或未经增强的 $ARGUMENTS)
106
+ * 上下文: 来自阶段 1 的项目上下文
107
+ * 输出: UI 可行性分析、推荐解决方案(至少 2 个)、UX 评估
108
+
109
+ **保存 SESSION\_ID**(`GEMINI_SESSION`)以供后续阶段重用。
110
+
111
+ 输出解决方案(至少 2 个),等待用户选择。
112
+
113
+ ### 阶段 3: 规划
114
+
115
+ `[Mode: Plan]` - Gemini 主导的规划
116
+
117
+ **必须调用 Gemini**(使用 `resume <GEMINI_SESSION>` 来重用会话):
118
+
119
+ * ROLE\_FILE: `~/.claude/.ccg/prompts/gemini/architect.md`
120
+ * 需求: 用户选择的解决方案
121
+ * 上下文: 阶段 2 的分析结果
122
+ * 输出: 组件结构、UI 流程、样式方案
123
+
124
+ Claude 综合规划,在用户批准后保存到 `.claude/plan/task-name.md`。
125
+
126
+ ### 阶段 4: 实现
127
+
128
+ `[Mode: Execute]` - 代码开发
129
+
130
+ * 严格遵循批准的规划
131
+ * 遵循现有项目设计系统和代码标准
132
+ * 确保响应式设计、可访问性
133
+
134
+ ### 阶段 5: 优化
135
+
136
+ `[Mode: Optimize]` - Gemini 主导的评审
137
+
138
+ **必须调用 Gemini**(遵循上述调用规范):
139
+
140
+ * ROLE\_FILE: `~/.claude/.ccg/prompts/gemini/reviewer.md`
141
+ * 需求: 评审以下前端代码变更
142
+ * 上下文: git diff 或代码内容
143
+ * 输出: 可访问性、响应式设计、性能、设计一致性等问题列表
144
+
145
+ 整合评审反馈,在用户确认后执行优化。
146
+
147
+ ### 阶段 6: 质量评审
148
+
149
+ `[Mode: Review]` - 最终评估
150
+
151
+ * 对照规划检查完成情况
152
+ * 验证响应式设计和可访问性
153
+ * 报告问题与建议
154
+
155
+ ***
156
+
157
+ ## 关键规则
158
+
159
+ 1. **Gemini 的前端意见是可信赖的**
160
+ 2. **Codex 的前端意见仅供参考**
161
+ 3. 外部模型**没有文件系统写入权限**
162
+ 4. Claude 处理所有代码写入和文件操作