@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.
- package/README.md +164 -27
- package/bin/harness.js +7 -7
- package/lib/commands/doctor.js +12 -12
- package/lib/commands/init.js +105 -105
- package/lib/commands/run.js +22 -22
- package/lib/commands/verify.js +12 -12
- package/lib/main.js +62 -62
- package/lib/powershell/find-powershell.js +20 -20
- package/lib/powershell/invoke-script.js +34 -34
- package/lib/project/assert-initialized.js +20 -20
- package/lib/project/detect-project-root.js +5 -5
- package/lib/release/cache-layout.js +34 -34
- package/lib/release/download-release.js +25 -25
- package/lib/release/package-source-layout.js +13 -13
- package/lib/release/release-config.js +6 -6
- package/lib/release/release-manifest.js +76 -76
- package/lib/release/resolve-package-source.js +21 -21
- package/lib/release/resolve-version.js +26 -26
- package/lib/release/unpack-zip.js +25 -25
- package/lib/release/verify-sha256.js +16 -16
- package/package-source/AGENTS.md +48 -57
- package/package-source/PACKAGE.md +7 -7
- package/package-source/README.md +85 -81
- package/package-source/docs/codex-harness-engineering/templates/AGENTS.md +51 -0
- package/package-source/docs/codex-harness-engineering/templates/README.md +21 -20
- package/package-source/docs/codex-harness-engineering/templates/bootstrap-codex-harness.ps1 +144 -110
- package/package-source/docs/codex-harness-engineering/templates/ci/AGENTS.md +15 -0
- package/package-source/docs/codex-harness-engineering/templates/ci/github-action-codex-review.yml +110 -110
- package/package-source/docs/codex-harness-engineering/templates/config/AGENTS.md +19 -0
- package/package-source/docs/codex-harness-engineering/templates/config/agents/architect.toml +18 -17
- package/package-source/docs/codex-harness-engineering/templates/config/agents/backend-worker.toml +15 -14
- package/package-source/docs/codex-harness-engineering/templates/config/agents/docs-researcher.toml +13 -12
- package/package-source/docs/codex-harness-engineering/templates/config/agents/docs-worker.toml +16 -15
- package/package-source/docs/codex-harness-engineering/templates/config/agents/explorer.toml +15 -14
- package/package-source/docs/codex-harness-engineering/templates/config/agents/failure-triage.toml +19 -18
- package/package-source/docs/codex-harness-engineering/templates/config/agents/frontend-worker.toml +15 -14
- package/package-source/docs/codex-harness-engineering/templates/config/agents/harness-writer.toml +16 -15
- package/package-source/docs/codex-harness-engineering/templates/config/agents/planner.toml +16 -15
- package/package-source/docs/codex-harness-engineering/templates/config/agents/readonly-research.toml +14 -13
- package/package-source/docs/codex-harness-engineering/templates/config/agents/reviewer.toml +13 -12
- package/package-source/docs/codex-harness-engineering/templates/config/agents/security-reviewer.toml +16 -15
- package/package-source/docs/codex-harness-engineering/templates/config/agents/stage1-reviewer.toml +15 -14
- package/package-source/docs/codex-harness-engineering/templates/config/agents/stage2-reviewer.toml +16 -15
- package/package-source/docs/codex-harness-engineering/templates/config/agents/test-planner.toml +18 -17
- package/package-source/docs/codex-harness-engineering/templates/config/agents/test-runner.toml +15 -14
- package/package-source/docs/codex-harness-engineering/templates/config/agents/visual-reviewer.toml +16 -15
- package/package-source/docs/codex-harness-engineering/templates/config/codex-agent-roles.md +24 -24
- package/package-source/docs/codex-harness-engineering/templates/config/codex-config.toml +12 -12
- package/package-source/docs/codex-harness-engineering/templates/config/codex-readme.md +6 -6
- package/package-source/docs/codex-harness-engineering/templates/config/env-check.ps1 +44 -40
- package/package-source/docs/codex-harness-engineering/templates/config/env.example +13 -12
- package/package-source/docs/codex-harness-engineering/templates/config/global-AGENTS.md +40 -40
- package/package-source/docs/codex-harness-engineering/templates/config/global-config.toml +19 -19
- package/package-source/docs/codex-harness-engineering/templates/config/rules/agents.md +118 -115
- package/package-source/docs/codex-harness-engineering/templates/config/rules/coding-style.md +57 -74
- package/package-source/docs/codex-harness-engineering/templates/config/rules/constitution.md +4 -4
- package/package-source/docs/codex-harness-engineering/templates/config/rules/git.rules +41 -41
- package/package-source/docs/codex-harness-engineering/templates/config/rules/harness.rules +29 -29
- package/package-source/docs/codex-harness-engineering/templates/config/rules/safety.rules +35 -35
- package/package-source/docs/codex-harness-engineering/templates/context/AGENTS.md +19 -0
- package/package-source/docs/codex-harness-engineering/templates/context/API_MAP.md +18 -0
- package/package-source/docs/codex-harness-engineering/templates/context/CHANGELOG_AI.md +11 -0
- package/package-source/docs/codex-harness-engineering/templates/context/CURRENT_TASK.md +114 -0
- package/package-source/docs/codex-harness-engineering/templates/context/DB_SCHEMA.md +14 -0
- package/package-source/docs/codex-harness-engineering/templates/context/DECISIONS.md +12 -0
- package/package-source/docs/codex-harness-engineering/templates/context/KNOWN_ISSUES.md +12 -0
- package/package-source/docs/codex-harness-engineering/templates/context/PROJECT_CONTEXT.md +14 -0
- package/package-source/docs/codex-harness-engineering/templates/context/architecture-brief.md +58 -58
- package/package-source/docs/codex-harness-engineering/templates/context/dev-plan.md +89 -83
- package/package-source/docs/codex-harness-engineering/templates/context/feature-pack.md +101 -101
- package/package-source/docs/codex-harness-engineering/templates/context/repo-map.md +102 -78
- package/package-source/docs/codex-harness-engineering/templates/context/service-dependency-matrix.yaml +25 -25
- package/package-source/docs/codex-harness-engineering/templates/contracts/AGENTS.md +17 -0
- package/package-source/docs/codex-harness-engineering/templates/contracts/README.md +24 -16
- package/package-source/docs/codex-harness-engineering/templates/contracts/openapi.yaml +182 -182
- package/package-source/docs/codex-harness-engineering/templates/contracts/orval.config.ts +20 -20
- package/package-source/docs/codex-harness-engineering/templates/contracts/prism-usage.md +41 -34
- package/package-source/docs/codex-harness-engineering/templates/design/AGENTS.md +21 -0
- package/package-source/docs/codex-harness-engineering/templates/design/ai-image-brief.md +122 -122
- package/package-source/docs/codex-harness-engineering/templates/design/component-map.md +45 -31
- package/package-source/docs/codex-harness-engineering/templates/design/design-brief.md +183 -178
- package/package-source/docs/codex-harness-engineering/templates/design/design-tokens.json +88 -88
- package/package-source/docs/codex-harness-engineering/templates/design/frontend-architecture.md +164 -146
- package/package-source/docs/codex-harness-engineering/templates/design/image-to-frontend-spec.md +64 -52
- package/package-source/docs/codex-harness-engineering/templates/design/screen-states.md +157 -122
- package/package-source/docs/codex-harness-engineering/templates/design/visual-parity-review.md +21 -21
- package/package-source/docs/codex-harness-engineering/templates/docs/AGENTS.md +19 -0
- package/package-source/docs/codex-harness-engineering/templates/docs/architecture-constraints.md +97 -83
- package/package-source/docs/codex-harness-engineering/templates/docs/code-semantics-and-navigation.md +54 -0
- package/package-source/docs/codex-harness-engineering/templates/docs/code-style-and-naming.md +116 -0
- package/package-source/docs/codex-harness-engineering/templates/docs/directory-structure-template.md +88 -0
- package/package-source/docs/codex-harness-engineering/templates/docs/env-and-deployment-template.md +60 -0
- package/package-source/docs/codex-harness-engineering/templates/docs/frontend-quality-rules.md +165 -138
- package/package-source/docs/codex-harness-engineering/templates/docs/governance-auto-repair.md +82 -80
- package/package-source/docs/codex-harness-engineering/templates/docs/harness-architecture.md +78 -78
- package/package-source/docs/codex-harness-engineering/templates/docs/install-manifest-governance.md +16 -16
- package/package-source/docs/codex-harness-engineering/templates/docs/knowledge-architecture.md +241 -219
- package/package-source/docs/codex-harness-engineering/templates/docs/knowledge-import.md +108 -108
- package/package-source/docs/codex-harness-engineering/templates/docs/knowledge-lint.md +98 -98
- package/package-source/docs/codex-harness-engineering/templates/docs/mcp-knowledge-governance.md +24 -0
- package/package-source/docs/codex-harness-engineering/templates/docs/new-project-checklist.md +7 -7
- package/package-source/docs/codex-harness-engineering/templates/docs/new-project-usage.md +107 -43
- package/package-source/docs/codex-harness-engineering/templates/docs/project-agents-template.md +211 -154
- package/package-source/docs/codex-harness-engineering/templates/docs/prompt-knowledge-integration.md +100 -89
- package/package-source/docs/codex-harness-engineering/templates/docs/regression-rules.md +47 -45
- package/package-source/docs/codex-harness-engineering/templates/docs/requirement-prep-kit/README.md +3 -3
- package/package-source/docs/codex-harness-engineering/templates/docs/rule-governance.md +98 -98
- package/package-source/docs/codex-harness-engineering/templates/docs/service-dependency-matrix.md +70 -55
- package/package-source/docs/codex-harness-engineering/templates/docs/task-session-strategy.md +133 -116
- package/package-source/docs/codex-harness-engineering/templates/docs/team-knowledge-sync.md +187 -187
- package/package-source/docs/codex-harness-engineering/templates/docs/trace-format.md +44 -32
- package/package-source/docs/codex-harness-engineering/templates/governance/AGENTS.md +18 -0
- package/package-source/docs/codex-harness-engineering/templates/governance/branch-protection-checklist.md +50 -50
- package/package-source/docs/codex-harness-engineering/templates/governance/feedback-evolution-loop.md +55 -55
- package/package-source/docs/codex-harness-engineering/templates/governance/retry-budget.yaml +30 -30
- package/package-source/docs/codex-harness-engineering/templates/governance/risk-levels.yaml +53 -53
- package/package-source/docs/codex-harness-engineering/templates/governance/sandbox-policy.md +13 -13
- package/package-source/docs/codex-harness-engineering/templates/hooks/AGENTS.md +15 -0
- package/package-source/docs/codex-harness-engineering/templates/hooks/hook-stop-verify.ps1 +171 -118
- package/package-source/docs/codex-harness-engineering/templates/hooks/hooks.json +40 -40
- package/package-source/docs/codex-harness-engineering/templates/knowledge/AGENTS.md +16 -0
- package/package-source/docs/codex-harness-engineering/templates/knowledge/catalog.md +6 -6
- package/package-source/docs/codex-harness-engineering/templates/knowledge/decisions/DECISION-HARNESS-001.md +39 -39
- package/package-source/docs/codex-harness-engineering/templates/knowledge/guidelines/GUIDELINE-RULES-001.md +30 -30
- package/package-source/docs/codex-harness-engineering/templates/knowledge/knowledge-catalog.md +41 -41
- package/package-source/docs/codex-harness-engineering/templates/package-assets/.specify/templates/plan-template.md +252 -252
- package/package-source/docs/codex-harness-engineering/templates/package-assets/.specify/templates/spec-template.md +145 -145
- package/package-source/docs/codex-harness-engineering/templates/package-assets/.specify/templates/tasks-template.md +47 -47
- package/package-source/docs/codex-harness-engineering/templates/package-assets/AGENTS.md +19 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/AGENTS.md +25 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/README.md +118 -42
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/START-HERE.md +66 -53
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/agent-ecosystem-practices.md +140 -140
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/best-practices.md +9 -9
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/codex-global-rules-example.md +48 -48
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/AGENTS.md +14 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/goal-templates.md +380 -380
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/AGENTS.md +14 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/README.md +64 -64
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/contracts/openapi.yaml +25 -25
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/contracts/orval.config.ts +20 -20
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/packages/ui/TicketFilterBar.tsx +72 -72
- 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
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/progress.txt +1 -1
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/stories/TicketFilterBar.stories.tsx +33 -33
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/task.json +54 -54
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/verify.ps1 +42 -42
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/global-rules-and-bootstrap.md +157 -157
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/goal-harness-integration-guide.md +364 -364
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/implementation-flow.md +7 -5
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/implementation-guide.md +25 -25
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/knowledge-surface-map.md +186 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/mode-matrix.md +57 -57
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/new-project-usage.md +176 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/project-agents-template.md +168 -154
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/superpowers-codex-solo-builder-playbook.md +676 -676
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/AGENTS.md +22 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/context/AGENTS.md +14 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/context/API_MAP.md +18 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/context/CURRENT_TASK.md +89 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/context/dev-plan.md +166 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/contracts/AGENTS.md +14 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/contracts/README.md +24 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/contracts/prism-usage.md +41 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/AGENTS.md +14 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/component-map.md +45 -31
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/design-brief.md +183 -178
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/design-tokens.json +88 -88
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/frontend-architecture.md +164 -146
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/image-to-frontend-spec.md +64 -52
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/screen-states.md +157 -122
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/visual-parity-review.md +21 -21
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/docs/AGENTS.md +14 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/docs/env-and-deployment-template.md +60 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/docs/frontend-quality-rules.md +161 -138
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/docs/regression-rules.md +47 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/docs/trace-format.md +86 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/product/AGENTS.md +14 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/product/prd-lite.md +166 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/product/state-matrix.yaml +116 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/prompts/AGENTS.md +14 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/prompts/implement-one-task.md +150 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/prompts/repair-one-finding.md +70 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/spec/11-security-design.md +43 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/spec/AGENTS.md +14 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/testing/AGENTS.md +14 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/testing/EVIDENCE_PROTOCOL.md +54 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/testing/NATURAL_LANGUAGE_TEST_CASES.md +690 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/testing/REGRESSION_PLAN.md +28 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/testing/TEST_STRATEGY.md +98 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/testing/TRACEABILITY_MATRIX.md +23 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/testing/verify-matrix.md +51 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/README.md +10 -10
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/e2e.md +30 -30
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/README.md +60 -60
- 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
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/app/catalog.md +33 -33
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/architecture.md +358 -358
- 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
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/common/catalog.md +34 -34
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/initial-content.md +296 -296
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/integration-roadmap.md +221 -221
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/architecture-constraints.md +95 -83
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/code-semantics-and-navigation.md +17 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/code-style-and-naming.md +116 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/frontend-quality-rules.md +138 -138
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/governance-auto-repair.md +82 -80
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/mcp-knowledge-governance.md +24 -0
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/service-dependency-matrix.md +55 -55
- package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/speckit-requirements-gate.md +124 -124
- package/package-source/docs/codex-harness-engineering/templates/package-assets/root/PACKAGE.md +7 -7
- package/package-source/docs/codex-harness-engineering/templates/package-assets/root/README.md +52 -52
- package/package-source/docs/codex-harness-engineering/templates/package-assets/root/install-agent-here.ps1 +57 -57
- package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/agents.md +115 -115
- package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/coding-style.md +57 -74
- package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/constitution.md +4 -4
- package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/git.rules +41 -41
- package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/harness.rules +29 -29
- package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/safety.rules +35 -35
- package/package-source/docs/codex-harness-engineering/templates/package-assets/scripts/ai-workflow/check-ai-sync-drift.ps1 +205 -205
- package/package-source/docs/codex-harness-engineering/templates/package-assets/scripts/ai-workflow/sync-ai-config-to-targets.ps1 +826 -826
- package/package-source/docs/codex-harness-engineering/templates/package-assets/scripts/ai-workflow/sync-targets.example.json +35 -35
- package/package-source/docs/codex-harness-engineering/templates/package-assets/scripts/harness/harness-governance-check.ps1 +864 -366
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/HOW_TO_USE_SKILLS.md +79 -79
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/academic-mermaid-diagrams/SKILL.md +172 -172
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/ai-config-git-sync/SKILL.md +152 -152
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/ai-config-git-sync/references/command-recipes.md +92 -92
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/auto-commit/SKILL.md +324 -322
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/better-icons/SKILL.md +3 -3
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/claude-openrouter-clash-debug/SKILL.md +100 -100
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/claude-openrouter-clash-debug/references/windows-openrouter-clash-playbook.md +94 -94
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/claude-openrouter-clash-debug/scripts/diagnose-openrouter-route.ps1 +282 -282
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/claude-openrouter-clash-debug/scripts/ensure-openrouter-rule.ps1 +101 -101
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/fixing-metadata/SKILL.md +6 -6
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/frontend-design/SKILL.md +37 -37
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/git-xianyu-analyzer/SKILL.md +3 -3
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/harness-surface-sync/SKILL.md +204 -188
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/harness-surface-sync/references/current-repo-sync-matrix.md +150 -110
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/harness-surface-sync/references/stale-patterns.md +65 -65
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/init-autopilot/SKILL.md +17 -15
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/log-analysis-optimization/SKILL.md +5 -5
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/prd-writer-skill/SKILL.md +28 -28
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/qa-e2e-planner/SKILL.md +11 -11
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/qa-e2e-runner/SKILL.md +6 -6
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/qa-mock-cleaner/SKILL.md +4 -4
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/qoder-codex-api-config/SKILL.md +67 -67
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/qoder-codex-api-config/agents/openai.yaml +7 -7
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/qoder-codex-api-config/scripts/configure-qoder-codex-api.ps1 +278 -278
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/requirements-design-template/SKILL.md +87 -87
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/skills-index.md +12 -12
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-analyze/SKILL.md +34 -34
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-checklist/SKILL.md +8 -8
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-clarify/SKILL.md +28 -28
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-e2e-tasks/SKILL.md +12 -12
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-implement/SKILL.md +37 -37
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-plan/SKILL.md +140 -138
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-specify/SKILL.md +100 -100
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-tasks/SKILL.md +86 -86
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-verify/SKILL.md +144 -142
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/sync-project-root-docs/SKILL.md +145 -143
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/sync-project-root-docs/references/current-repo-notes.md +42 -41
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/sync-project-root-docs/references/github-samples.md +33 -33
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/sync-project-root-docs/scripts/collect-root-doc-facts.ps1 +174 -145
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/thesis-writing/references/ai-integrity-and-originality.md +191 -191
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/thesis-writing/references/citation-templates.md +99 -99
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/thesis-writing/references/final-checklist.md +60 -60
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/thesis-writing/references/photographer-booking-paper.md +85 -85
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/thesis-writing/references/test-result-templates.md +22 -22
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/thesis-writing/references/thesis-analysis-template.md +63 -63
- package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/update-codemaps/SKILL.md +31 -31
- package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/README.md +15 -15
- package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.analyze.md +60 -60
- package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.checklist.md +8 -8
- package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.clarify.md +28 -28
- package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.e2e-testing.md +10 -10
- package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.implement.md +56 -56
- package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.plan.md +137 -134
- package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.specify.md +100 -100
- package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.tasks.md +86 -86
- package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.verify.md +130 -130
- package/package-source/docs/codex-harness-engineering/templates/product/AGENTS.md +19 -0
- package/package-source/docs/codex-harness-engineering/templates/product/acceptance-criteria.md +47 -47
- package/package-source/docs/codex-harness-engineering/templates/product/difficulty-research.md +47 -47
- package/package-source/docs/codex-harness-engineering/templates/product/page-inventory.md +21 -21
- package/package-source/docs/codex-harness-engineering/templates/product/prd-lite.md +166 -158
- package/package-source/docs/codex-harness-engineering/templates/product/requirement-interface-matrix.md +37 -37
- package/package-source/docs/codex-harness-engineering/templates/product/state-matrix.yaml +116 -105
- package/package-source/docs/codex-harness-engineering/templates/prompts/AGENTS.md +15 -0
- package/package-source/docs/codex-harness-engineering/templates/prompts/controller-loop.md +88 -88
- package/package-source/docs/codex-harness-engineering/templates/prompts/failure-triage.md +71 -69
- package/package-source/docs/codex-harness-engineering/templates/prompts/harness-audit.md +54 -52
- package/package-source/docs/codex-harness-engineering/templates/prompts/implement-one-task.md +150 -148
- package/package-source/docs/codex-harness-engineering/templates/prompts/repair-one-finding.md +70 -67
- package/package-source/docs/codex-harness-engineering/templates/prompts/review-one-task.md +45 -43
- package/package-source/docs/codex-harness-engineering/templates/prompts/review-stage1-spec.md +111 -109
- package/package-source/docs/codex-harness-engineering/templates/prompts/review-stage2-quality.md +82 -80
- package/package-source/docs/codex-harness-engineering/templates/prompts/visual-evaluator.md +80 -78
- package/package-source/docs/codex-harness-engineering/templates/prompts/worker-role/backend-worker.md +41 -41
- package/package-source/docs/codex-harness-engineering/templates/prompts/worker-role/docs-worker.md +28 -28
- package/package-source/docs/codex-harness-engineering/templates/prompts/worker-role/frontend-worker.md +46 -46
- package/package-source/docs/codex-harness-engineering/templates/prompts/worker-role/harness-writer.md +40 -40
- package/package-source/docs/codex-harness-engineering/templates/prompts/worker-role/test-runner.md +27 -27
- package/package-source/docs/codex-harness-engineering/templates/runtime/AGENTS.md +66 -50
- package/package-source/docs/codex-harness-engineering/templates/runtime/codex-loop.ps1 +2129 -231
- package/package-source/docs/codex-harness-engineering/templates/runtime/doctor.ps1 +224 -224
- package/package-source/docs/codex-harness-engineering/templates/runtime/project-task-template.json +42 -39
- package/package-source/docs/codex-harness-engineering/templates/runtime/scripts/test-install-modes.ps1 +2 -2
- package/package-source/docs/codex-harness-engineering/templates/runtime/smoke-task.json +52 -52
- package/package-source/docs/codex-harness-engineering/templates/runtime/task-run-profile.json +86 -86
- package/package-source/docs/codex-harness-engineering/templates/runtime/task.json +11 -8
- package/package-source/docs/codex-harness-engineering/templates/runtime/verify.ps1 +21 -21
- package/package-source/docs/codex-harness-engineering/templates/scripts/AGENTS.md +15 -0
- package/package-source/docs/codex-harness-engineering/templates/scripts/ai-workflow/check-ai-sync-drift.ps1 +205 -205
- package/package-source/docs/codex-harness-engineering/templates/scripts/harness/harness-governance-check.ps1 +864 -366
- package/package-source/docs/codex-harness-engineering/templates/spec/10-data-model.md +23 -7
- package/package-source/docs/codex-harness-engineering/templates/spec/11-security-design.md +30 -13
- package/package-source/docs/codex-harness-engineering/templates/spec/AGENTS.md +15 -0
- package/package-source/docs/codex-harness-engineering/templates/testing/ACCEPTANCE_CRITERIA.md +39 -39
- package/package-source/docs/codex-harness-engineering/templates/testing/ACCEPTANCE_EXAMPLES.md +37 -37
- package/package-source/docs/codex-harness-engineering/templates/testing/AGENTS.md +19 -0
- package/package-source/docs/codex-harness-engineering/templates/testing/EVIDENCE_PROTOCOL.md +54 -48
- package/package-source/docs/codex-harness-engineering/templates/testing/NATURAL_LANGUAGE_TEST_CASES.md +5 -4
- package/package-source/docs/codex-harness-engineering/templates/testing/REGRESSION_PLAN.md +28 -20
- package/package-source/docs/codex-harness-engineering/templates/testing/RISK_BASED_TEST_PLAN.md +16 -16
- package/package-source/docs/codex-harness-engineering/templates/testing/TEST_STRATEGY.md +98 -97
- package/package-source/docs/codex-harness-engineering/templates/testing/TRACEABILITY_MATRIX.md +6 -5
- package/package-source/docs/codex-harness-engineering/templates/testing/coverage-policy.md +25 -25
- package/package-source/docs/codex-harness-engineering/templates/testing/e2e-plan.md +139 -139
- package/package-source/docs/codex-harness-engineering/templates/testing/failure-findings.example.json +3 -3
- package/package-source/docs/codex-harness-engineering/templates/testing/failure-triage.md +62 -62
- package/package-source/docs/codex-harness-engineering/templates/testing/test-data-plan.md +36 -36
- package/package-source/docs/codex-harness-engineering/templates/testing/test-report.md +85 -41
- package/package-source/docs/codex-harness-engineering/templates/testing/verify-matrix.md +15 -5
- package/package-source/docs/codex-harness-engineering/templates/tools/AGENTS.md +14 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/acceptance-lint.ps1 +37 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/architecture-lint.ps1 +150 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/backend-lint.ps1 +137 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/business-lint.ps1 +148 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/component-lint.ps1 +148 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/config-lint.ps1 +159 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/context-lint.ps1 +187 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/contract-lint.ps1 +148 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/data-lint.ps1 +37 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/directory-lint.ps1 +152 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/docs-lint.ps1 +40 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/impact-lint.ps1 +148 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/integration-lint.ps1 +37 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/mobile-lint.ps1 +37 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/observability-lint.ps1 +137 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/performance-lint.ps1 +148 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/refactor-lint.ps1 +137 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/security-lint.ps1 +159 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/session-lint.ps1 +126 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/spec-lint.ps1 +285 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/state-lint.ps1 +137 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/style-lint.ps1 +155 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/testing-lint.ps1 +192 -0
- package/package-source/docs/codex-harness-engineering/templates/tools/harness/ui-lint.ps1 +148 -0
- package/package-source/docs/codex-harness-engineering/templates/trace/AGENTS.md +16 -0
- package/package-source/docs/codex-harness-engineering/templates/trace/eval-case.yaml +24 -24
- package/package-source/docs/codex-harness-engineering/templates/trace/trace.schema.json +101 -101
- package/package-source/install-manifest.json +149 -79
- package/package-source/tools/install/ai-workflow/check-ai-sync-drift.ps1 +205 -205
- package/package-source/tools/install/ai-workflow/sync-ai-config-to-targets.ps1 +826 -826
- package/package-source/tools/install/ai-workflow/sync-targets.example.json +35 -35
- package/package-source/tools/install/bootstrap-codex-harness.ps1 +145 -129
- package/package-source/tools/install/env-check.ps1 +40 -40
- package/package-source/tools/install/init-project.ps1 +1 -1
- package/package-source/tools/install/install-agent-here.ps1 +57 -57
- package/package-source/tools/install/install-agent.ps1 +33 -31
- package/package.json +23 -23
|
@@ -1,82 +1,82 @@
|
|
|
1
|
-
# Skills 使用指南
|
|
2
|
-
|
|
3
|
-
## Skill 已加载
|
|
4
|
-
|
|
5
|
-
当前项目的 skill package 位于:`.agents/skills/`
|
|
6
|
-
|
|
7
|
-
当前目录约定:
|
|
8
|
-
|
|
9
|
-
- `.agents/skills/`:active skill package
|
|
10
|
-
- `.agents/workflows/`:独立 workflow 文档
|
|
11
|
-
- `.agents/archive/workflows/skill-mirrors/`:已归档的 workflow 镜像副本
|
|
12
|
-
|
|
13
|
-
## 如何使用Skill
|
|
14
|
-
|
|
15
|
-
### 1. 自动识别
|
|
16
|
-
AI会根据任务需求自动判断并使用相关skill:
|
|
17
|
-
- 任务描述中包含skill相关的关键词
|
|
18
|
-
- AI判断某个skill适用于当前任务
|
|
19
|
-
|
|
20
|
-
### 2. 明确指定
|
|
21
|
-
您可以直接要求使用某个skill:
|
|
22
|
-
```
|
|
23
|
-
"使用 example-skill 来处理这个任务"
|
|
24
|
-
"按照 example-skill 的步骤执行"
|
|
25
|
-
"使用 harness-surface-sync 检查并同步 harness 流程"
|
|
26
|
-
"用 harness-surface-sync 扫一遍 testing-left-shift 文档和镜像"
|
|
27
|
-
"使用 auto-commit 检查当前改动、补齐同步并提交推送"
|
|
28
|
-
"用 auto-commit,如果没有 GitHub 仓库就用 gh 创建后再推送"
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
### 3. 浏览可用 Skills
|
|
32
|
-
查看所有可用的skills:
|
|
33
|
-
```
|
|
34
|
-
"显示所有可用的skills"
|
|
35
|
-
"列出项目中的skills"
|
|
36
|
-
```
|
|
37
|
-
|
|
38
|
-
## 当前可用的Skills
|
|
39
|
-
|
|
40
|
-
### Harness Surface Sync
|
|
41
|
-
- **位置**: `.agents/skills/harness-surface-sync/`
|
|
42
|
-
- **说明**: 一次性检查并同步 harness runtime、docs/testing、templates、workflows、config、package-assets 和 skills 镜像
|
|
43
|
-
- **适用场景**:
|
|
44
|
-
- 规则、prompt、task 模板或 testing-left-shift 真相源刚改过
|
|
45
|
-
- 需要继续扫旧流程表述并补齐镜像同步
|
|
46
|
-
- 需要把新的 repo-local skill 一并打进 package-assets
|
|
47
|
-
|
|
48
|
-
### Auto Review and Commit
|
|
49
|
-
- **位置**: `.agents/skills/auto-commit/`
|
|
50
|
-
- **说明**: 一次性检查当前工作区、补齐必要同步、生成提交并推送;如果没有远程仓库,默认用 GitHub CLI 创建私有仓库
|
|
51
|
-
- **适用场景**:
|
|
52
|
-
- 当前改动已经完成,准备收尾提交
|
|
53
|
-
- 当前仓库有 `.agents` / `agent` / `templates` / `package-assets` 镜像,需要提交前补齐同步
|
|
54
|
-
- 当前本地仓库还没有 `origin`,希望直接建 GitHub 仓库再推送
|
|
55
|
-
|
|
56
|
-
### AI Config Git Sync
|
|
57
|
-
- **位置**: `.agents/skills/ai-config-git-sync/`
|
|
58
|
-
- **说明**: 维护共享 AI workflow/config 到多个 Git 项目的同步链路,支持读状态、写配置、建同步分支、push 和开 PR
|
|
59
|
-
- **适用场景**:
|
|
60
|
-
- 需要更新 `.ai-sync.yml`、`sync-targets.json` 或多项目同步脚本
|
|
61
|
-
- 需要把 root AI 配置改动 fan-out 到多个项目仓库
|
|
62
|
-
- 需要检查 drift、manifest、lock 或同步分支/PR 状态
|
|
63
|
-
|
|
64
|
-
### Example Skill
|
|
65
|
-
- **位置**: `.agents/skills/example-skill/`
|
|
66
|
-
- **说明**: 一个示例技能,展示如何创建和使用技能文件
|
|
67
|
-
- **包含**:
|
|
68
|
-
- SKILL.md: 主文档
|
|
69
|
-
- scripts/: 辅助脚本
|
|
70
|
-
- examples/: 使用示例
|
|
71
|
-
- resources/: 配置模板
|
|
72
|
-
|
|
73
|
-
## Skill开发
|
|
74
|
-
|
|
75
|
-
创建新的skill:
|
|
76
|
-
1. 在 `.agents/skills/` 下创建新文件夹
|
|
77
|
-
2. 在文件夹中创建 `SKILL.md` 文件
|
|
78
|
-
3. 添加YAML frontmatter和详细说明
|
|
79
|
-
4. (可选)添加scripts、examples、resources等目录
|
|
1
|
+
# Skills 使用指南
|
|
2
|
+
|
|
3
|
+
## Skill 已加载
|
|
4
|
+
|
|
5
|
+
当前项目的 skill package 位于:`.agents/skills/`
|
|
6
|
+
|
|
7
|
+
当前目录约定:
|
|
8
|
+
|
|
9
|
+
- `.agents/skills/`:active skill package
|
|
10
|
+
- `.agents/workflows/`:独立 workflow 文档
|
|
11
|
+
- `.agents/archive/workflows/skill-mirrors/`:已归档的 workflow 镜像副本
|
|
12
|
+
|
|
13
|
+
## 如何使用Skill
|
|
14
|
+
|
|
15
|
+
### 1. 自动识别
|
|
16
|
+
AI会根据任务需求自动判断并使用相关skill:
|
|
17
|
+
- 任务描述中包含skill相关的关键词
|
|
18
|
+
- AI判断某个skill适用于当前任务
|
|
19
|
+
|
|
20
|
+
### 2. 明确指定
|
|
21
|
+
您可以直接要求使用某个skill:
|
|
22
|
+
```
|
|
23
|
+
"使用 example-skill 来处理这个任务"
|
|
24
|
+
"按照 example-skill 的步骤执行"
|
|
25
|
+
"使用 harness-surface-sync 检查并同步 harness 流程"
|
|
26
|
+
"用 harness-surface-sync 扫一遍 testing-left-shift 文档和镜像"
|
|
27
|
+
"使用 auto-commit 检查当前改动、补齐同步并提交推送"
|
|
28
|
+
"用 auto-commit,如果没有 GitHub 仓库就用 gh 创建后再推送"
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
### 3. 浏览可用 Skills
|
|
32
|
+
查看所有可用的skills:
|
|
33
|
+
```
|
|
34
|
+
"显示所有可用的skills"
|
|
35
|
+
"列出项目中的skills"
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
## 当前可用的Skills
|
|
39
|
+
|
|
40
|
+
### Harness Surface Sync
|
|
41
|
+
- **位置**: `.agents/skills/harness-surface-sync/`
|
|
42
|
+
- **说明**: 一次性检查并同步 harness runtime、docs/testing、templates、workflows、config、package-assets 和 skills 镜像
|
|
43
|
+
- **适用场景**:
|
|
44
|
+
- 规则、prompt、task 模板或 testing-left-shift 真相源刚改过
|
|
45
|
+
- 需要继续扫旧流程表述并补齐镜像同步
|
|
46
|
+
- 需要把新的 repo-local skill 一并打进 package-assets
|
|
47
|
+
|
|
48
|
+
### Auto Review and Commit
|
|
49
|
+
- **位置**: `.agents/skills/auto-commit/`
|
|
50
|
+
- **说明**: 一次性检查当前工作区、补齐必要同步、生成提交并推送;如果没有远程仓库,默认用 GitHub CLI 创建私有仓库
|
|
51
|
+
- **适用场景**:
|
|
52
|
+
- 当前改动已经完成,准备收尾提交
|
|
53
|
+
- 当前仓库有 `.agents` / `agent` / `templates` / `package-assets` 镜像,需要提交前补齐同步
|
|
54
|
+
- 当前本地仓库还没有 `origin`,希望直接建 GitHub 仓库再推送
|
|
55
|
+
|
|
56
|
+
### AI Config Git Sync
|
|
57
|
+
- **位置**: `.agents/skills/ai-config-git-sync/`
|
|
58
|
+
- **说明**: 维护共享 AI workflow/config 到多个 Git 项目的同步链路,支持读状态、写配置、建同步分支、push 和开 PR
|
|
59
|
+
- **适用场景**:
|
|
60
|
+
- 需要更新 `.ai-sync.yml`、`sync-targets.json` 或多项目同步脚本
|
|
61
|
+
- 需要把 root AI 配置改动 fan-out 到多个项目仓库
|
|
62
|
+
- 需要检查 drift、manifest、lock 或同步分支/PR 状态
|
|
63
|
+
|
|
64
|
+
### Example Skill
|
|
65
|
+
- **位置**: `.agents/skills/example-skill/`
|
|
66
|
+
- **说明**: 一个示例技能,展示如何创建和使用技能文件
|
|
67
|
+
- **包含**:
|
|
68
|
+
- SKILL.md: 主文档
|
|
69
|
+
- scripts/: 辅助脚本
|
|
70
|
+
- examples/: 使用示例
|
|
71
|
+
- resources/: 配置模板
|
|
72
|
+
|
|
73
|
+
## Skill开发
|
|
74
|
+
|
|
75
|
+
创建新的skill:
|
|
76
|
+
1. 在 `.agents/skills/` 下创建新文件夹
|
|
77
|
+
2. 在文件夹中创建 `SKILL.md` 文件
|
|
78
|
+
3. 添加YAML frontmatter和详细说明
|
|
79
|
+
4. (可选)添加scripts、examples、resources等目录
|
|
80
80
|
|
|
81
81
|
## 系统级Skills
|
|
82
82
|
|
|
@@ -1,172 +1,172 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: academic-mermaid-diagrams
|
|
3
|
-
description: 学术规范的 Mermaid 渲染与图表生成指南。用于生成符合学术论文标准的架构图、时序图、ER 图等,具有清晰层次、标准符号和黑白黑白极简配色的特点。
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# 学术化 Mermaid 图形生成指南
|
|
7
|
-
|
|
8
|
-
> 本工作流/技能指南规定了如何使用 Mermaid 代码生成符合严格学术论文要求的高质量、专业化机制图与架构图,彻底替代复杂的手工图像编辑过程。
|
|
9
|
-
|
|
10
|
-
## 触发场景
|
|
11
|
-
- 当用户要求在技术文档、开题报告、毕业设计或学术论文中补充插图时。
|
|
12
|
-
- 当系统需要生成清晰严谨的“系统总体架构图”、“业务时序图”、“ER实体关系图”、“状态机生命周期图”时。
|
|
13
|
-
- 当现有的系统图显得过于随意(带有鲜艳主题色、排版混乱、标注不清)而需要转为学术格式时。
|
|
14
|
-
|
|
15
|
-
---
|
|
16
|
-
|
|
17
|
-
## 核心设计规范与约束
|
|
18
|
-
|
|
19
|
-
符合学术标准的 Mermaid 图表**必须**严格遵守以下 5 项特征:
|
|
20
|
-
|
|
21
|
-
### 1. 黑白配色,简洁专业
|
|
22
|
-
- **禁止**使用 Mermaid 默认的蓝/黄/绿鲜艳配色。
|
|
23
|
-
- **配置注入**:必须在图首行注入 `%%{init: {'theme': 'base'... }}%%` 指令,强制图表为白底、黑边框、黑字、黑线、可选的极简浅灰底色。
|
|
24
|
-
|
|
25
|
-
### 2. 清晰的层次分隔(虚线分隔各层)
|
|
26
|
-
- 使用 `subgraph` 划分逻辑层次(如:展示层、业务层、数据层)。
|
|
27
|
-
- 辅以 `classDef stroke-dasharray` 将分层包裹框修改为规范的**虚线框**,避免包裹框抢夺主体模块的视觉焦点。
|
|
28
|
-
|
|
29
|
-
### 3. 标准化图形符号
|
|
30
|
-
- **模块/组件**:使用标准的矩形 `[组件名称]` 或圆角矩形 `(组件名称)`。
|
|
31
|
-
- **数据源/存储媒介**:强制使用学术通用的圆柱体符号 `[(数据库名称)]` 标识持久化层。
|
|
32
|
-
- **网关/网关节点**:菱形或平滑多边形。
|
|
33
|
-
|
|
34
|
-
### 4. 规范的箭头连接
|
|
35
|
-
- 数据/控制流动:统一采用标准实线的黑侧单向箭头 `-->`。
|
|
36
|
-
- 异步消息/弱依赖/缓存击穿:使用虚线箭头 `-.->`。
|
|
37
|
-
- 避免箭头飞线交叉,必要时通过增加隐式排版节点或控制树的深入方向(`graph TD` 俯视或 `graph LR` 平视)进行梳理。
|
|
38
|
-
|
|
39
|
-
### 5. 层次标签明确标注
|
|
40
|
-
- 每个层次(子图)的左上/中上部必须有明确功能定位的标注,如 `[表现层 presentation layer]`。
|
|
41
|
-
- 模块名应直指系统功能或组件专名,杜绝无意义的代称。
|
|
42
|
-
|
|
43
|
-
---
|
|
44
|
-
|
|
45
|
-
## 学术级图表实战模板库
|
|
46
|
-
|
|
47
|
-
在响应用户“生成一篇符合论文要求的图(如架构图)”的请求时,应当直接套用或变体下方模板生成代码。
|
|
48
|
-
|
|
49
|
-
### 模板 A:分层架构拓扑图 (系统总体架构)
|
|
50
|
-
|
|
51
|
-
典型的四层结构架构视图,实现了规范的虚线图层框与黑白学术风:
|
|
52
|
-
|
|
53
|
-
```mermaid
|
|
54
|
-
%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#ffffff', 'primaryBorderColor': '#000000', 'primaryTextColor': '#000000', 'lineColor': '#000000', 'clusterBkg': 'none', 'clusterBorder': '#333333'}}}%%
|
|
55
|
-
graph TD
|
|
56
|
-
classDef layerBox fill:none,stroke:#333,stroke-dasharray: 5 5,stroke-width:1.5px;
|
|
57
|
-
classDef standardBox fill:#fff,stroke:#000,stroke-width:1px;
|
|
58
|
-
classDef db fill:#fff,stroke:#000,stroke-width:1px;
|
|
59
|
-
|
|
60
|
-
subgraph Layer_Presentation [前端展示层]
|
|
61
|
-
Web[Web 管理后台]:::standardBox
|
|
62
|
-
App[移动端客户端]:::standardBox
|
|
63
|
-
end
|
|
64
|
-
|
|
65
|
-
subgraph Layer_Business [后端业务处理层]
|
|
66
|
-
Gateway[API 路由网关]:::standardBox
|
|
67
|
-
subgraph Core_Modules [核心服务集群]
|
|
68
|
-
AuthSvc[安全认证服务]:::standardBox
|
|
69
|
-
OrderSvc[订单流转服务]:::standardBox
|
|
70
|
-
RuleSvc[业务规则引擎]:::standardBox
|
|
71
|
-
end
|
|
72
|
-
end
|
|
73
|
-
|
|
74
|
-
subgraph Layer_Data [数据存储层]
|
|
75
|
-
DB[(MySQL 业务主库)]:::db
|
|
76
|
-
Redis[(Redis 缓存/锁)]:::db
|
|
77
|
-
end
|
|
78
|
-
|
|
79
|
-
Web --> Gateway
|
|
80
|
-
App --> Gateway
|
|
81
|
-
Gateway --> AuthSvc
|
|
82
|
-
AuthSvc --> OrderSvc
|
|
83
|
-
AuthSvc --> RuleSvc
|
|
84
|
-
|
|
85
|
-
OrderSvc --> DB
|
|
86
|
-
OrderSvc -.-> Redis
|
|
87
|
-
|
|
88
|
-
%% 应用层边界虚线样式
|
|
89
|
-
class Layer_Presentation,Layer_Business,Layer_Data layerBox;
|
|
90
|
-
class Core_Modules layerBox;
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
### 模板 B:E-R 数据实体关系图
|
|
94
|
-
|
|
95
|
-
学术 E-R 图更侧重关系基数与实体属性。学术版需要强制白底黑字。
|
|
96
|
-
|
|
97
|
-
```mermaid
|
|
98
|
-
%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#fff', 'primaryBorderColor': '#000', 'lineColor': '#000', 'textColor': '#000'}}}%%
|
|
99
|
-
erDiagram
|
|
100
|
-
USERS ||--o{ ORDERS : "1:N (发起)"
|
|
101
|
-
PHOTOGRAPHERS ||--o{ ORDERS : "1:N (承接)"
|
|
102
|
-
ORDERS ||--|| PAYMENTS : "1:1"
|
|
103
|
-
|
|
104
|
-
USERS {
|
|
105
|
-
BigInt user_id PK "用户主键"
|
|
106
|
-
String email UK "邮箱"
|
|
107
|
-
}
|
|
108
|
-
ORDERS {
|
|
109
|
-
BigInt order_id PK "订单主键"
|
|
110
|
-
Int status "生命周期状态"
|
|
111
|
-
}
|
|
112
|
-
PAYMENTS {
|
|
113
|
-
BigInt pay_id PK "流水号"
|
|
114
|
-
Decimal amount "数额"
|
|
115
|
-
}
|
|
116
|
-
```
|
|
117
|
-
|
|
118
|
-
### 模板 C:系统级生命周期状态图 (状态机)
|
|
119
|
-
|
|
120
|
-
用于表现严格的状态转换,在“流转引擎”、“事务处理状态闭环”类论文章节必备。
|
|
121
|
-
|
|
122
|
-
```mermaid
|
|
123
|
-
%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#fff', 'primaryBorderColor': '#000', 'lineColor': '#000', 'textColor': '#000'}}}%%
|
|
124
|
-
stateDiagram-v2
|
|
125
|
-
classDef stateNode fill:#fff,stroke:#000,stroke-width:1px;
|
|
126
|
-
|
|
127
|
-
[*] --> 待审核 : 提交发布
|
|
128
|
-
待审核 --> 已生效 : 人工审核通过
|
|
129
|
-
待审核 --> 驳回 : 人工审核拒绝
|
|
130
|
-
|
|
131
|
-
已生效 --> [*] : 服务结束/停用
|
|
132
|
-
驳回 --> [*] : 废弃
|
|
133
|
-
```
|
|
134
|
-
|
|
135
|
-
### 模板 D:规范预约时序图 (序列交互图)
|
|
136
|
-
|
|
137
|
-
用于描述涉及三方组件、微服务内部、或者核心交易机制的同步/异步过程交互。
|
|
138
|
-
|
|
139
|
-
```mermaid
|
|
140
|
-
%%{init: {'theme': 'base', 'themeVariables': { 'actorBkg': '#fff', 'actorBorder': '#000', 'actorTextColor': '#000', 'signalColor': '#000', 'signalTextColor': '#000', 'noteBkg': '#f9f9f9', 'noteBorder': '#000'}}}%%
|
|
141
|
-
sequenceDiagram
|
|
142
|
-
autonumber
|
|
143
|
-
participant Client as 客户端界面
|
|
144
|
-
participant API as 后端聚合服务
|
|
145
|
-
participant DB as MySQL持久层
|
|
146
|
-
participant Remote as 外部支付平台
|
|
147
|
-
|
|
148
|
-
Client->>API: 1. 发起订单支付请求
|
|
149
|
-
activate API
|
|
150
|
-
API->>DB: 2. 校验订单并发隔离锁
|
|
151
|
-
DB-->>API: 3. 约束校验通过
|
|
152
|
-
API->>Remote: 4. 调用三方支付网关接口
|
|
153
|
-
|
|
154
|
-
rect rgb(245, 245, 245)
|
|
155
|
-
note right of Remote: 【关键网关节点】异步验签
|
|
156
|
-
Remote-->>API: 5. 返回支付凭证(Token)
|
|
157
|
-
end
|
|
158
|
-
|
|
159
|
-
API-->>Client: 6. 重定向至安全支付页
|
|
160
|
-
deactivate API
|
|
161
|
-
```
|
|
162
|
-
|
|
163
|
-
## AI 执行要求
|
|
164
|
-
在应用此 Skill 时,AI 需要执行以下动作:
|
|
165
|
-
1. **抓取原始述求**:仔细提取用户代码或文字中提炼模块(前、后、数据等)、实体关系或调用路径。
|
|
166
|
-
2. **选择渲染图格式**:根据描述类型,判定属于组件图结构(graph TD) 还是 控制流 (sequence/state)。
|
|
167
|
-
3. **强制混入 CSS 层**:把 `%%{init: ...}%%` 学术模板投喂到代码的最前沿。
|
|
168
|
-
4. **验证符合论文 5 准则**:检查 `[]` (实体), `[()]` (DB圆柱), `虚线`, `单色视觉` 分离呈现状况后再进行输出。
|
|
169
|
-
5. **强制全态 AI 生图策略 (PNG 生成)**:在用户明确要求使用 `generate_image` 工具直接生成带有实际文字内容的图表时,请遵循以下最新策略,绝对不允许退避并生成“无字纯几何图形”:
|
|
170
|
-
- **提取凝练文本短词**:由于模型在渲染复杂长句容易发生文字错乱,构思提示词时,必须将模块名称进行最精简凝练(支持提供中文字符,必要时加上简短精准的英文辅助),如把“订单状态生命周期”精简为“订单流转(Order State)”。
|
|
171
|
-
- **强硬注入文本指令**:提示词中必须直接且强硬地规定:“图内的核心方框或节点上,必须要端正地渲染写出下列文字,绝不能省略或留白”。
|
|
172
|
-
- **放宽容错与多次试错**:系统理解模型写字时可能会有瑕疵或拼写失误,但必须迎难而上。为了获得更好效果,允许且推荐在同一次需求中运用工具并行**多次声成**(提供多样化候选给用户选择),从而选出文本更清晰准确、排版最具论文范儿的一张图。
|
|
1
|
+
---
|
|
2
|
+
name: academic-mermaid-diagrams
|
|
3
|
+
description: 学术规范的 Mermaid 渲染与图表生成指南。用于生成符合学术论文标准的架构图、时序图、ER 图等,具有清晰层次、标准符号和黑白黑白极简配色的特点。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# 学术化 Mermaid 图形生成指南
|
|
7
|
+
|
|
8
|
+
> 本工作流/技能指南规定了如何使用 Mermaid 代码生成符合严格学术论文要求的高质量、专业化机制图与架构图,彻底替代复杂的手工图像编辑过程。
|
|
9
|
+
|
|
10
|
+
## 触发场景
|
|
11
|
+
- 当用户要求在技术文档、开题报告、毕业设计或学术论文中补充插图时。
|
|
12
|
+
- 当系统需要生成清晰严谨的“系统总体架构图”、“业务时序图”、“ER实体关系图”、“状态机生命周期图”时。
|
|
13
|
+
- 当现有的系统图显得过于随意(带有鲜艳主题色、排版混乱、标注不清)而需要转为学术格式时。
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## 核心设计规范与约束
|
|
18
|
+
|
|
19
|
+
符合学术标准的 Mermaid 图表**必须**严格遵守以下 5 项特征:
|
|
20
|
+
|
|
21
|
+
### 1. 黑白配色,简洁专业
|
|
22
|
+
- **禁止**使用 Mermaid 默认的蓝/黄/绿鲜艳配色。
|
|
23
|
+
- **配置注入**:必须在图首行注入 `%%{init: {'theme': 'base'... }}%%` 指令,强制图表为白底、黑边框、黑字、黑线、可选的极简浅灰底色。
|
|
24
|
+
|
|
25
|
+
### 2. 清晰的层次分隔(虚线分隔各层)
|
|
26
|
+
- 使用 `subgraph` 划分逻辑层次(如:展示层、业务层、数据层)。
|
|
27
|
+
- 辅以 `classDef stroke-dasharray` 将分层包裹框修改为规范的**虚线框**,避免包裹框抢夺主体模块的视觉焦点。
|
|
28
|
+
|
|
29
|
+
### 3. 标准化图形符号
|
|
30
|
+
- **模块/组件**:使用标准的矩形 `[组件名称]` 或圆角矩形 `(组件名称)`。
|
|
31
|
+
- **数据源/存储媒介**:强制使用学术通用的圆柱体符号 `[(数据库名称)]` 标识持久化层。
|
|
32
|
+
- **网关/网关节点**:菱形或平滑多边形。
|
|
33
|
+
|
|
34
|
+
### 4. 规范的箭头连接
|
|
35
|
+
- 数据/控制流动:统一采用标准实线的黑侧单向箭头 `-->`。
|
|
36
|
+
- 异步消息/弱依赖/缓存击穿:使用虚线箭头 `-.->`。
|
|
37
|
+
- 避免箭头飞线交叉,必要时通过增加隐式排版节点或控制树的深入方向(`graph TD` 俯视或 `graph LR` 平视)进行梳理。
|
|
38
|
+
|
|
39
|
+
### 5. 层次标签明确标注
|
|
40
|
+
- 每个层次(子图)的左上/中上部必须有明确功能定位的标注,如 `[表现层 presentation layer]`。
|
|
41
|
+
- 模块名应直指系统功能或组件专名,杜绝无意义的代称。
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## 学术级图表实战模板库
|
|
46
|
+
|
|
47
|
+
在响应用户“生成一篇符合论文要求的图(如架构图)”的请求时,应当直接套用或变体下方模板生成代码。
|
|
48
|
+
|
|
49
|
+
### 模板 A:分层架构拓扑图 (系统总体架构)
|
|
50
|
+
|
|
51
|
+
典型的四层结构架构视图,实现了规范的虚线图层框与黑白学术风:
|
|
52
|
+
|
|
53
|
+
```mermaid
|
|
54
|
+
%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#ffffff', 'primaryBorderColor': '#000000', 'primaryTextColor': '#000000', 'lineColor': '#000000', 'clusterBkg': 'none', 'clusterBorder': '#333333'}}}%%
|
|
55
|
+
graph TD
|
|
56
|
+
classDef layerBox fill:none,stroke:#333,stroke-dasharray: 5 5,stroke-width:1.5px;
|
|
57
|
+
classDef standardBox fill:#fff,stroke:#000,stroke-width:1px;
|
|
58
|
+
classDef db fill:#fff,stroke:#000,stroke-width:1px;
|
|
59
|
+
|
|
60
|
+
subgraph Layer_Presentation [前端展示层]
|
|
61
|
+
Web[Web 管理后台]:::standardBox
|
|
62
|
+
App[移动端客户端]:::standardBox
|
|
63
|
+
end
|
|
64
|
+
|
|
65
|
+
subgraph Layer_Business [后端业务处理层]
|
|
66
|
+
Gateway[API 路由网关]:::standardBox
|
|
67
|
+
subgraph Core_Modules [核心服务集群]
|
|
68
|
+
AuthSvc[安全认证服务]:::standardBox
|
|
69
|
+
OrderSvc[订单流转服务]:::standardBox
|
|
70
|
+
RuleSvc[业务规则引擎]:::standardBox
|
|
71
|
+
end
|
|
72
|
+
end
|
|
73
|
+
|
|
74
|
+
subgraph Layer_Data [数据存储层]
|
|
75
|
+
DB[(MySQL 业务主库)]:::db
|
|
76
|
+
Redis[(Redis 缓存/锁)]:::db
|
|
77
|
+
end
|
|
78
|
+
|
|
79
|
+
Web --> Gateway
|
|
80
|
+
App --> Gateway
|
|
81
|
+
Gateway --> AuthSvc
|
|
82
|
+
AuthSvc --> OrderSvc
|
|
83
|
+
AuthSvc --> RuleSvc
|
|
84
|
+
|
|
85
|
+
OrderSvc --> DB
|
|
86
|
+
OrderSvc -.-> Redis
|
|
87
|
+
|
|
88
|
+
%% 应用层边界虚线样式
|
|
89
|
+
class Layer_Presentation,Layer_Business,Layer_Data layerBox;
|
|
90
|
+
class Core_Modules layerBox;
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
### 模板 B:E-R 数据实体关系图
|
|
94
|
+
|
|
95
|
+
学术 E-R 图更侧重关系基数与实体属性。学术版需要强制白底黑字。
|
|
96
|
+
|
|
97
|
+
```mermaid
|
|
98
|
+
%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#fff', 'primaryBorderColor': '#000', 'lineColor': '#000', 'textColor': '#000'}}}%%
|
|
99
|
+
erDiagram
|
|
100
|
+
USERS ||--o{ ORDERS : "1:N (发起)"
|
|
101
|
+
PHOTOGRAPHERS ||--o{ ORDERS : "1:N (承接)"
|
|
102
|
+
ORDERS ||--|| PAYMENTS : "1:1"
|
|
103
|
+
|
|
104
|
+
USERS {
|
|
105
|
+
BigInt user_id PK "用户主键"
|
|
106
|
+
String email UK "邮箱"
|
|
107
|
+
}
|
|
108
|
+
ORDERS {
|
|
109
|
+
BigInt order_id PK "订单主键"
|
|
110
|
+
Int status "生命周期状态"
|
|
111
|
+
}
|
|
112
|
+
PAYMENTS {
|
|
113
|
+
BigInt pay_id PK "流水号"
|
|
114
|
+
Decimal amount "数额"
|
|
115
|
+
}
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
### 模板 C:系统级生命周期状态图 (状态机)
|
|
119
|
+
|
|
120
|
+
用于表现严格的状态转换,在“流转引擎”、“事务处理状态闭环”类论文章节必备。
|
|
121
|
+
|
|
122
|
+
```mermaid
|
|
123
|
+
%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#fff', 'primaryBorderColor': '#000', 'lineColor': '#000', 'textColor': '#000'}}}%%
|
|
124
|
+
stateDiagram-v2
|
|
125
|
+
classDef stateNode fill:#fff,stroke:#000,stroke-width:1px;
|
|
126
|
+
|
|
127
|
+
[*] --> 待审核 : 提交发布
|
|
128
|
+
待审核 --> 已生效 : 人工审核通过
|
|
129
|
+
待审核 --> 驳回 : 人工审核拒绝
|
|
130
|
+
|
|
131
|
+
已生效 --> [*] : 服务结束/停用
|
|
132
|
+
驳回 --> [*] : 废弃
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
### 模板 D:规范预约时序图 (序列交互图)
|
|
136
|
+
|
|
137
|
+
用于描述涉及三方组件、微服务内部、或者核心交易机制的同步/异步过程交互。
|
|
138
|
+
|
|
139
|
+
```mermaid
|
|
140
|
+
%%{init: {'theme': 'base', 'themeVariables': { 'actorBkg': '#fff', 'actorBorder': '#000', 'actorTextColor': '#000', 'signalColor': '#000', 'signalTextColor': '#000', 'noteBkg': '#f9f9f9', 'noteBorder': '#000'}}}%%
|
|
141
|
+
sequenceDiagram
|
|
142
|
+
autonumber
|
|
143
|
+
participant Client as 客户端界面
|
|
144
|
+
participant API as 后端聚合服务
|
|
145
|
+
participant DB as MySQL持久层
|
|
146
|
+
participant Remote as 外部支付平台
|
|
147
|
+
|
|
148
|
+
Client->>API: 1. 发起订单支付请求
|
|
149
|
+
activate API
|
|
150
|
+
API->>DB: 2. 校验订单并发隔离锁
|
|
151
|
+
DB-->>API: 3. 约束校验通过
|
|
152
|
+
API->>Remote: 4. 调用三方支付网关接口
|
|
153
|
+
|
|
154
|
+
rect rgb(245, 245, 245)
|
|
155
|
+
note right of Remote: 【关键网关节点】异步验签
|
|
156
|
+
Remote-->>API: 5. 返回支付凭证(Token)
|
|
157
|
+
end
|
|
158
|
+
|
|
159
|
+
API-->>Client: 6. 重定向至安全支付页
|
|
160
|
+
deactivate API
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
## AI 执行要求
|
|
164
|
+
在应用此 Skill 时,AI 需要执行以下动作:
|
|
165
|
+
1. **抓取原始述求**:仔细提取用户代码或文字中提炼模块(前、后、数据等)、实体关系或调用路径。
|
|
166
|
+
2. **选择渲染图格式**:根据描述类型,判定属于组件图结构(graph TD) 还是 控制流 (sequence/state)。
|
|
167
|
+
3. **强制混入 CSS 层**:把 `%%{init: ...}%%` 学术模板投喂到代码的最前沿。
|
|
168
|
+
4. **验证符合论文 5 准则**:检查 `[]` (实体), `[()]` (DB圆柱), `虚线`, `单色视觉` 分离呈现状况后再进行输出。
|
|
169
|
+
5. **强制全态 AI 生图策略 (PNG 生成)**:在用户明确要求使用 `generate_image` 工具直接生成带有实际文字内容的图表时,请遵循以下最新策略,绝对不允许退避并生成“无字纯几何图形”:
|
|
170
|
+
- **提取凝练文本短词**:由于模型在渲染复杂长句容易发生文字错乱,构思提示词时,必须将模块名称进行最精简凝练(支持提供中文字符,必要时加上简短精准的英文辅助),如把“订单状态生命周期”精简为“订单流转(Order State)”。
|
|
171
|
+
- **强硬注入文本指令**:提示词中必须直接且强硬地规定:“图内的核心方框或节点上,必须要端正地渲染写出下列文字,绝不能省略或留白”。
|
|
172
|
+
- **放宽容错与多次试错**:系统理解模型写字时可能会有瑕疵或拼写失误,但必须迎难而上。为了获得更好效果,允许且推荐在同一次需求中运用工具并行**多次声成**(提供多样化候选给用户选择),从而选出文本更清晰准确、排版最具论文范儿的一张图。
|