@pzy560117/codex-harness 0.1.3 → 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 (386) hide show
  1. package/README.md +164 -27
  2. package/bin/harness.js +7 -7
  3. package/lib/commands/doctor.js +12 -12
  4. package/lib/commands/init.js +105 -105
  5. package/lib/commands/run.js +22 -22
  6. package/lib/commands/verify.js +12 -12
  7. package/lib/main.js +62 -62
  8. package/lib/powershell/find-powershell.js +20 -20
  9. package/lib/powershell/invoke-script.js +34 -34
  10. package/lib/project/assert-initialized.js +20 -20
  11. package/lib/project/detect-project-root.js +5 -5
  12. package/lib/release/cache-layout.js +34 -34
  13. package/lib/release/download-release.js +25 -25
  14. package/lib/release/package-source-layout.js +13 -13
  15. package/lib/release/release-config.js +6 -6
  16. package/lib/release/release-manifest.js +76 -76
  17. package/lib/release/resolve-package-source.js +21 -21
  18. package/lib/release/resolve-version.js +26 -26
  19. package/lib/release/unpack-zip.js +25 -25
  20. package/lib/release/verify-sha256.js +16 -16
  21. package/package-source/AGENTS.md +48 -57
  22. package/package-source/PACKAGE.md +7 -7
  23. package/package-source/README.md +85 -81
  24. package/package-source/docs/codex-harness-engineering/templates/AGENTS.md +51 -0
  25. package/package-source/docs/codex-harness-engineering/templates/README.md +21 -20
  26. package/package-source/docs/codex-harness-engineering/templates/bootstrap-codex-harness.ps1 +144 -110
  27. package/package-source/docs/codex-harness-engineering/templates/ci/AGENTS.md +15 -0
  28. package/package-source/docs/codex-harness-engineering/templates/ci/github-action-codex-review.yml +110 -110
  29. package/package-source/docs/codex-harness-engineering/templates/config/AGENTS.md +19 -0
  30. package/package-source/docs/codex-harness-engineering/templates/config/agents/architect.toml +18 -17
  31. package/package-source/docs/codex-harness-engineering/templates/config/agents/backend-worker.toml +15 -14
  32. package/package-source/docs/codex-harness-engineering/templates/config/agents/docs-researcher.toml +13 -12
  33. package/package-source/docs/codex-harness-engineering/templates/config/agents/docs-worker.toml +16 -15
  34. package/package-source/docs/codex-harness-engineering/templates/config/agents/explorer.toml +15 -14
  35. package/package-source/docs/codex-harness-engineering/templates/config/agents/failure-triage.toml +19 -18
  36. package/package-source/docs/codex-harness-engineering/templates/config/agents/frontend-worker.toml +15 -14
  37. package/package-source/docs/codex-harness-engineering/templates/config/agents/harness-writer.toml +16 -15
  38. package/package-source/docs/codex-harness-engineering/templates/config/agents/planner.toml +16 -15
  39. package/package-source/docs/codex-harness-engineering/templates/config/agents/readonly-research.toml +14 -13
  40. package/package-source/docs/codex-harness-engineering/templates/config/agents/reviewer.toml +13 -12
  41. package/package-source/docs/codex-harness-engineering/templates/config/agents/security-reviewer.toml +16 -15
  42. package/package-source/docs/codex-harness-engineering/templates/config/agents/stage1-reviewer.toml +15 -14
  43. package/package-source/docs/codex-harness-engineering/templates/config/agents/stage2-reviewer.toml +16 -15
  44. package/package-source/docs/codex-harness-engineering/templates/config/agents/test-planner.toml +18 -17
  45. package/package-source/docs/codex-harness-engineering/templates/config/agents/test-runner.toml +15 -14
  46. package/package-source/docs/codex-harness-engineering/templates/config/agents/visual-reviewer.toml +16 -15
  47. package/package-source/docs/codex-harness-engineering/templates/config/codex-agent-roles.md +24 -24
  48. package/package-source/docs/codex-harness-engineering/templates/config/codex-config.toml +12 -12
  49. package/package-source/docs/codex-harness-engineering/templates/config/codex-readme.md +6 -6
  50. package/package-source/docs/codex-harness-engineering/templates/config/env-check.ps1 +44 -40
  51. package/package-source/docs/codex-harness-engineering/templates/config/env.example +13 -12
  52. package/package-source/docs/codex-harness-engineering/templates/config/global-AGENTS.md +40 -40
  53. package/package-source/docs/codex-harness-engineering/templates/config/global-config.toml +19 -19
  54. package/package-source/docs/codex-harness-engineering/templates/config/rules/agents.md +118 -115
  55. package/package-source/docs/codex-harness-engineering/templates/config/rules/coding-style.md +57 -74
  56. package/package-source/docs/codex-harness-engineering/templates/config/rules/constitution.md +4 -4
  57. package/package-source/docs/codex-harness-engineering/templates/config/rules/git.rules +41 -41
  58. package/package-source/docs/codex-harness-engineering/templates/config/rules/harness.rules +29 -29
  59. package/package-source/docs/codex-harness-engineering/templates/config/rules/safety.rules +35 -35
  60. package/package-source/docs/codex-harness-engineering/templates/context/AGENTS.md +19 -0
  61. package/package-source/docs/codex-harness-engineering/templates/context/API_MAP.md +18 -0
  62. package/package-source/docs/codex-harness-engineering/templates/context/CHANGELOG_AI.md +11 -0
  63. package/package-source/docs/codex-harness-engineering/templates/context/CURRENT_TASK.md +114 -0
  64. package/package-source/docs/codex-harness-engineering/templates/context/DB_SCHEMA.md +14 -0
  65. package/package-source/docs/codex-harness-engineering/templates/context/DECISIONS.md +12 -0
  66. package/package-source/docs/codex-harness-engineering/templates/context/KNOWN_ISSUES.md +12 -0
  67. package/package-source/docs/codex-harness-engineering/templates/context/PROJECT_CONTEXT.md +14 -0
  68. package/package-source/docs/codex-harness-engineering/templates/context/architecture-brief.md +58 -58
  69. package/package-source/docs/codex-harness-engineering/templates/context/dev-plan.md +89 -83
  70. package/package-source/docs/codex-harness-engineering/templates/context/feature-pack.md +101 -101
  71. package/package-source/docs/codex-harness-engineering/templates/context/repo-map.md +102 -78
  72. package/package-source/docs/codex-harness-engineering/templates/context/service-dependency-matrix.yaml +25 -25
  73. package/package-source/docs/codex-harness-engineering/templates/contracts/AGENTS.md +17 -0
  74. package/package-source/docs/codex-harness-engineering/templates/contracts/README.md +24 -16
  75. package/package-source/docs/codex-harness-engineering/templates/contracts/openapi.yaml +182 -182
  76. package/package-source/docs/codex-harness-engineering/templates/contracts/orval.config.ts +20 -20
  77. package/package-source/docs/codex-harness-engineering/templates/contracts/prism-usage.md +41 -34
  78. package/package-source/docs/codex-harness-engineering/templates/design/AGENTS.md +21 -0
  79. package/package-source/docs/codex-harness-engineering/templates/design/ai-image-brief.md +122 -122
  80. package/package-source/docs/codex-harness-engineering/templates/design/component-map.md +45 -31
  81. package/package-source/docs/codex-harness-engineering/templates/design/design-brief.md +183 -178
  82. package/package-source/docs/codex-harness-engineering/templates/design/design-tokens.json +88 -88
  83. package/package-source/docs/codex-harness-engineering/templates/design/frontend-architecture.md +164 -146
  84. package/package-source/docs/codex-harness-engineering/templates/design/image-to-frontend-spec.md +64 -52
  85. package/package-source/docs/codex-harness-engineering/templates/design/screen-states.md +157 -122
  86. package/package-source/docs/codex-harness-engineering/templates/design/visual-parity-review.md +21 -21
  87. package/package-source/docs/codex-harness-engineering/templates/docs/AGENTS.md +19 -0
  88. package/package-source/docs/codex-harness-engineering/templates/docs/architecture-constraints.md +97 -83
  89. package/package-source/docs/codex-harness-engineering/templates/docs/code-semantics-and-navigation.md +54 -0
  90. package/package-source/docs/codex-harness-engineering/templates/docs/code-style-and-naming.md +116 -0
  91. package/package-source/docs/codex-harness-engineering/templates/docs/directory-structure-template.md +88 -0
  92. package/package-source/docs/codex-harness-engineering/templates/docs/env-and-deployment-template.md +60 -0
  93. package/package-source/docs/codex-harness-engineering/templates/docs/frontend-quality-rules.md +165 -138
  94. package/package-source/docs/codex-harness-engineering/templates/docs/governance-auto-repair.md +82 -80
  95. package/package-source/docs/codex-harness-engineering/templates/docs/harness-architecture.md +78 -78
  96. package/package-source/docs/codex-harness-engineering/templates/docs/install-manifest-governance.md +16 -16
  97. package/package-source/docs/codex-harness-engineering/templates/docs/knowledge-architecture.md +241 -219
  98. package/package-source/docs/codex-harness-engineering/templates/docs/knowledge-import.md +108 -108
  99. package/package-source/docs/codex-harness-engineering/templates/docs/knowledge-lint.md +98 -98
  100. package/package-source/docs/codex-harness-engineering/templates/docs/mcp-knowledge-governance.md +24 -0
  101. package/package-source/docs/codex-harness-engineering/templates/docs/new-project-checklist.md +7 -7
  102. package/package-source/docs/codex-harness-engineering/templates/docs/new-project-usage.md +107 -43
  103. package/package-source/docs/codex-harness-engineering/templates/docs/project-agents-template.md +211 -154
  104. package/package-source/docs/codex-harness-engineering/templates/docs/prompt-knowledge-integration.md +100 -89
  105. package/package-source/docs/codex-harness-engineering/templates/docs/regression-rules.md +47 -45
  106. package/package-source/docs/codex-harness-engineering/templates/docs/requirement-prep-kit/README.md +3 -3
  107. package/package-source/docs/codex-harness-engineering/templates/docs/rule-governance.md +98 -98
  108. package/package-source/docs/codex-harness-engineering/templates/docs/service-dependency-matrix.md +70 -55
  109. package/package-source/docs/codex-harness-engineering/templates/docs/task-session-strategy.md +133 -116
  110. package/package-source/docs/codex-harness-engineering/templates/docs/team-knowledge-sync.md +187 -187
  111. package/package-source/docs/codex-harness-engineering/templates/docs/trace-format.md +44 -32
  112. package/package-source/docs/codex-harness-engineering/templates/governance/AGENTS.md +18 -0
  113. package/package-source/docs/codex-harness-engineering/templates/governance/branch-protection-checklist.md +50 -50
  114. package/package-source/docs/codex-harness-engineering/templates/governance/feedback-evolution-loop.md +55 -55
  115. package/package-source/docs/codex-harness-engineering/templates/governance/retry-budget.yaml +30 -30
  116. package/package-source/docs/codex-harness-engineering/templates/governance/risk-levels.yaml +53 -53
  117. package/package-source/docs/codex-harness-engineering/templates/governance/sandbox-policy.md +13 -13
  118. package/package-source/docs/codex-harness-engineering/templates/hooks/AGENTS.md +15 -0
  119. package/package-source/docs/codex-harness-engineering/templates/hooks/hook-stop-verify.ps1 +171 -118
  120. package/package-source/docs/codex-harness-engineering/templates/hooks/hooks.json +40 -40
  121. package/package-source/docs/codex-harness-engineering/templates/knowledge/AGENTS.md +16 -0
  122. package/package-source/docs/codex-harness-engineering/templates/knowledge/catalog.md +6 -6
  123. package/package-source/docs/codex-harness-engineering/templates/knowledge/decisions/DECISION-HARNESS-001.md +39 -39
  124. package/package-source/docs/codex-harness-engineering/templates/knowledge/guidelines/GUIDELINE-RULES-001.md +30 -30
  125. package/package-source/docs/codex-harness-engineering/templates/knowledge/knowledge-catalog.md +41 -41
  126. package/package-source/docs/codex-harness-engineering/templates/package-assets/.specify/templates/plan-template.md +252 -252
  127. package/package-source/docs/codex-harness-engineering/templates/package-assets/.specify/templates/spec-template.md +145 -145
  128. package/package-source/docs/codex-harness-engineering/templates/package-assets/.specify/templates/tasks-template.md +47 -47
  129. package/package-source/docs/codex-harness-engineering/templates/package-assets/AGENTS.md +19 -0
  130. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/AGENTS.md +25 -0
  131. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/README.md +118 -42
  132. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/START-HERE.md +66 -53
  133. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/agent-ecosystem-practices.md +140 -140
  134. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/best-practices.md +9 -9
  135. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/codex-global-rules-example.md +48 -48
  136. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/AGENTS.md +14 -0
  137. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/goal-templates.md +380 -380
  138. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/AGENTS.md +14 -0
  139. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/README.md +64 -64
  140. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/contracts/openapi.yaml +25 -25
  141. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/contracts/orval.config.ts +20 -20
  142. 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 -44
  143. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/design/component-map.md +17 -17
  144. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/design/design-brief.md +58 -58
  145. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/design/frontend-architecture.md +106 -106
  146. 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 -72
  147. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/design/screen-states.md +25 -25
  148. 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 -38
  149. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/product/difficulty-research.md +39 -39
  150. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/product/page-inventory.md +5 -5
  151. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/product/prd-lite.md +41 -41
  152. 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 -32
  153. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/product/state-matrix.yaml +14 -14
  154. 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 -6
  155. 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 -35
  156. 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 -8
  157. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/packages/ui/TicketFilterBar.tsx +72 -72
  158. 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 -48
  159. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/progress.txt +1 -1
  160. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/stories/TicketFilterBar.stories.tsx +33 -33
  161. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/task.json +54 -54
  162. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/verify.ps1 +42 -42
  163. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/global-rules-and-bootstrap.md +157 -157
  164. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/goal-harness-integration-guide.md +364 -364
  165. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/implementation-flow.md +7 -5
  166. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/implementation-guide.md +25 -25
  167. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/knowledge-surface-map.md +186 -0
  168. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/mode-matrix.md +57 -57
  169. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/new-project-usage.md +176 -0
  170. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/project-agents-template.md +168 -154
  171. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/superpowers-codex-solo-builder-playbook.md +676 -676
  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 -31
  182. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/design-brief.md +183 -178
  183. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/design-tokens.json +88 -88
  184. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/frontend-architecture.md +164 -146
  185. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/image-to-frontend-spec.md +64 -52
  186. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/screen-states.md +157 -122
  187. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/visual-parity-review.md +21 -21
  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 -138
  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/README.md +10 -10
  209. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/e2e.md +30 -30
  210. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/README.md +60 -60
  211. 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 -2457
  212. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/app/catalog.md +33 -33
  213. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/architecture.md +358 -358
  214. 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 -2055
  215. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/common/catalog.md +34 -34
  216. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/initial-content.md +296 -296
  217. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/integration-roadmap.md +221 -221
  218. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/architecture-constraints.md +95 -83
  219. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/code-semantics-and-navigation.md +17 -0
  220. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/code-style-and-naming.md +116 -0
  221. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/frontend-quality-rules.md +138 -138
  222. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/governance-auto-repair.md +82 -80
  223. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/mcp-knowledge-governance.md +24 -0
  224. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/service-dependency-matrix.md +55 -55
  225. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/speckit-requirements-gate.md +124 -124
  226. package/package-source/docs/codex-harness-engineering/templates/package-assets/root/PACKAGE.md +7 -7
  227. package/package-source/docs/codex-harness-engineering/templates/package-assets/root/README.md +52 -52
  228. package/package-source/docs/codex-harness-engineering/templates/package-assets/root/install-agent-here.ps1 +57 -57
  229. package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/agents.md +115 -115
  230. package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/coding-style.md +57 -74
  231. package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/constitution.md +4 -4
  232. package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/git.rules +41 -41
  233. package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/harness.rules +29 -29
  234. package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/safety.rules +35 -35
  235. package/package-source/docs/codex-harness-engineering/templates/package-assets/scripts/ai-workflow/check-ai-sync-drift.ps1 +205 -205
  236. package/package-source/docs/codex-harness-engineering/templates/package-assets/scripts/ai-workflow/sync-ai-config-to-targets.ps1 +826 -826
  237. package/package-source/docs/codex-harness-engineering/templates/package-assets/scripts/ai-workflow/sync-targets.example.json +35 -35
  238. package/package-source/docs/codex-harness-engineering/templates/package-assets/scripts/harness/harness-governance-check.ps1 +864 -366
  239. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/HOW_TO_USE_SKILLS.md +79 -79
  240. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/academic-mermaid-diagrams/SKILL.md +172 -172
  241. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/ai-config-git-sync/SKILL.md +152 -152
  242. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/ai-config-git-sync/references/command-recipes.md +92 -92
  243. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/auto-commit/SKILL.md +324 -322
  244. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/better-icons/SKILL.md +3 -3
  245. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/claude-openrouter-clash-debug/SKILL.md +100 -100
  246. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/claude-openrouter-clash-debug/references/windows-openrouter-clash-playbook.md +94 -94
  247. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/claude-openrouter-clash-debug/scripts/diagnose-openrouter-route.ps1 +282 -282
  248. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/claude-openrouter-clash-debug/scripts/ensure-openrouter-rule.ps1 +101 -101
  249. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/fixing-metadata/SKILL.md +6 -6
  250. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/frontend-design/SKILL.md +37 -37
  251. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/git-xianyu-analyzer/SKILL.md +3 -3
  252. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/harness-surface-sync/SKILL.md +204 -188
  253. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/harness-surface-sync/references/current-repo-sync-matrix.md +150 -110
  254. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/harness-surface-sync/references/stale-patterns.md +65 -65
  255. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/init-autopilot/SKILL.md +17 -15
  256. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/log-analysis-optimization/SKILL.md +5 -5
  257. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/prd-writer-skill/SKILL.md +28 -28
  258. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/qa-e2e-planner/SKILL.md +11 -11
  259. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/qa-e2e-runner/SKILL.md +6 -6
  260. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/qa-mock-cleaner/SKILL.md +4 -4
  261. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/qoder-codex-api-config/SKILL.md +67 -67
  262. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/qoder-codex-api-config/agents/openai.yaml +7 -7
  263. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/qoder-codex-api-config/scripts/configure-qoder-codex-api.ps1 +278 -278
  264. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/requirements-design-template/SKILL.md +87 -87
  265. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/skills-index.md +12 -12
  266. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-analyze/SKILL.md +34 -34
  267. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-checklist/SKILL.md +8 -8
  268. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-clarify/SKILL.md +28 -28
  269. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-e2e-tasks/SKILL.md +12 -12
  270. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-implement/SKILL.md +37 -37
  271. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-plan/SKILL.md +140 -138
  272. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-specify/SKILL.md +100 -100
  273. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-tasks/SKILL.md +86 -86
  274. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-verify/SKILL.md +144 -142
  275. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/sync-project-root-docs/SKILL.md +145 -143
  276. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/sync-project-root-docs/references/current-repo-notes.md +42 -41
  277. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/sync-project-root-docs/references/github-samples.md +33 -33
  278. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/sync-project-root-docs/scripts/collect-root-doc-facts.ps1 +174 -145
  279. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/thesis-writing/references/ai-integrity-and-originality.md +191 -191
  280. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/thesis-writing/references/citation-templates.md +99 -99
  281. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/thesis-writing/references/final-checklist.md +60 -60
  282. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/thesis-writing/references/photographer-booking-paper.md +85 -85
  283. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/thesis-writing/references/test-result-templates.md +22 -22
  284. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/thesis-writing/references/thesis-analysis-template.md +63 -63
  285. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/update-codemaps/SKILL.md +31 -31
  286. package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/README.md +15 -15
  287. package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.analyze.md +60 -60
  288. package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.checklist.md +8 -8
  289. package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.clarify.md +28 -28
  290. package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.e2e-testing.md +10 -10
  291. package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.implement.md +56 -56
  292. package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.plan.md +137 -134
  293. package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.specify.md +100 -100
  294. package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.tasks.md +86 -86
  295. package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.verify.md +130 -130
  296. package/package-source/docs/codex-harness-engineering/templates/product/AGENTS.md +19 -0
  297. package/package-source/docs/codex-harness-engineering/templates/product/acceptance-criteria.md +47 -47
  298. package/package-source/docs/codex-harness-engineering/templates/product/difficulty-research.md +47 -47
  299. package/package-source/docs/codex-harness-engineering/templates/product/page-inventory.md +21 -21
  300. package/package-source/docs/codex-harness-engineering/templates/product/prd-lite.md +166 -158
  301. package/package-source/docs/codex-harness-engineering/templates/product/requirement-interface-matrix.md +37 -37
  302. package/package-source/docs/codex-harness-engineering/templates/product/state-matrix.yaml +116 -105
  303. package/package-source/docs/codex-harness-engineering/templates/prompts/AGENTS.md +15 -0
  304. package/package-source/docs/codex-harness-engineering/templates/prompts/controller-loop.md +88 -88
  305. package/package-source/docs/codex-harness-engineering/templates/prompts/failure-triage.md +71 -69
  306. package/package-source/docs/codex-harness-engineering/templates/prompts/harness-audit.md +54 -52
  307. package/package-source/docs/codex-harness-engineering/templates/prompts/implement-one-task.md +150 -148
  308. package/package-source/docs/codex-harness-engineering/templates/prompts/repair-one-finding.md +70 -67
  309. package/package-source/docs/codex-harness-engineering/templates/prompts/review-one-task.md +45 -43
  310. package/package-source/docs/codex-harness-engineering/templates/prompts/review-stage1-spec.md +111 -109
  311. package/package-source/docs/codex-harness-engineering/templates/prompts/review-stage2-quality.md +82 -80
  312. package/package-source/docs/codex-harness-engineering/templates/prompts/visual-evaluator.md +80 -78
  313. package/package-source/docs/codex-harness-engineering/templates/prompts/worker-role/backend-worker.md +41 -41
  314. package/package-source/docs/codex-harness-engineering/templates/prompts/worker-role/docs-worker.md +28 -28
  315. package/package-source/docs/codex-harness-engineering/templates/prompts/worker-role/frontend-worker.md +46 -46
  316. package/package-source/docs/codex-harness-engineering/templates/prompts/worker-role/harness-writer.md +40 -40
  317. package/package-source/docs/codex-harness-engineering/templates/prompts/worker-role/test-runner.md +27 -27
  318. package/package-source/docs/codex-harness-engineering/templates/runtime/AGENTS.md +66 -50
  319. package/package-source/docs/codex-harness-engineering/templates/runtime/codex-loop.ps1 +2129 -231
  320. package/package-source/docs/codex-harness-engineering/templates/runtime/doctor.ps1 +224 -224
  321. package/package-source/docs/codex-harness-engineering/templates/runtime/project-task-template.json +42 -39
  322. package/package-source/docs/codex-harness-engineering/templates/runtime/scripts/test-install-modes.ps1 +2 -2
  323. package/package-source/docs/codex-harness-engineering/templates/runtime/smoke-task.json +52 -52
  324. package/package-source/docs/codex-harness-engineering/templates/runtime/task-run-profile.json +86 -86
  325. package/package-source/docs/codex-harness-engineering/templates/runtime/task.json +11 -8
  326. package/package-source/docs/codex-harness-engineering/templates/runtime/verify.ps1 +21 -21
  327. package/package-source/docs/codex-harness-engineering/templates/scripts/AGENTS.md +15 -0
  328. package/package-source/docs/codex-harness-engineering/templates/scripts/ai-workflow/check-ai-sync-drift.ps1 +205 -205
  329. package/package-source/docs/codex-harness-engineering/templates/scripts/harness/harness-governance-check.ps1 +864 -366
  330. package/package-source/docs/codex-harness-engineering/templates/spec/10-data-model.md +23 -7
  331. package/package-source/docs/codex-harness-engineering/templates/spec/11-security-design.md +30 -13
  332. package/package-source/docs/codex-harness-engineering/templates/spec/AGENTS.md +15 -0
  333. package/package-source/docs/codex-harness-engineering/templates/testing/ACCEPTANCE_CRITERIA.md +39 -39
  334. package/package-source/docs/codex-harness-engineering/templates/testing/ACCEPTANCE_EXAMPLES.md +37 -37
  335. package/package-source/docs/codex-harness-engineering/templates/testing/AGENTS.md +19 -0
  336. package/package-source/docs/codex-harness-engineering/templates/testing/EVIDENCE_PROTOCOL.md +54 -48
  337. package/package-source/docs/codex-harness-engineering/templates/testing/NATURAL_LANGUAGE_TEST_CASES.md +5 -4
  338. package/package-source/docs/codex-harness-engineering/templates/testing/REGRESSION_PLAN.md +28 -20
  339. package/package-source/docs/codex-harness-engineering/templates/testing/RISK_BASED_TEST_PLAN.md +16 -16
  340. package/package-source/docs/codex-harness-engineering/templates/testing/TEST_STRATEGY.md +98 -97
  341. package/package-source/docs/codex-harness-engineering/templates/testing/TRACEABILITY_MATRIX.md +6 -5
  342. package/package-source/docs/codex-harness-engineering/templates/testing/coverage-policy.md +25 -25
  343. package/package-source/docs/codex-harness-engineering/templates/testing/e2e-plan.md +139 -139
  344. package/package-source/docs/codex-harness-engineering/templates/testing/failure-findings.example.json +3 -3
  345. package/package-source/docs/codex-harness-engineering/templates/testing/failure-triage.md +62 -62
  346. package/package-source/docs/codex-harness-engineering/templates/testing/test-data-plan.md +36 -36
  347. package/package-source/docs/codex-harness-engineering/templates/testing/test-report.md +85 -41
  348. package/package-source/docs/codex-harness-engineering/templates/testing/verify-matrix.md +15 -5
  349. package/package-source/docs/codex-harness-engineering/templates/tools/AGENTS.md +14 -0
  350. package/package-source/docs/codex-harness-engineering/templates/tools/harness/acceptance-lint.ps1 +37 -0
  351. package/package-source/docs/codex-harness-engineering/templates/tools/harness/architecture-lint.ps1 +150 -0
  352. package/package-source/docs/codex-harness-engineering/templates/tools/harness/backend-lint.ps1 +137 -0
  353. package/package-source/docs/codex-harness-engineering/templates/tools/harness/business-lint.ps1 +148 -0
  354. package/package-source/docs/codex-harness-engineering/templates/tools/harness/component-lint.ps1 +148 -0
  355. package/package-source/docs/codex-harness-engineering/templates/tools/harness/config-lint.ps1 +159 -0
  356. package/package-source/docs/codex-harness-engineering/templates/tools/harness/context-lint.ps1 +187 -0
  357. package/package-source/docs/codex-harness-engineering/templates/tools/harness/contract-lint.ps1 +148 -0
  358. package/package-source/docs/codex-harness-engineering/templates/tools/harness/data-lint.ps1 +37 -0
  359. package/package-source/docs/codex-harness-engineering/templates/tools/harness/directory-lint.ps1 +152 -0
  360. package/package-source/docs/codex-harness-engineering/templates/tools/harness/docs-lint.ps1 +40 -0
  361. package/package-source/docs/codex-harness-engineering/templates/tools/harness/impact-lint.ps1 +148 -0
  362. package/package-source/docs/codex-harness-engineering/templates/tools/harness/integration-lint.ps1 +37 -0
  363. package/package-source/docs/codex-harness-engineering/templates/tools/harness/mobile-lint.ps1 +37 -0
  364. package/package-source/docs/codex-harness-engineering/templates/tools/harness/observability-lint.ps1 +137 -0
  365. package/package-source/docs/codex-harness-engineering/templates/tools/harness/performance-lint.ps1 +148 -0
  366. package/package-source/docs/codex-harness-engineering/templates/tools/harness/refactor-lint.ps1 +137 -0
  367. package/package-source/docs/codex-harness-engineering/templates/tools/harness/security-lint.ps1 +159 -0
  368. package/package-source/docs/codex-harness-engineering/templates/tools/harness/session-lint.ps1 +126 -0
  369. package/package-source/docs/codex-harness-engineering/templates/tools/harness/spec-lint.ps1 +285 -0
  370. package/package-source/docs/codex-harness-engineering/templates/tools/harness/state-lint.ps1 +137 -0
  371. package/package-source/docs/codex-harness-engineering/templates/tools/harness/style-lint.ps1 +155 -0
  372. package/package-source/docs/codex-harness-engineering/templates/tools/harness/testing-lint.ps1 +192 -0
  373. package/package-source/docs/codex-harness-engineering/templates/tools/harness/ui-lint.ps1 +148 -0
  374. package/package-source/docs/codex-harness-engineering/templates/trace/AGENTS.md +16 -0
  375. package/package-source/docs/codex-harness-engineering/templates/trace/eval-case.yaml +24 -24
  376. package/package-source/docs/codex-harness-engineering/templates/trace/trace.schema.json +101 -101
  377. package/package-source/install-manifest.json +149 -79
  378. package/package-source/tools/install/ai-workflow/check-ai-sync-drift.ps1 +205 -205
  379. package/package-source/tools/install/ai-workflow/sync-ai-config-to-targets.ps1 +826 -826
  380. package/package-source/tools/install/ai-workflow/sync-targets.example.json +35 -35
  381. package/package-source/tools/install/bootstrap-codex-harness.ps1 +145 -129
  382. package/package-source/tools/install/env-check.ps1 +40 -40
  383. package/package-source/tools/install/init-project.ps1 +1 -1
  384. package/package-source/tools/install/install-agent-here.ps1 +57 -57
  385. package/package-source/tools/install/install-agent.ps1 +33 -31
  386. package/package.json +23 -23
@@ -1,191 +1,191 @@
1
- # 合规降重与 AI 痕迹控制
2
-
3
- 本文件讨论的是**合规写作**,不是规避检测的花招。
4
-
5
- 目标只有两个:
6
-
7
- 1. 让论文真正体现你对项目的理解与分析
8
- 2. 降低因模板化表述、直接搬运、无来源改写导致的重复率和 AI 痕迹
9
-
10
- ## GitHub 经验提炼
11
-
12
- ### 1. 来自 MasterThesis101 的可取做法
13
-
14
- 从 GitHub 仓库 `SUTFutureCoder/MasterThesis101` 可提炼出几条对论文质量直接有帮助的规则:
15
-
16
- 1. 尽可能使用论文文体,不写废话。
17
- 2. 创新点、工作量、思路和方法要“论出来”,并和现有方法做对比。
18
- 3. 章节之间要有递进关系或清晰关系图,不能各写各的。
19
- 4. 论文提交给导师前必须先自查。
20
-
21
- ### 2. 来自 OpenDraft 的可取做法
22
-
23
- 从 GitHub 仓库 `federicodeponte/opendraft` 可提炼出几条 AI 使用边界:
24
-
25
- 1. AI 生成内容只能作为研究草稿起点,不能当成终稿直接提交。
26
- 2. 必须自行核验所有来源。
27
- 3. 必须加入自己的分析、判断和结论。
28
- 4. 必须检查学校或机构的 AI 使用政策。
29
- 5. 不能编造引用,不能把 AI 当成论文作者。
30
-
31
- ## 降低 AI 痕迹的正确方法
32
-
33
- ### 1. 从“本项目事实”出发,不从“通用套话”出发
34
-
35
- 高风险写法:
36
-
37
- - 随着互联网的发展……
38
- - 系统具有良好的可扩展性和实用性……
39
- - 该模块大大提升了用户体验……
40
-
41
- 低风险写法:
42
-
43
- - 本系统将订单确认、支付、退款三个高冲突节点统一收口到订单状态机中,原因在于……
44
- - 档期资源采用日期粒度建模,而不是时间段粒度,主要考虑到当前业务……
45
- - 摄影师详情页同时展示套餐、评价和档期,是为了减少用户在预约前的页面跳转……
46
-
47
- ### 2. 每段至少落一个“本项目特征”
48
-
49
- 每个自然段尽量包含以下至少一类信息:
50
-
51
- 1. 当前项目的业务约束
52
- 2. 当前项目的设计取舍
53
- 3. 当前项目的实现边界
54
- 4. 当前项目的测试结果
55
- 5. 当前项目的不足和改进方向
56
-
57
- 如果一个段落放到任何管理系统论文里都成立,这种段落就很容易显得 AI 味重。
58
-
59
- ### 3. 一次只让 AI 处理一个小问题
60
-
61
- 不要让 AI 一次性生成整章终稿。
62
-
63
- 正确做法:
64
-
65
- 1. 先列提纲
66
- 2. 再写单个小节
67
- 3. 再补引文
68
- 4. 再补图表说明
69
- 5. 最后人工通读改写
70
-
71
- ### 4. 保留“人的判断”而不是只保留“系统做了什么”
72
-
73
- 高 AI 风险段落通常只有事实,没有判断。
74
-
75
- 应主动补充:
76
-
77
- 1. 为什么选这个方案
78
- 2. 为什么没选另一种方案
79
- 3. 这个方案解决了什么
80
- 4. 还没解决什么
81
-
82
- ### 5. 主动写出局限和失败边界
83
-
84
- 通篇只有正面结果、没有局限、没有边界,往往很像 AI 平滑生成。
85
-
86
- 应在各章自然写出:
87
-
88
- 1. 当前版本未实现什么
89
- 2. 哪些测试尚未完成
90
- 3. 哪些功能只是设计阶段设想
91
- 4. 哪些数据结论还不足以外推
92
-
93
- ## 摘要与研究现状示范骨架
94
-
95
- ### 中文摘要三段式骨架
96
-
97
- 1. 第一段写研究目的与意义:
98
- 本文针对……场景中存在的……问题,设计并实现了……系统,目标在于……
99
- 2. 第二段写研究内容与方法:
100
- 系统采用……技术路线,围绕……、……、……等关键问题,提出了……方案。
101
- 3. 第三段写结果与结论:
102
- 验证结果表明,系统已能够……,但在……方面仍有进一步完善空间。
103
-
104
- ### 研究现状对比段骨架
105
-
106
- 1. 先概述现有研究方向:
107
- 现有研究主要集中在……与……两个方向。
108
- 2. 再列举代表成果并加引文:
109
- 例如,文献[x]采用……;文献[y]重点解决了……。
110
- 3. 再指出不足并引出本文切入点:
111
- 但针对……这一具体场景,现有工作在……方面仍存在不足,因此本文选择……
112
-
113
- ## 降低重复率的正确方法
114
-
115
- ### 1. 不直接搬运这些材料
116
-
117
- 以下内容最容易带来重复率问题:
118
-
119
- 1. 开题报告
120
- 2. 需求设计文档
121
- 3. README
122
- 4. 其他毕业论文的研究现状
123
- 5. 官方文档定义段落
124
-
125
- ### 2. 正确改写方式不是同义词替换
126
-
127
- 错误做法:
128
-
129
- - 把原句逐词替换
130
- - 把中文文献逐句翻译再回译
131
- - 把开题报告句子换几个词继续用
132
-
133
- 正确做法:
134
-
135
- 1. 先理解原文在说什么
136
- 2. 再用当前项目语境重写
137
- 3. 最后补引用
138
-
139
- ### 3. 对“借来的观点”和“自己的结论”分开写
140
-
141
- 推荐结构:
142
-
143
- 1. 先概述已有研究或已有做法,并加引文
144
- 2. 再说明这些做法对本文的启示
145
- 3. 最后写本文自己的选择与调整
146
-
147
- 这样既能降重,也更像论文。
148
-
149
- ### 4. 引文要真实进入正文
150
-
151
- 如果只是文末列参考文献,正文不引用,既不能降重复风险,也不能提升学术可信度。
152
-
153
- ## AI 使用合规策略
154
-
155
- ### 1. 查学校政策
156
-
157
- 如果学校或导师对 AI 有明确规定,必须优先遵守。
158
-
159
- ### 2. 保留修改过程
160
-
161
- 建议保留:
162
-
163
- 1. 分章节草稿
164
- 2. 修改前后版本
165
- 3. 引文核验记录
166
- 4. 图表替换记录
167
-
168
- 原因不是“应付检测”,而是为了证明你有真实写作与修改过程。
169
-
170
- ### 3. 不提交“一键生成终稿”
171
-
172
- 凡是长段统一口吻、无局限、无校核、无真实引文的终稿,风险最高。
173
-
174
- ## 自查清单
175
-
176
- 提交前逐项检查:
177
-
178
- 1. 是否还有大段开题报告原句
179
- 2. 是否还有 README 或需求文档直搬段落
180
- 3. 是否还有“随着……发展”这类空泛套话
181
- 4. 是否每章都有项目特有的判断和边界
182
- 5. 是否所有引用都已核验真实存在
183
- 6. 是否每个核心小节都有至少一个“为什么这样设计”
184
- 7. 是否存在整页都可以替换到别的系统论文里的通用段落
185
-
186
- ## 经验来源
187
-
188
- 以下 GitHub 项目提供了可吸收的方法论:
189
-
190
- 1. `SUTFutureCoder/MasterThesis101`
191
- 2. `federicodeponte/opendraft`
1
+ # 合规降重与 AI 痕迹控制
2
+
3
+ 本文件讨论的是**合规写作**,不是规避检测的花招。
4
+
5
+ 目标只有两个:
6
+
7
+ 1. 让论文真正体现你对项目的理解与分析
8
+ 2. 降低因模板化表述、直接搬运、无来源改写导致的重复率和 AI 痕迹
9
+
10
+ ## GitHub 经验提炼
11
+
12
+ ### 1. 来自 MasterThesis101 的可取做法
13
+
14
+ 从 GitHub 仓库 `SUTFutureCoder/MasterThesis101` 可提炼出几条对论文质量直接有帮助的规则:
15
+
16
+ 1. 尽可能使用论文文体,不写废话。
17
+ 2. 创新点、工作量、思路和方法要“论出来”,并和现有方法做对比。
18
+ 3. 章节之间要有递进关系或清晰关系图,不能各写各的。
19
+ 4. 论文提交给导师前必须先自查。
20
+
21
+ ### 2. 来自 OpenDraft 的可取做法
22
+
23
+ 从 GitHub 仓库 `federicodeponte/opendraft` 可提炼出几条 AI 使用边界:
24
+
25
+ 1. AI 生成内容只能作为研究草稿起点,不能当成终稿直接提交。
26
+ 2. 必须自行核验所有来源。
27
+ 3. 必须加入自己的分析、判断和结论。
28
+ 4. 必须检查学校或机构的 AI 使用政策。
29
+ 5. 不能编造引用,不能把 AI 当成论文作者。
30
+
31
+ ## 降低 AI 痕迹的正确方法
32
+
33
+ ### 1. 从“本项目事实”出发,不从“通用套话”出发
34
+
35
+ 高风险写法:
36
+
37
+ - 随着互联网的发展……
38
+ - 系统具有良好的可扩展性和实用性……
39
+ - 该模块大大提升了用户体验……
40
+
41
+ 低风险写法:
42
+
43
+ - 本系统将订单确认、支付、退款三个高冲突节点统一收口到订单状态机中,原因在于……
44
+ - 档期资源采用日期粒度建模,而不是时间段粒度,主要考虑到当前业务……
45
+ - 摄影师详情页同时展示套餐、评价和档期,是为了减少用户在预约前的页面跳转……
46
+
47
+ ### 2. 每段至少落一个“本项目特征”
48
+
49
+ 每个自然段尽量包含以下至少一类信息:
50
+
51
+ 1. 当前项目的业务约束
52
+ 2. 当前项目的设计取舍
53
+ 3. 当前项目的实现边界
54
+ 4. 当前项目的测试结果
55
+ 5. 当前项目的不足和改进方向
56
+
57
+ 如果一个段落放到任何管理系统论文里都成立,这种段落就很容易显得 AI 味重。
58
+
59
+ ### 3. 一次只让 AI 处理一个小问题
60
+
61
+ 不要让 AI 一次性生成整章终稿。
62
+
63
+ 正确做法:
64
+
65
+ 1. 先列提纲
66
+ 2. 再写单个小节
67
+ 3. 再补引文
68
+ 4. 再补图表说明
69
+ 5. 最后人工通读改写
70
+
71
+ ### 4. 保留“人的判断”而不是只保留“系统做了什么”
72
+
73
+ 高 AI 风险段落通常只有事实,没有判断。
74
+
75
+ 应主动补充:
76
+
77
+ 1. 为什么选这个方案
78
+ 2. 为什么没选另一种方案
79
+ 3. 这个方案解决了什么
80
+ 4. 还没解决什么
81
+
82
+ ### 5. 主动写出局限和失败边界
83
+
84
+ 通篇只有正面结果、没有局限、没有边界,往往很像 AI 平滑生成。
85
+
86
+ 应在各章自然写出:
87
+
88
+ 1. 当前版本未实现什么
89
+ 2. 哪些测试尚未完成
90
+ 3. 哪些功能只是设计阶段设想
91
+ 4. 哪些数据结论还不足以外推
92
+
93
+ ## 摘要与研究现状示范骨架
94
+
95
+ ### 中文摘要三段式骨架
96
+
97
+ 1. 第一段写研究目的与意义:
98
+ 本文针对……场景中存在的……问题,设计并实现了……系统,目标在于……
99
+ 2. 第二段写研究内容与方法:
100
+ 系统采用……技术路线,围绕……、……、……等关键问题,提出了……方案。
101
+ 3. 第三段写结果与结论:
102
+ 验证结果表明,系统已能够……,但在……方面仍有进一步完善空间。
103
+
104
+ ### 研究现状对比段骨架
105
+
106
+ 1. 先概述现有研究方向:
107
+ 现有研究主要集中在……与……两个方向。
108
+ 2. 再列举代表成果并加引文:
109
+ 例如,文献[x]采用……;文献[y]重点解决了……。
110
+ 3. 再指出不足并引出本文切入点:
111
+ 但针对……这一具体场景,现有工作在……方面仍存在不足,因此本文选择……
112
+
113
+ ## 降低重复率的正确方法
114
+
115
+ ### 1. 不直接搬运这些材料
116
+
117
+ 以下内容最容易带来重复率问题:
118
+
119
+ 1. 开题报告
120
+ 2. 需求设计文档
121
+ 3. README
122
+ 4. 其他毕业论文的研究现状
123
+ 5. 官方文档定义段落
124
+
125
+ ### 2. 正确改写方式不是同义词替换
126
+
127
+ 错误做法:
128
+
129
+ - 把原句逐词替换
130
+ - 把中文文献逐句翻译再回译
131
+ - 把开题报告句子换几个词继续用
132
+
133
+ 正确做法:
134
+
135
+ 1. 先理解原文在说什么
136
+ 2. 再用当前项目语境重写
137
+ 3. 最后补引用
138
+
139
+ ### 3. 对“借来的观点”和“自己的结论”分开写
140
+
141
+ 推荐结构:
142
+
143
+ 1. 先概述已有研究或已有做法,并加引文
144
+ 2. 再说明这些做法对本文的启示
145
+ 3. 最后写本文自己的选择与调整
146
+
147
+ 这样既能降重,也更像论文。
148
+
149
+ ### 4. 引文要真实进入正文
150
+
151
+ 如果只是文末列参考文献,正文不引用,既不能降重复风险,也不能提升学术可信度。
152
+
153
+ ## AI 使用合规策略
154
+
155
+ ### 1. 查学校政策
156
+
157
+ 如果学校或导师对 AI 有明确规定,必须优先遵守。
158
+
159
+ ### 2. 保留修改过程
160
+
161
+ 建议保留:
162
+
163
+ 1. 分章节草稿
164
+ 2. 修改前后版本
165
+ 3. 引文核验记录
166
+ 4. 图表替换记录
167
+
168
+ 原因不是“应付检测”,而是为了证明你有真实写作与修改过程。
169
+
170
+ ### 3. 不提交“一键生成终稿”
171
+
172
+ 凡是长段统一口吻、无局限、无校核、无真实引文的终稿,风险最高。
173
+
174
+ ## 自查清单
175
+
176
+ 提交前逐项检查:
177
+
178
+ 1. 是否还有大段开题报告原句
179
+ 2. 是否还有 README 或需求文档直搬段落
180
+ 3. 是否还有“随着……发展”这类空泛套话
181
+ 4. 是否每章都有项目特有的判断和边界
182
+ 5. 是否所有引用都已核验真实存在
183
+ 6. 是否每个核心小节都有至少一个“为什么这样设计”
184
+ 7. 是否存在整页都可以替换到别的系统论文里的通用段落
185
+
186
+ ## 经验来源
187
+
188
+ 以下 GitHub 项目提供了可吸收的方法论:
189
+
190
+ 1. `SUTFutureCoder/MasterThesis101`
191
+ 2. `federicodeponte/opendraft`
@@ -1,99 +1,99 @@
1
- # 引文格式与句式模板
2
-
3
- > [!IMPORTANT]
4
- > 本文件中的 `[1]`、`[2]`、`[3]` 只是格式示例,不代表固定编号。
5
- >
6
- > 论文实际写作时,所有编号必须按**正文首次出现顺序**分配:
7
- >
8
- > 1. 谁先在正文第一次被引用,谁就是 `[1]`
9
- > 2. 下一条首次出现的文献才是 `[2]`
10
- > 3. 同一文献重复引用时继续沿用原编号
11
- > 4. 文末参考文献列表也必须按正文首次引用顺序同步排列
12
-
13
- > [!IMPORTANT]
14
- > 当学校未单独规定来源比例时,参考文献来源建议按以下结构控制:
15
- >
16
- > 1. 中文参考文献约 60%
17
- > 2. 英文参考文献约 20%
18
- > 3. 其他参考文献约 20%
19
- >
20
- > 其中官方文档、RFC、标准、技术手册等应归入“其他参考文献”,不能大量替代中文和英文学术文献。
21
-
22
- > [!IMPORTANT]
23
- > 当学校模板未给出更高数量要求时,论文终稿参考文献默认**不少于 15 条**。
24
- >
25
- > 按 15 条估算时,可直接按以下基线补齐:
26
- >
27
- > 1. 中文不少于 9 条
28
- > 2. 英文不少于 3 条
29
- > 3. 其他约 3 条
30
- >
31
- > 如果当前草稿只有 8 到 12 条文献,不要直接润色正文,应先补齐文献池再排正文编号。
32
-
33
- ## GB/T 7714-2015 常见格式示例
34
-
35
- ### 期刊论文
36
-
37
- 格式:
38
-
39
- 作者. 题名[J]. 期刊名, 年, 卷(期): 起止页码.
40
-
41
- 示例:
42
-
43
- [1] 张三, 李四. 基于 Redis 的分布式锁设计与实现[J]. 计算机工程, 2023, 49(8): 120-127.
44
-
45
- ### 学位论文
46
-
47
- 格式:
48
-
49
- 作者. 题名[D]. 城市: 学校, 年.
50
-
51
- 示例:
52
-
53
- [2] 王五. 基于状态机的预约系统设计与实现[D]. 南京: 南京理工大学, 2021.
54
-
55
- ### 网络资源
56
-
57
- 格式:
58
-
59
- 作者/机构. 题名[EB/OL]. (发布日期)[引用日期]. URL.
60
-
61
- 示例:
62
-
63
- [3] VMware. Spring Boot Reference Documentation[EB/OL]. [2026-04-08]. https://docs.spring.io/spring-boot/docs/3.2.4/reference/html/
64
-
65
- ## 编号排序规则
66
-
67
- 1. 正文中的引文采用顺序编码制。
68
- 2. 编号依据不是文献类型,也不是作者姓名,而是**第一次在正文中出现的先后顺序**。
69
- 3. 如果第三章先引用某文献,而第一章没有引用它,那么它仍应按全篇第一次出现的位置参与编号。
70
- 4. 文末参考文献列表必须与正文编号一一对应,按 `[1]`、`[2]`、`[3]` 顺序排列。
71
- 5. 改稿后若正文引用顺序改变,必须整体重排,不能残留跳号、重复号或正文文末不一致的问题。
72
-
73
- ## 来源结构建议
74
-
75
- 1. 研究现状部分优先使用中文和英文学术文献,不要用官方文档充当研究成果来源。
76
- 2. 第二章关键技术介绍可以少量引用官方文档或标准,但数量应受控。
77
- 3. 如果正文参考文献明显被官方文档占据主体,说明来源结构失衡,需要补中文和英文论文。
78
- 4. 对系统类本科论文,优先做到“中文文献为主、英文文献补充、其他文献兜底”。
79
- 5. 如果学校没有特殊规定,优先把文献池扩到 15 条以上再进入终稿整理阶段。
80
-
81
- ## 研究现状常用句式
82
-
83
- 1. 文献[x]提出了……方法,该方法在……场景下取得了较好效果,但在……方面仍存在不足。
84
- 2. 国外相关系统多侧重于……,对……问题的处理相对成熟;相比之下,国内研究更强调……[x]。
85
- 3. 现有研究普遍关注……,但针对……这一具体业务约束的讨论仍较少[x]。
86
- 4. 与上述工作不同,本文将研究重点收敛到……,原因在于当前项目需要优先解决……问题。
87
- 5. 综合已有研究可以看出,……已经具备较成熟方案,但……仍然是工程落地中的难点。
88
-
89
- ## 第二章技术介绍常用句式
90
-
91
- 1. JWT 的无状态认证机制已在文献[x]中有较为系统的描述,本文主要关注其与角色权限边界的结合方式。
92
- 2. 关于 Redis 分布式锁的实现原理,文献[x]给出了基础方法,本文进一步将其应用到……资源竞争场景中。
93
- 3. 文献[x]指出状态机模型适合处理多阶段业务流转问题,这为本文设计订单状态闭环提供了理论依据。
94
-
95
- ## 第三章/第四章设计引用句式
96
-
97
- 1. 参考同类系统在……方面的设计经验[x],本文在总体结构上采用了……方案。
98
- 2. 结合文献[x]对……的讨论,以及本系统的业务边界,本文最终选择……而非……。
99
- 3. 现有系统在……方面的处理思路为本文提供了启发,但考虑到当前项目规模,本文做了……调整。
1
+ # 引文格式与句式模板
2
+
3
+ > [!IMPORTANT]
4
+ > 本文件中的 `[1]`、`[2]`、`[3]` 只是格式示例,不代表固定编号。
5
+ >
6
+ > 论文实际写作时,所有编号必须按**正文首次出现顺序**分配:
7
+ >
8
+ > 1. 谁先在正文第一次被引用,谁就是 `[1]`
9
+ > 2. 下一条首次出现的文献才是 `[2]`
10
+ > 3. 同一文献重复引用时继续沿用原编号
11
+ > 4. 文末参考文献列表也必须按正文首次引用顺序同步排列
12
+
13
+ > [!IMPORTANT]
14
+ > 当学校未单独规定来源比例时,参考文献来源建议按以下结构控制:
15
+ >
16
+ > 1. 中文参考文献约 60%
17
+ > 2. 英文参考文献约 20%
18
+ > 3. 其他参考文献约 20%
19
+ >
20
+ > 其中官方文档、RFC、标准、技术手册等应归入“其他参考文献”,不能大量替代中文和英文学术文献。
21
+
22
+ > [!IMPORTANT]
23
+ > 当学校模板未给出更高数量要求时,论文终稿参考文献默认**不少于 15 条**。
24
+ >
25
+ > 按 15 条估算时,可直接按以下基线补齐:
26
+ >
27
+ > 1. 中文不少于 9 条
28
+ > 2. 英文不少于 3 条
29
+ > 3. 其他约 3 条
30
+ >
31
+ > 如果当前草稿只有 8 到 12 条文献,不要直接润色正文,应先补齐文献池再排正文编号。
32
+
33
+ ## GB/T 7714-2015 常见格式示例
34
+
35
+ ### 期刊论文
36
+
37
+ 格式:
38
+
39
+ 作者. 题名[J]. 期刊名, 年, 卷(期): 起止页码.
40
+
41
+ 示例:
42
+
43
+ [1] 张三, 李四. 基于 Redis 的分布式锁设计与实现[J]. 计算机工程, 2023, 49(8): 120-127.
44
+
45
+ ### 学位论文
46
+
47
+ 格式:
48
+
49
+ 作者. 题名[D]. 城市: 学校, 年.
50
+
51
+ 示例:
52
+
53
+ [2] 王五. 基于状态机的预约系统设计与实现[D]. 南京: 南京理工大学, 2021.
54
+
55
+ ### 网络资源
56
+
57
+ 格式:
58
+
59
+ 作者/机构. 题名[EB/OL]. (发布日期)[引用日期]. URL.
60
+
61
+ 示例:
62
+
63
+ [3] VMware. Spring Boot Reference Documentation[EB/OL]. [2026-04-08]. https://docs.spring.io/spring-boot/docs/3.2.4/reference/html/
64
+
65
+ ## 编号排序规则
66
+
67
+ 1. 正文中的引文采用顺序编码制。
68
+ 2. 编号依据不是文献类型,也不是作者姓名,而是**第一次在正文中出现的先后顺序**。
69
+ 3. 如果第三章先引用某文献,而第一章没有引用它,那么它仍应按全篇第一次出现的位置参与编号。
70
+ 4. 文末参考文献列表必须与正文编号一一对应,按 `[1]`、`[2]`、`[3]` 顺序排列。
71
+ 5. 改稿后若正文引用顺序改变,必须整体重排,不能残留跳号、重复号或正文文末不一致的问题。
72
+
73
+ ## 来源结构建议
74
+
75
+ 1. 研究现状部分优先使用中文和英文学术文献,不要用官方文档充当研究成果来源。
76
+ 2. 第二章关键技术介绍可以少量引用官方文档或标准,但数量应受控。
77
+ 3. 如果正文参考文献明显被官方文档占据主体,说明来源结构失衡,需要补中文和英文论文。
78
+ 4. 对系统类本科论文,优先做到“中文文献为主、英文文献补充、其他文献兜底”。
79
+ 5. 如果学校没有特殊规定,优先把文献池扩到 15 条以上再进入终稿整理阶段。
80
+
81
+ ## 研究现状常用句式
82
+
83
+ 1. 文献[x]提出了……方法,该方法在……场景下取得了较好效果,但在……方面仍存在不足。
84
+ 2. 国外相关系统多侧重于……,对……问题的处理相对成熟;相比之下,国内研究更强调……[x]。
85
+ 3. 现有研究普遍关注……,但针对……这一具体业务约束的讨论仍较少[x]。
86
+ 4. 与上述工作不同,本文将研究重点收敛到……,原因在于当前项目需要优先解决……问题。
87
+ 5. 综合已有研究可以看出,……已经具备较成熟方案,但……仍然是工程落地中的难点。
88
+
89
+ ## 第二章技术介绍常用句式
90
+
91
+ 1. JWT 的无状态认证机制已在文献[x]中有较为系统的描述,本文主要关注其与角色权限边界的结合方式。
92
+ 2. 关于 Redis 分布式锁的实现原理,文献[x]给出了基础方法,本文进一步将其应用到……资源竞争场景中。
93
+ 3. 文献[x]指出状态机模型适合处理多阶段业务流转问题,这为本文设计订单状态闭环提供了理论依据。
94
+
95
+ ## 第三章/第四章设计引用句式
96
+
97
+ 1. 参考同类系统在……方面的设计经验[x],本文在总体结构上采用了……方案。
98
+ 2. 结合文献[x]对……的讨论,以及本系统的业务边界,本文最终选择……而非……。
99
+ 3. 现有系统在……方面的处理思路为本文提供了启发,但考虑到当前项目规模,本文做了……调整。