universal-dev-standards 5.16.0 → 6.0.0
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/bin/uds.js +13 -135
- package/bundled/ai/standards/acceptance-criteria-traceability.ai.yaml +13 -4
- package/bundled/ai/standards/accessibility-standards.ai.yaml +1 -1
- package/bundled/ai/standards/ai-response-navigation.ai.yaml +15 -2
- package/bundled/ai/standards/api-design-standards.ai.yaml +27 -4
- package/bundled/ai/standards/behavior-snapshot.ai.yaml +86 -9
- package/bundled/ai/standards/checkin-standards.ai.yaml +2 -2
- package/bundled/ai/standards/code-review.ai.yaml +2 -2
- package/bundled/ai/standards/context-aware-loading.ai.yaml +3 -3
- package/bundled/ai/standards/data-migration-testing.ai.yaml +79 -3
- package/bundled/ai/standards/deprecation-standards.ai.yaml +10 -2
- package/bundled/ai/standards/developer-memory.ai.yaml +4 -3
- package/bundled/ai/standards/flow-based-testing.ai.yaml +2 -2
- package/bundled/ai/standards/forward-derivation-standards.ai.yaml +26 -2
- package/bundled/ai/standards/full-coverage-testing.ai.yaml +34 -2
- package/bundled/ai/standards/git-worktree.ai.yaml +3 -3
- package/bundled/ai/standards/logging.ai.yaml +97 -3
- package/bundled/ai/standards/mock-boundary.ai.yaml +48 -2
- package/bundled/ai/standards/model-provenance.ai.yaml +297 -0
- package/bundled/ai/standards/model-selection.ai.yaml +11 -2
- package/bundled/ai/standards/observability-standards.ai.yaml +10 -0
- package/bundled/ai/standards/performance-standards.ai.yaml +46 -1
- package/bundled/ai/standards/pii-classification.ai.yaml +15 -1
- package/bundled/ai/standards/pipeline-security-gates.ai.yaml +10 -0
- package/bundled/ai/standards/privacy-standards.ai.yaml +2 -2
- package/bundled/ai/standards/project-context-memory.ai.yaml +2 -2
- package/bundled/ai/standards/refactoring-standards.ai.yaml +68 -3
- package/bundled/ai/standards/resource-cost-boundary.ai.yaml +279 -0
- package/bundled/ai/standards/reverse-engineering-standards.ai.yaml +55 -2
- package/bundled/ai/standards/security-testing.ai.yaml +13 -2
- package/bundled/ai/standards/skill-standard-alignment-check.ai.yaml +37 -2
- package/bundled/ai/standards/user-journey-testing.ai.yaml +107 -0
- package/bundled/ai/standards/verification-oracle.ai.yaml +278 -0
- package/bundled/ai/standards/versioning.ai.yaml +32 -38
- package/bundled/core/acceptance-criteria-traceability.md +15 -5
- package/bundled/core/accessibility-standards.md +8 -4
- package/bundled/core/ai-friendly-architecture.md +1 -1
- package/bundled/core/ai-response-navigation.md +31 -3
- package/bundled/core/anti-sycophancy-prompting.md +1 -1
- package/bundled/core/api-design-standards.md +92 -7
- package/bundled/core/audit-trail.md +119 -0
- package/bundled/core/behavior-snapshot.md +94 -7
- package/bundled/core/browser-compatibility-standards.md +15 -2
- package/bundled/core/checkin-standards.md +9 -2
- package/bundled/core/code-review-checklist.md +10 -2
- package/bundled/core/container-image-standards.md +97 -0
- package/bundled/core/context-aware-loading.md +2 -2
- package/bundled/core/cost-budget-test.md +1 -1
- package/bundled/core/cross-flow-regression.md +3 -2
- package/bundled/core/data-contract.md +104 -0
- package/bundled/core/data-migration-testing.md +90 -0
- package/bundled/core/data-pipeline.md +113 -0
- package/bundled/core/deprecation-standards.md +16 -2
- package/bundled/core/developer-memory.md +13 -8
- package/bundled/core/documentation-writing-standards.md +1 -1
- package/bundled/core/error-code-standards.md +4 -3
- package/bundled/core/flaky-test-management.md +1 -1
- package/bundled/core/flow-based-testing.md +3 -3
- package/bundled/core/forward-derivation-standards.md +33 -5
- package/bundled/core/full-coverage-testing.md +72 -0
- package/bundled/core/git-worktree.md +4 -4
- package/bundled/core/guides/performance-guide.md +1 -1
- package/bundled/core/guides/security-guide.md +1 -1
- package/bundled/core/health-check-standards.md +2 -2
- package/bundled/core/iac-design-principles.md +97 -0
- package/bundled/core/incident-response.md +119 -0
- package/bundled/core/license-compliance.md +2 -0
- package/bundled/core/logging-standards.md +78 -2
- package/bundled/core/mock-boundary.md +54 -2
- package/bundled/core/model-provenance.md +181 -0
- package/bundled/core/model-selection.md +27 -2
- package/bundled/core/packaging-standards.md +1 -0
- package/bundled/core/performance-standards.md +96 -2
- package/bundled/core/pii-classification.md +148 -0
- package/bundled/core/pipeline-security-gates.md +22 -2
- package/bundled/core/postmortem-standards.md +2 -0
- package/bundled/core/prd-standards.md +91 -0
- package/bundled/core/privacy-standards.md +14 -3
- package/bundled/core/product-metrics-standards.md +100 -0
- package/bundled/core/project-context-memory.md +8 -2
- package/bundled/core/prompt-regression.md +1 -1
- package/bundled/core/refactoring-standards.md +44 -3
- package/bundled/core/replay-test.md +1 -1
- package/bundled/core/resource-cost-boundary.md +180 -0
- package/bundled/core/reverse-engineering-standards.md +66 -2
- package/bundled/core/runbook.md +113 -0
- package/bundled/core/schema-evolution.md +105 -0
- package/bundled/core/secret-management-standards.md +110 -0
- package/bundled/core/security-testing.md +26 -2
- package/bundled/core/self-review-protocol.md +2 -2
- package/bundled/core/skill-standard-alignment-check.md +53 -0
- package/bundled/core/slo-sli.md +109 -0
- package/bundled/core/smoke-test.md +1 -1
- package/bundled/core/spec-driven-development.md +21 -3
- package/bundled/core/tech-debt-standards.md +1 -1
- package/bundled/core/test-data-standards.md +2 -2
- package/bundled/core/user-journey-testing.md +102 -0
- package/bundled/core/user-story-mapping.md +96 -0
- package/bundled/core/verification-oracle.md +167 -0
- package/bundled/core/versioning.md +133 -109
- package/bundled/locales/COVERAGE.md +84 -73
- package/bundled/locales/zh-CN/CHANGELOG.md +81 -6
- package/bundled/locales/zh-CN/CLAUDE.md +1 -1
- package/bundled/locales/zh-CN/README.md +22 -9
- package/bundled/locales/zh-CN/SECURITY.md +1 -1
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -2
- package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +4 -6
- package/bundled/locales/zh-CN/core/accessibility-standards.md +1 -1
- package/bundled/locales/zh-CN/core/adversarial-test.md +226 -0
- package/bundled/locales/zh-CN/core/agent-behavior-discipline.md +187 -0
- package/bundled/locales/zh-CN/core/ai-response-navigation.md +32 -6
- package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +1 -1
- package/bundled/locales/zh-CN/core/api-design-standards.md +1 -1
- package/bundled/locales/zh-CN/core/behavior-snapshot.md +335 -0
- package/bundled/locales/zh-CN/core/browser-compatibility-standards.md +229 -0
- package/bundled/locales/zh-CN/core/cd-deployment-strategies.md +135 -0
- package/bundled/locales/zh-CN/core/chaos-injection-tests.md +130 -0
- package/bundled/locales/zh-CN/core/checkin-standards.md +1 -1
- package/bundled/locales/zh-CN/core/code-review-checklist.md +1 -1
- package/bundled/locales/zh-CN/core/container-security.md +535 -0
- package/bundled/locales/zh-CN/core/context-aware-loading.md +1 -1
- package/bundled/locales/zh-CN/core/contract-testing-standards.md +191 -0
- package/bundled/locales/zh-CN/core/cost-budget-test.md +86 -0
- package/bundled/locales/zh-CN/core/cross-flow-regression.md +199 -0
- package/bundled/locales/zh-CN/core/data-migration-testing.md +217 -0
- package/bundled/locales/zh-CN/core/deployment-standards.md +328 -9
- package/bundled/locales/zh-CN/core/deprecation-standards.md +1 -1
- package/bundled/locales/zh-CN/core/developer-memory.md +2 -2
- package/bundled/locales/zh-CN/core/disaster-recovery-drill.md +87 -0
- package/bundled/locales/zh-CN/core/documentation-structure.md +1 -1
- package/bundled/locales/zh-CN/core/documentation-writing-standards.md +1 -1
- package/bundled/locales/zh-CN/core/error-code-standards.md +2 -2
- package/bundled/locales/zh-CN/core/feature-manifest-standard.md +222 -0
- package/bundled/locales/zh-CN/core/flaky-test-management.md +87 -0
- package/bundled/locales/zh-CN/core/flow-based-testing.md +284 -0
- package/bundled/locales/zh-CN/core/forward-derivation-standards.md +3 -4
- package/bundled/locales/zh-CN/core/full-coverage-testing.md +197 -0
- package/bundled/locales/zh-CN/core/git-worktree.md +1 -1
- package/bundled/locales/zh-CN/core/governance-layer.md +160 -0
- package/bundled/locales/zh-CN/core/guides/performance-guide.md +515 -0
- package/bundled/locales/zh-CN/core/guides/security-guide.md +494 -0
- package/bundled/locales/zh-CN/core/knowledge-graph-memory.md +128 -0
- package/bundled/locales/zh-CN/core/license-compliance.md +129 -0
- package/bundled/locales/zh-CN/core/llm-output-validation.md +192 -0
- package/bundled/locales/zh-CN/core/logging-standards.md +130 -8
- package/bundled/locales/zh-CN/core/mock-boundary.md +109 -0
- package/bundled/locales/zh-CN/core/model-selection.md +28 -5
- package/bundled/locales/zh-CN/core/mutation-testing.md +106 -0
- package/bundled/locales/zh-CN/core/no-cicd-deployment.md +219 -0
- package/bundled/locales/zh-CN/core/packaging-standards.md +76 -5
- package/bundled/locales/zh-CN/core/pipeline-security-gates.md +126 -0
- package/bundled/locales/zh-CN/core/policy-as-code-testing.md +203 -0
- package/bundled/locales/zh-CN/core/privacy-standards.md +1 -1
- package/bundled/locales/zh-CN/core/project-context-memory.md +1 -1
- package/bundled/locales/zh-CN/core/prompt-regression.md +88 -0
- package/bundled/locales/zh-CN/core/property-based-testing.md +87 -0
- package/bundled/locales/zh-CN/core/release-quality-manifest.md +207 -0
- package/bundled/locales/zh-CN/core/release-readiness-gate.md +193 -0
- package/bundled/locales/zh-CN/core/replay-test.md +102 -0
- package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +46 -1
- package/bundled/locales/zh-CN/core/rollback-standards.md +120 -0
- package/bundled/locales/zh-CN/core/sast-advanced.md +309 -0
- package/bundled/locales/zh-CN/core/secure-op.md +328 -0
- package/bundled/locales/zh-CN/core/security-testing.md +96 -0
- package/bundled/locales/zh-CN/core/self-review-protocol.md +167 -0
- package/bundled/locales/zh-CN/core/server-ops-security.md +507 -0
- package/bundled/locales/zh-CN/core/smoke-test.md +79 -0
- package/bundled/locales/zh-CN/core/spec-driven-development.md +55 -5
- package/bundled/locales/zh-CN/core/supply-chain-attestation.md +131 -0
- package/bundled/locales/zh-CN/core/versioning.md +1 -1
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +31 -6
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +61 -34
- package/bundled/locales/zh-CN/docs/MIGRATION-v6.md +88 -0
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +2 -2
- package/bundled/locales/zh-CN/docs/USER-MANUAL.md +14 -14
- package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +105 -0
- package/bundled/locales/zh-CN/docs/user/FAQ.md +132 -0
- package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +144 -0
- package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +178 -0
- package/bundled/locales/zh-CN/docs/user/README.md +70 -0
- package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +190 -0
- package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +1 -1
- package/bundled/locales/zh-CN/integrations/github-copilot/README.md +1 -1
- package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +3 -3
- package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +3 -3
- package/bundled/locales/zh-CN/methodologies/guides/sdd-guide.md +836 -0
- package/bundled/locales/zh-CN/options/changelog/auto-generated.md +166 -0
- package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +140 -0
- package/bundled/locales/zh-CN/options/code-review/automated-review.md +214 -0
- package/bundled/locales/zh-CN/options/code-review/pair-programming.md +166 -0
- package/bundled/locales/zh-CN/options/code-review/pr-review.md +167 -0
- package/bundled/locales/zh-CN/options/documentation/api-docs.md +191 -0
- package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +150 -0
- package/bundled/locales/zh-CN/options/documentation/wiki-style.md +131 -0
- package/bundled/locales/zh-CN/options/project-structure/kotlin.md +144 -0
- package/bundled/locales/zh-CN/options/project-structure/php.md +168 -0
- package/bundled/locales/zh-CN/options/project-structure/ruby.md +156 -0
- package/bundled/locales/zh-CN/options/project-structure/rust.md +136 -0
- package/bundled/locales/zh-CN/options/project-structure/swift.md +165 -0
- package/bundled/locales/zh-CN/options/testing/contract-testing.md +237 -0
- package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +200 -0
- package/bundled/locales/zh-CN/options/testing/istqb-framework.md +144 -0
- package/bundled/locales/zh-CN/options/testing/performance-testing.md +251 -0
- package/bundled/locales/zh-CN/options/testing/security-testing.md +192 -0
- package/bundled/locales/zh-CN/skills/README.md +89 -126
- package/bundled/locales/zh-CN/skills/ac-coverage/SKILL.md +5 -7
- package/bundled/locales/zh-CN/skills/adr-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/agents/code-architect.md +263 -0
- package/bundled/locales/zh-CN/skills/agents/doc-writer.md +410 -0
- package/bundled/locales/zh-CN/skills/agents/reviewer.md +357 -0
- package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +410 -0
- package/bundled/locales/zh-CN/skills/agents/test-specialist.md +368 -0
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +1 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +3 -4
- package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +1 -2
- package/bundled/locales/zh-CN/skills/brainstorm-assistant/SKILL.md +109 -13
- package/bundled/locales/zh-CN/skills/brainstorm-assistant/guide.md +30 -8
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +50 -0
- package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +5 -5
- package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +1 -1
- package/bundled/locales/zh-CN/skills/commands/atdd.md +3 -3
- package/bundled/locales/zh-CN/skills/commands/bdd.md +2 -2
- package/bundled/locales/zh-CN/skills/commands/brainstorm.md +26 -17
- package/bundled/locales/zh-CN/skills/commands/{review.md → code-review.md} +4 -4
- package/bundled/locales/zh-CN/skills/commands/derive-all.md +1 -1
- package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +1 -1
- package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +2 -3
- package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +1 -1
- package/bundled/locales/zh-CN/skills/commands/derive.md +1 -1
- package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +2 -2
- package/bundled/locales/zh-CN/skills/commands/methodology.md +4 -4
- package/bundled/locales/zh-CN/skills/commands/pr.md +1 -1
- package/bundled/locales/zh-CN/skills/commands/tdd.md +1 -1
- package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +456 -0
- package/bundled/locales/zh-CN/skills/dev-methodology/guide.md +6 -6
- package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +296 -0
- package/bundled/locales/zh-CN/skills/dev-workflow-guide/SKILL.md +5 -5
- package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/journey-test-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/logging-guide/SKILL.md +146 -142
- package/bundled/locales/zh-CN/skills/migration-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/observability-assistant/guide.md +1 -1
- package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/project-discovery/guide.md +2 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/runbook-assistant/guide.md +1 -1
- package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/skill-builder/SKILL.md +3 -3
- package/bundled/locales/zh-CN/skills/slo-assistant/guide.md +1 -1
- package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/spec-derivation/guide.md +8 -9
- package/bundled/locales/zh-CN/skills/spec-driven-dev/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/sweep/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/testing-guide/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +2298 -0
- package/bundled/locales/zh-CN/skills/workflows/README.md +451 -0
- package/bundled/locales/zh-TW/CHANGELOG.md +81 -6
- package/bundled/locales/zh-TW/CLAUDE.md +1 -1
- package/bundled/locales/zh-TW/MAINTENANCE.md +25 -2
- package/bundled/locales/zh-TW/README.md +22 -9
- package/bundled/locales/zh-TW/SECURITY.md +1 -1
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -2
- package/bundled/locales/zh-TW/ai/standards/versioning.ai.yaml +8 -48
- package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +4 -6
- package/bundled/locales/zh-TW/core/accessibility-standards.md +1 -1
- package/bundled/locales/zh-TW/core/adversarial-test.md +226 -0
- package/bundled/locales/zh-TW/core/agent-behavior-discipline.md +187 -0
- package/bundled/locales/zh-TW/core/ai-response-navigation.md +32 -6
- package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +1 -1
- package/bundled/locales/zh-TW/core/api-design-standards.md +91 -9
- package/bundled/locales/zh-TW/core/audit-trail.md +110 -0
- package/bundled/locales/zh-TW/core/behavior-snapshot.md +335 -0
- package/bundled/locales/zh-TW/core/browser-compatibility-standards.md +1 -0
- package/bundled/locales/zh-TW/core/cd-deployment-strategies.md +135 -0
- package/bundled/locales/zh-TW/core/chaos-injection-tests.md +130 -0
- package/bundled/locales/zh-TW/core/checkin-standards.md +1 -1
- package/bundled/locales/zh-TW/core/code-review-checklist.md +1 -1
- package/bundled/locales/zh-TW/core/container-image-standards.md +93 -0
- package/bundled/locales/zh-TW/core/container-security.md +535 -0
- package/bundled/locales/zh-TW/core/cost-budget-test.md +86 -0
- package/bundled/locales/zh-TW/core/cross-flow-regression.md +1 -0
- package/bundled/locales/zh-TW/core/data-contract.md +101 -0
- package/bundled/locales/zh-TW/core/data-migration-testing.md +217 -0
- package/bundled/locales/zh-TW/core/data-pipeline.md +105 -0
- package/bundled/locales/zh-TW/core/deployment-standards.md +363 -25
- package/bundled/locales/zh-TW/core/deprecation-standards.md +17 -4
- package/bundled/locales/zh-TW/core/developer-memory.md +2 -2
- package/bundled/locales/zh-TW/core/disaster-recovery-drill.md +87 -0
- package/bundled/locales/zh-TW/core/documentation-writing-standards.md +1 -1
- package/bundled/locales/zh-TW/core/error-code-standards.md +2 -2
- package/bundled/locales/zh-TW/core/feature-manifest-standard.md +222 -0
- package/bundled/locales/zh-TW/core/flaky-test-management.md +87 -0
- package/bundled/locales/zh-TW/core/flow-based-testing.md +284 -0
- package/bundled/locales/zh-TW/core/forward-derivation-standards.md +3 -4
- package/bundled/locales/zh-TW/core/full-coverage-testing.md +250 -0
- package/bundled/locales/zh-TW/core/git-worktree.md +1 -1
- package/bundled/locales/zh-TW/core/guides/performance-guide.md +515 -0
- package/bundled/locales/zh-TW/core/guides/security-guide.md +494 -0
- package/bundled/locales/zh-TW/core/iac-design-principles.md +90 -0
- package/bundled/locales/zh-TW/core/incident-response.md +111 -0
- package/bundled/locales/zh-TW/core/license-compliance.md +129 -0
- package/bundled/locales/zh-TW/core/llm-output-validation.md +192 -0
- package/bundled/locales/zh-TW/core/logging-standards.md +208 -4
- package/bundled/locales/zh-TW/core/mock-boundary.md +161 -0
- package/bundled/locales/zh-TW/core/model-provenance.md +173 -0
- package/bundled/locales/zh-TW/core/model-selection.md +28 -5
- package/bundled/locales/zh-TW/core/mutation-testing.md +106 -0
- package/bundled/locales/zh-TW/core/no-cicd-deployment.md +219 -0
- package/bundled/locales/zh-TW/core/packaging-standards.md +76 -5
- package/bundled/locales/zh-TW/core/performance-standards.md +84 -5
- package/bundled/locales/zh-TW/core/pii-classification.md +102 -0
- package/bundled/locales/zh-TW/core/pipeline-security-gates.md +126 -0
- package/bundled/locales/zh-TW/core/policy-as-code-testing.md +203 -0
- package/bundled/locales/zh-TW/core/prd-standards.md +88 -0
- package/bundled/locales/zh-TW/core/privacy-standards.md +1 -1
- package/bundled/locales/zh-TW/core/product-metrics-standards.md +96 -0
- package/bundled/locales/zh-TW/core/project-context-memory.md +1 -1
- package/bundled/locales/zh-TW/core/prompt-regression.md +88 -0
- package/bundled/locales/zh-TW/core/property-based-testing.md +87 -0
- package/bundled/locales/zh-TW/core/refactoring-standards.md +43 -6
- package/bundled/locales/zh-TW/core/release-quality-manifest.md +207 -0
- package/bundled/locales/zh-TW/core/replay-test.md +102 -0
- package/bundled/locales/zh-TW/core/resource-cost-boundary.md +175 -0
- package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +64 -5
- package/bundled/locales/zh-TW/core/rollback-standards.md +120 -0
- package/bundled/locales/zh-TW/core/runbook.md +110 -0
- package/bundled/locales/zh-TW/core/sast-advanced.md +309 -0
- package/bundled/locales/zh-TW/core/schema-evolution.md +98 -0
- package/bundled/locales/zh-TW/core/secret-management-standards.md +101 -0
- package/bundled/locales/zh-TW/core/secure-op.md +328 -0
- package/bundled/locales/zh-TW/core/security-testing.md +96 -0
- package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -2
- package/bundled/locales/zh-TW/core/server-ops-security.md +507 -0
- package/bundled/locales/zh-TW/core/slo-sli.md +108 -0
- package/bundled/locales/zh-TW/core/smoke-test.md +79 -0
- package/bundled/locales/zh-TW/core/spec-driven-development.md +39 -13
- package/bundled/locales/zh-TW/core/supply-chain-attestation.md +131 -0
- package/bundled/locales/zh-TW/core/user-journey-testing.md +111 -0
- package/bundled/locales/zh-TW/core/user-story-mapping.md +94 -0
- package/bundled/locales/zh-TW/core/verification-oracle.md +159 -0
- package/bundled/locales/zh-TW/core/versioning.md +112 -112
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +31 -6
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +6 -6
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +61 -34
- package/bundled/locales/zh-TW/docs/MIGRATION-v6.md +88 -0
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -2
- package/bundled/locales/zh-TW/docs/USER-MANUAL.md +14 -14
- package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +105 -0
- package/bundled/locales/zh-TW/docs/user/FAQ.md +132 -0
- package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +144 -0
- package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +178 -0
- package/bundled/locales/zh-TW/docs/user/README.md +70 -0
- package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +190 -0
- package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +1 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/README.md +1 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +3 -3
- package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +3 -3
- package/bundled/locales/zh-TW/methodologies/guides/sdd-guide.md +523 -26
- package/bundled/locales/zh-TW/options/changelog/auto-generated.md +166 -0
- package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +140 -0
- package/bundled/locales/zh-TW/options/code-review/automated-review.md +214 -0
- package/bundled/locales/zh-TW/options/code-review/pair-programming.md +166 -0
- package/bundled/locales/zh-TW/options/code-review/pr-review.md +167 -0
- package/bundled/locales/zh-TW/options/documentation/api-docs.md +191 -0
- package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +150 -0
- package/bundled/locales/zh-TW/options/documentation/wiki-style.md +131 -0
- package/bundled/locales/zh-TW/options/project-structure/kotlin.md +144 -0
- package/bundled/locales/zh-TW/options/project-structure/php.md +168 -0
- package/bundled/locales/zh-TW/options/project-structure/ruby.md +156 -0
- package/bundled/locales/zh-TW/options/project-structure/rust.md +136 -0
- package/bundled/locales/zh-TW/options/project-structure/swift.md +165 -0
- package/bundled/locales/zh-TW/options/testing/contract-testing.md +237 -0
- package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +200 -0
- package/bundled/locales/zh-TW/options/testing/istqb-framework.md +144 -0
- package/bundled/locales/zh-TW/options/testing/performance-testing.md +251 -0
- package/bundled/locales/zh-TW/options/testing/security-testing.md +192 -0
- package/bundled/locales/zh-TW/skills/README.md +91 -128
- package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +4 -6
- package/bundled/locales/zh-TW/skills/adr-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/agents/code-architect.md +263 -0
- package/bundled/locales/zh-TW/skills/agents/doc-writer.md +410 -0
- package/bundled/locales/zh-TW/skills/agents/reviewer.md +357 -0
- package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +410 -0
- package/bundled/locales/zh-TW/skills/agents/test-specialist.md +368 -0
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +2 -0
- package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +1 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +3 -4
- package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +2 -0
- package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +1 -2
- package/bundled/locales/zh-TW/skills/brainstorm-assistant/SKILL.md +110 -14
- package/bundled/locales/zh-TW/skills/brainstorm-assistant/guide.md +31 -7
- package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +3 -1
- package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +50 -0
- package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +7 -5
- package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +1 -1
- package/bundled/locales/zh-TW/skills/commands/atdd.md +3 -3
- package/bundled/locales/zh-TW/skills/commands/bdd.md +2 -2
- package/bundled/locales/zh-TW/skills/commands/brainstorm.md +26 -17
- package/bundled/locales/zh-TW/skills/commands/{review.md → code-review.md} +5 -5
- package/bundled/locales/zh-TW/skills/commands/derive-all.md +1 -1
- package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +1 -1
- package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +2 -3
- package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +1 -1
- package/bundled/locales/zh-TW/skills/commands/derive.md +1 -1
- package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +2 -2
- package/bundled/locales/zh-TW/skills/commands/methodology.md +4 -4
- package/bundled/locales/zh-TW/skills/commands/pr.md +1 -1
- package/bundled/locales/zh-TW/skills/commands/tdd.md +1 -1
- package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +456 -0
- package/bundled/locales/zh-TW/skills/dev-methodology/guide.md +5 -5
- package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +296 -0
- package/bundled/locales/zh-TW/skills/dev-workflow-guide/SKILL.md +5 -5
- package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/logging-guide/SKILL.md +29 -27
- package/bundled/locales/zh-TW/skills/migration-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +3 -1
- package/bundled/locales/zh-TW/skills/project-discovery/guide.md +2 -2
- package/bundled/locales/zh-TW/skills/reverse-engineer/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/spec-derivation/guide.md +7 -8
- package/bundled/locales/zh-TW/skills/spec-driven-dev/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/sweep/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +3 -1
- package/bundled/locales/zh-TW/skills/testing-guide/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +2298 -0
- package/bundled/locales/zh-TW/skills/workflows/README.md +451 -0
- package/bundled/skills/README.md +1 -1
- package/bundled/skills/ac-coverage/SKILL.md +17 -7
- package/bundled/skills/adr-assistant/SKILL.md +1 -1
- package/bundled/skills/agents/code-architect.md +1 -1
- package/bundled/skills/agents/doc-writer.md +1 -1
- package/bundled/skills/agents/reviewer.md +2 -2
- package/bundled/skills/agents/spec-analyst.md +1 -1
- package/bundled/skills/agents/test-specialist.md +1 -1
- package/bundled/skills/ai-collaboration-standards/SKILL.md +2 -2
- package/bundled/skills/ai-friendly-architecture/SKILL.md +2 -2
- package/bundled/skills/ai-instruction-standards/SKILL.md +1 -1
- package/bundled/skills/atdd-assistant/SKILL.md +7 -0
- package/bundled/skills/atdd-assistant/acceptance-criteria-guide.md +1 -1
- package/bundled/skills/atdd-assistant/atdd-workflow.md +6 -8
- package/bundled/skills/audit-assistant/SKILL.md +2 -2
- package/bundled/skills/bdd-assistant/SKILL.md +7 -0
- package/bundled/skills/bdd-assistant/guide.md +1 -2
- package/bundled/skills/brainstorm-assistant/SKILL.md +133 -11
- package/bundled/skills/brainstorm-assistant/guide.md +33 -5
- package/bundled/skills/checkin-assistant/SKILL.md +8 -1
- package/bundled/skills/ci-cd-assistant/SKILL.md +57 -0
- package/bundled/skills/code-review-assistant/SKILL.md +15 -8
- package/bundled/skills/commands/COMMAND-FAMILY-OVERVIEW.md +2 -2
- package/bundled/skills/commands/COMMAND-INDEX.json +3 -3
- package/bundled/skills/commands/README.md +2 -2
- package/bundled/skills/commands/ac-coverage.md +1 -1
- package/bundled/skills/commands/atdd.md +2 -2
- package/bundled/skills/commands/bdd.md +2 -2
- package/bundled/skills/commands/brainstorm.md +25 -14
- package/bundled/skills/commands/{review.md → code-review.md} +6 -6
- package/bundled/skills/commands/derive-all.md +1 -1
- package/bundled/skills/commands/derive-atdd.md +1 -1
- package/bundled/skills/commands/derive-bdd.md +2 -3
- package/bundled/skills/commands/derive-tdd.md +1 -1
- package/bundled/skills/commands/derive.md +1 -1
- package/bundled/skills/commands/dev-workflow.md +1 -1
- package/bundled/skills/commands/journey-test.md +45 -0
- package/bundled/skills/commands/methodology.md +4 -4
- package/bundled/skills/commands/pr.md +1 -1
- package/bundled/skills/commands/skill-builder.md +42 -0
- package/bundled/skills/commands/tdd.md +1 -1
- package/bundled/skills/dev-methodology/create-methodology.md +1 -1
- package/bundled/skills/dev-methodology/guide.md +1 -1
- package/bundled/skills/dev-methodology/runtime.md +1 -1
- package/bundled/skills/dev-workflow-guide/SKILL.md +3 -3
- package/bundled/skills/dev-workflow-guide/workflow-phases.md +3 -3
- package/bundled/skills/docs-generator/SKILL.md +3 -3
- package/bundled/skills/incident-response-assistant/SKILL.md +2 -2
- package/bundled/skills/logging-guide/SKILL.md +38 -2
- package/bundled/skills/migration-assistant/SKILL.md +226 -0
- package/bundled/skills/observability-assistant/SKILL.md +74 -0
- package/bundled/skills/pr-automation-assistant/SKILL.md +5 -1
- package/bundled/skills/project-discovery/guide.md +2 -2
- package/bundled/skills/push/SKILL.md +1 -1
- package/bundled/skills/release-standards/SKILL.md +19 -5
- package/bundled/skills/security-assistant/SKILL.md +1 -1
- package/bundled/skills/skill-builder/SKILL.md +1 -1
- package/bundled/skills/spec-derivation/guide.md +3 -4
- package/bundled/skills/spec-driven-dev/SKILL.md +27 -0
- package/bundled/skills/sweep/SKILL.md +1 -1
- package/bundled/skills/tdd-assistant/SKILL.md +8 -1
- package/bundled/skills/testing-guide/SKILL.md +1 -1
- package/bundled/skills/testing-guide/testing-theory.md +1 -1
- package/bundled/skills/workflows/README.md +2 -2
- package/package.json +3 -3
- package/src/commands/audit.js +30 -9
- package/src/commands/config.js +33 -2
- package/src/commands/hitl.js +14 -1
- package/src/commands/init.js +110 -58
- package/src/commands/quickstart.js +1 -2
- package/src/commands/release.js +51 -6
- package/src/commands/run-intent.js +9 -0
- package/src/commands/spec-split.js +27 -2
- package/src/commands/update.js +22 -6
- package/src/config/ai-agent-paths.js +3 -1
- package/src/i18n/messages.js +3 -102
- package/src/missions/MissionManager.js +44 -12
- package/src/utils/build-manifest.js +35 -3
- package/src/utils/friction-detector.js +71 -22
- package/src/utils/health-checker.js +29 -2
- package/src/utils/transaction.js +111 -0
- package/src/utils/version-promote.js +16 -0
- package/standards-registry.json +58 -146
- package/bundled/ai/standards/agent-communication-protocol.ai.yaml +0 -42
- package/bundled/ai/standards/agent-dispatch.ai.yaml +0 -42
- package/bundled/ai/standards/branch-completion.ai.yaml +0 -44
- package/bundled/ai/standards/change-batching-standards.ai.yaml +0 -44
- package/bundled/ai/standards/execution-history.ai.yaml +0 -42
- package/bundled/ai/standards/pipeline-integration-standards.ai.yaml +0 -42
- package/bundled/ai/standards/workflow-enforcement.ai.yaml +0 -44
- package/bundled/ai/standards/workflow-state-protocol.ai.yaml +0 -43
- package/src/commands/flow.js +0 -260
- package/src/commands/start.js +0 -372
- package/src/commands/sweep.js +0 -151
- package/src/commands/workflow.js +0 -681
|
@@ -1,85 +1,88 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: logging
|
|
3
3
|
description: |
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
4
|
+
实现结构化日志,包含正确的日志级别和敏感数据处理。
|
|
5
|
+
使用时机:新增日志、调试、设置可观测性。
|
|
6
|
+
关键字:logging, log level, structured logging, observability, 日志, 记录, 结构化日志。
|
|
7
7
|
source: ../../../../skills/logging-guide/SKILL.md
|
|
8
|
-
source_version: 1.
|
|
9
|
-
translation_version: 1.
|
|
10
|
-
last_synced: 2026-
|
|
8
|
+
source_version: 1.1.0
|
|
9
|
+
translation_version: 1.1.0
|
|
10
|
+
last_synced: 2026-06-10
|
|
11
|
+
source_hash: 6b7244c91aa0
|
|
11
12
|
status: current
|
|
12
13
|
---
|
|
13
14
|
|
|
14
|
-
#
|
|
15
|
+
# 日志指南
|
|
15
16
|
|
|
16
17
|
> **语言**: [English](../../../../skills/logging-guide/SKILL.md) | 简体中文
|
|
17
18
|
|
|
18
|
-
**版本**: 1.
|
|
19
|
-
|
|
20
|
-
|
|
19
|
+
**版本**: 1.1.0
|
|
20
|
+
**最后更新**: 2026-05-26
|
|
21
|
+
**适用范围**: Claude Code Skills
|
|
21
22
|
|
|
22
23
|
---
|
|
23
24
|
|
|
25
|
+
> **核心标准**: 本技能实现 [日志标准](../../../../core/logging-standards.md)。如需面向任何 AI 工具的完整方法论文档,请参阅核心标准。
|
|
26
|
+
|
|
24
27
|
## 目的
|
|
25
28
|
|
|
26
|
-
|
|
29
|
+
此技能帮助在所有环境中实现一致、结构化且可操作的应用程序日志。
|
|
27
30
|
|
|
28
|
-
##
|
|
31
|
+
## 快速参考
|
|
29
32
|
|
|
30
|
-
###
|
|
33
|
+
### 日志级别
|
|
31
34
|
|
|
32
|
-
|
|
|
35
|
+
| 级别 | 代码 | 使用时机 | 生产环境 |
|
|
33
36
|
|------|------|----------|----------|
|
|
34
|
-
| **TRACE** | 10 |
|
|
35
|
-
| **DEBUG** | 20 |
|
|
36
|
-
| **INFO** | 30 | 正常操作事件 |
|
|
37
|
-
| **WARN** | 40 |
|
|
38
|
-
| **ERROR** | 50 |
|
|
39
|
-
| **FATAL** | 60 |
|
|
37
|
+
| **TRACE** | 10 | 非常详细的调试信息 | 关闭 |
|
|
38
|
+
| **DEBUG** | 20 | 详细的调试信息 | 关闭 |
|
|
39
|
+
| **INFO** | 30 | 正常操作事件 | 开启 |
|
|
40
|
+
| **WARN** | 40 | 潜在问题,可恢复 | 开启 |
|
|
41
|
+
| **ERROR** | 50 | 需要关注的错误 | 开启 |
|
|
42
|
+
| **FATAL** | 60 | 严重故障 | 开启 |
|
|
40
43
|
|
|
41
|
-
###
|
|
44
|
+
### 级别选择决策树
|
|
42
45
|
|
|
43
46
|
```
|
|
44
|
-
|
|
47
|
+
只用于调试? → DEBUG(生产环境关闭)
|
|
45
48
|
正常操作完成? → INFO
|
|
46
|
-
|
|
49
|
+
意外但没问题的情况? → WARN
|
|
47
50
|
操作失败? → ERROR
|
|
48
|
-
|
|
51
|
+
应用程序无法继续? → FATAL
|
|
49
52
|
```
|
|
50
53
|
|
|
51
|
-
###
|
|
54
|
+
### 各级别使用时机
|
|
52
55
|
|
|
53
|
-
|
|
|
56
|
+
| 级别 | 示例 |
|
|
54
57
|
|------|------|
|
|
55
|
-
| **TRACE** |
|
|
56
|
-
| **DEBUG** |
|
|
57
|
-
| **INFO** |
|
|
58
|
-
| **WARN** |
|
|
59
|
-
| **ERROR** |
|
|
60
|
-
| **FATAL** |
|
|
58
|
+
| **TRACE** | 函数进入/退出、循环迭代、变量值 |
|
|
59
|
+
| **DEBUG** | 状态变更、配置值、查询参数 |
|
|
60
|
+
| **INFO** | 应用启动/关闭、用户操作、定时任务 |
|
|
61
|
+
| **WARN** | 已弃用 API、重试尝试、资源接近上限 |
|
|
62
|
+
| **ERROR** | 失败的操作、捕获的异常、集成失败 |
|
|
63
|
+
| **FATAL** | 无法恢复的错误、启动失败、失去关键资源 |
|
|
61
64
|
|
|
62
|
-
##
|
|
65
|
+
## 结构化日志
|
|
63
66
|
|
|
64
|
-
###
|
|
67
|
+
### 必要字段
|
|
65
68
|
|
|
66
69
|
```json
|
|
67
70
|
{
|
|
68
71
|
"timestamp": "2025-01-15T10:30:00.123Z",
|
|
69
72
|
"level": "INFO",
|
|
70
|
-
"message": "
|
|
73
|
+
"message": "用户登录成功",
|
|
71
74
|
"service": "auth-service",
|
|
72
75
|
"environment": "production"
|
|
73
76
|
}
|
|
74
77
|
```
|
|
75
78
|
|
|
76
|
-
###
|
|
79
|
+
### 推荐字段
|
|
77
80
|
|
|
78
81
|
```json
|
|
79
82
|
{
|
|
80
83
|
"timestamp": "2025-01-15T10:30:00.123Z",
|
|
81
84
|
"level": "INFO",
|
|
82
|
-
"message": "
|
|
85
|
+
"message": "用户登录成功",
|
|
83
86
|
"service": "auth-service",
|
|
84
87
|
"environment": "production",
|
|
85
88
|
"trace_id": "abc123",
|
|
@@ -93,67 +96,67 @@ status: current
|
|
|
93
96
|
}
|
|
94
97
|
```
|
|
95
98
|
|
|
96
|
-
###
|
|
99
|
+
### 字段命名规范
|
|
97
100
|
|
|
98
|
-
使用 `snake_case`
|
|
101
|
+
使用 `snake_case` 并加上领域前缀:
|
|
99
102
|
|
|
100
|
-
|
|
|
103
|
+
| 领域 | 常用字段 |
|
|
101
104
|
|------|----------|
|
|
102
105
|
| HTTP | http_method, http_path, http_status, http_duration_ms |
|
|
103
|
-
|
|
|
104
|
-
|
|
|
105
|
-
|
|
|
106
|
+
| 数据库 | db_query_type, db_table, db_duration_ms, db_rows_affected |
|
|
107
|
+
| 队列 | queue_name, queue_message_id, queue_delay_ms |
|
|
108
|
+
| 用户 | user_id, user_role, user_action |
|
|
106
109
|
| 请求 | request_id, trace_id, span_id |
|
|
107
110
|
|
|
108
111
|
## 详细指南
|
|
109
112
|
|
|
110
|
-
|
|
111
|
-
- [
|
|
113
|
+
完整标准请参考:
|
|
114
|
+
- [日志标准](../../../../core/logging-standards.md)
|
|
112
115
|
|
|
113
|
-
### AI
|
|
116
|
+
### AI 优化格式(节省 Token)
|
|
114
117
|
|
|
115
|
-
AI 助手可使用 YAML
|
|
116
|
-
-
|
|
118
|
+
AI 助手可使用 YAML 格式文件以减少 Token 使用量:
|
|
119
|
+
- 基础标准:`ai/standards/logging.ai.yaml`
|
|
117
120
|
|
|
118
121
|
## 敏感数据处理
|
|
119
122
|
|
|
120
|
-
###
|
|
123
|
+
### 绝不记录
|
|
121
124
|
|
|
122
|
-
-
|
|
123
|
-
- API
|
|
125
|
+
- 密码或密钥
|
|
126
|
+
- API 密钥或令牌
|
|
124
127
|
- 信用卡号码
|
|
125
|
-
-
|
|
126
|
-
-
|
|
128
|
+
- 身份证号码
|
|
129
|
+
- 完整的认证令牌
|
|
127
130
|
|
|
128
|
-
###
|
|
131
|
+
### 脱敏处理
|
|
129
132
|
|
|
130
133
|
```javascript
|
|
131
134
|
// 不好
|
|
132
|
-
logger.info('
|
|
135
|
+
logger.info('登录尝试', { password: userPassword });
|
|
133
136
|
|
|
134
137
|
// 好
|
|
135
|
-
logger.info('
|
|
138
|
+
logger.info('登录尝试', { password: '***已脱敏***' });
|
|
136
139
|
|
|
137
|
-
// 好 -
|
|
138
|
-
logger.info('
|
|
140
|
+
// 好 - 部分脱敏
|
|
141
|
+
logger.info('卡片处理', { last_four: '4242' });
|
|
139
142
|
```
|
|
140
143
|
|
|
141
144
|
### PII 处理
|
|
142
145
|
|
|
143
|
-
-
|
|
144
|
-
-
|
|
145
|
-
-
|
|
146
|
+
- 尽可能记录用户 ID 而非电子邮件
|
|
147
|
+
- 对敏感查询使用哈希标识符
|
|
148
|
+
- 配置数据保留策略
|
|
146
149
|
|
|
147
|
-
##
|
|
150
|
+
## 错误日志
|
|
148
151
|
|
|
149
|
-
###
|
|
152
|
+
### 必要字段
|
|
150
153
|
|
|
151
154
|
```json
|
|
152
155
|
{
|
|
153
156
|
"level": "ERROR",
|
|
154
|
-
"message": "
|
|
157
|
+
"message": "数据库连接失败",
|
|
155
158
|
"error_type": "ConnectionError",
|
|
156
|
-
"error_message": "
|
|
159
|
+
"error_message": "连接被拒绝",
|
|
157
160
|
"error_code": "ECONNREFUSED",
|
|
158
161
|
"stack": "Error: Connection refused\n at connect (/app/db.js:45:11)..."
|
|
159
162
|
}
|
|
@@ -162,10 +165,10 @@ logger.info('卡片已处理', { last_four: '4242' });
|
|
|
162
165
|
### 错误上下文
|
|
163
166
|
|
|
164
167
|
务必包含:
|
|
165
|
-
-
|
|
166
|
-
-
|
|
167
|
-
-
|
|
168
|
-
-
|
|
168
|
+
- 尝试执行的操作是什么
|
|
169
|
+
- 相关标识符(user_id, request_id)
|
|
170
|
+
- 输入参数(已脱敏)
|
|
171
|
+
- 重试次数(如适用)
|
|
169
172
|
|
|
170
173
|
```javascript
|
|
171
174
|
logger.error('处理订单失败', {
|
|
@@ -178,94 +181,127 @@ logger.error('处理订单失败', {
|
|
|
178
181
|
});
|
|
179
182
|
```
|
|
180
183
|
|
|
181
|
-
##
|
|
184
|
+
## 日志格式
|
|
182
185
|
|
|
183
|
-
### JSON
|
|
186
|
+
### JSON 格式(生产环境)
|
|
184
187
|
|
|
185
188
|
```json
|
|
186
189
|
{"timestamp":"2025-01-15T10:30:00.123Z","level":"INFO","message":"请求完成","request_id":"req_123","duration_ms":45}
|
|
187
190
|
```
|
|
188
191
|
|
|
189
|
-
###
|
|
192
|
+
### 人类可读格式(开发环境)
|
|
190
193
|
|
|
191
194
|
```
|
|
192
195
|
2025-01-15T10:30:00.123Z [INFO] 请求完成 request_id=req_123 duration_ms=45
|
|
193
196
|
```
|
|
194
197
|
|
|
195
|
-
##
|
|
198
|
+
## 性能考量
|
|
196
199
|
|
|
197
|
-
###
|
|
200
|
+
### 各环境日志量
|
|
198
201
|
|
|
199
|
-
|
|
|
202
|
+
| 环境 | 级别 | 策略 |
|
|
200
203
|
|------|------|------|
|
|
201
|
-
| 开发 | DEBUG |
|
|
202
|
-
|
|
|
203
|
-
| 生产 | INFO |
|
|
204
|
+
| 开发 | DEBUG | 所有日志 |
|
|
205
|
+
| 预发布 | INFO | 大部分日志 |
|
|
206
|
+
| 生产 | INFO | 高流量端点采样 |
|
|
204
207
|
|
|
205
208
|
### 高流量端点
|
|
206
209
|
|
|
207
|
-
-
|
|
208
|
-
-
|
|
209
|
-
-
|
|
210
|
+
- 使用采样(每 100 条记录 1 条)
|
|
211
|
+
- 聚合指标而非单独日志
|
|
212
|
+
- 使用独立的日志流
|
|
213
|
+
|
|
214
|
+
## 日志文件轮转
|
|
215
|
+
|
|
216
|
+
基于文件的日志接收器**必须**同时设置**两个**轮转触发器——基于时间**和**基于大小。常见库(Serilog 1 GB、log4j/Winston/Python `RotatingFileHandler` 无上限)的默认大小上限会导致生产环境中的静默数据丢失。
|
|
217
|
+
|
|
218
|
+
```
|
|
219
|
+
✓ rollingInterval: Day # 基于时间
|
|
220
|
+
✓ fileSizeLimitBytes: 104857600 (100 MB) # 基于大小
|
|
221
|
+
✓ rollOnFileSizeLimit: true # 轮转,不丢弃
|
|
222
|
+
✓ retainedFileCountLimit: ≥ N*7 # N = 每天最大轮转次数
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
当日志文件大小在预计当天结束时达到 **`fileSizeLimitBytes` 的 ≥ 90%**,**先调查噪声根因**(嘈杂的重试循环 / 意外启用的调试日志 / 堆栈跟踪洪流),再提高上限。
|
|
226
|
+
|
|
227
|
+
> 含各语言(.NET Serilog / Python / Java log4j2 / Node Winston)配置示例及真实事故失败模式参考的完整规范,请参见核心标准中的 [日志文件轮转策略](../../core/logging-standards.md#日志文件轮转策略)。
|
|
210
228
|
|
|
211
229
|
## 检查清单
|
|
212
230
|
|
|
213
|
-
###
|
|
231
|
+
### 必要字段
|
|
214
232
|
|
|
215
233
|
- [ ] timestamp(ISO 8601)
|
|
216
234
|
- [ ] level
|
|
217
235
|
- [ ] message
|
|
218
|
-
- [ ]
|
|
236
|
+
- [ ] 服务名称
|
|
219
237
|
- [ ] request_id 或 trace_id
|
|
220
238
|
|
|
221
239
|
### 安全性
|
|
222
240
|
|
|
223
|
-
- [ ]
|
|
224
|
-
- [ ]
|
|
225
|
-
- [ ] PII
|
|
226
|
-
- [ ]
|
|
227
|
-
- [ ]
|
|
241
|
+
- [ ] 无密码或密钥
|
|
242
|
+
- [ ] 无完整令牌
|
|
243
|
+
- [ ] PII 已脱敏或哈希
|
|
244
|
+
- [ ] 信用卡从不记录
|
|
245
|
+
- [ ] 保留策略已配置
|
|
246
|
+
|
|
247
|
+
### 轮转
|
|
248
|
+
|
|
249
|
+
- [ ] 已设置时间轮转(`rollingInterval: Day` 或同等配置)
|
|
250
|
+
- [ ] 已设置大小轮转(`fileSizeLimitBytes` + `rollOnFileSizeLimit: true`)
|
|
251
|
+
- [ ] `retainedFileCountLimit` ≥ N×7(N = 每天最大轮转次数)
|
|
252
|
+
- [ ] 已定义 90% 大小 SOP(调查噪声,不要盲目提高上限)
|
|
228
253
|
|
|
229
254
|
---
|
|
230
255
|
|
|
231
|
-
##
|
|
256
|
+
## 配置检测
|
|
232
257
|
|
|
233
|
-
|
|
258
|
+
本技能支持项目特定配置。
|
|
234
259
|
|
|
235
|
-
###
|
|
260
|
+
### 检测顺序
|
|
236
261
|
|
|
237
|
-
1.
|
|
238
|
-
2. 检查 `CONTRIBUTING.md`
|
|
239
|
-
3.
|
|
262
|
+
1. 检查现有的日志库配置
|
|
263
|
+
2. 检查 `CONTRIBUTING.md` 中的日志指南
|
|
264
|
+
3. 若未找到,**默认使用结构化 JSON 日志**
|
|
240
265
|
|
|
241
266
|
### 首次设置
|
|
242
267
|
|
|
243
|
-
|
|
268
|
+
若未找到日志标准:
|
|
244
269
|
|
|
245
|
-
1.
|
|
270
|
+
1. 建议:"此项目尚未配置日志标准。是否要设置结构化日志?"
|
|
246
271
|
2. 建议在 `CONTRIBUTING.md` 中记录:
|
|
247
272
|
|
|
248
273
|
```markdown
|
|
249
|
-
##
|
|
274
|
+
## 日志标准
|
|
250
275
|
|
|
251
|
-
###
|
|
252
|
-
- DEBUG:
|
|
253
|
-
- INFO:
|
|
254
|
-
- WARN:
|
|
255
|
-
- ERROR:
|
|
276
|
+
### 日志级别
|
|
277
|
+
- DEBUG: 仅开发环境,详细诊断信息
|
|
278
|
+
- INFO: 正常操作(启动、用户操作、任务)
|
|
279
|
+
- WARN: 意外但可恢复的情况
|
|
280
|
+
- ERROR: 需要调查的失败
|
|
256
281
|
|
|
257
|
-
###
|
|
258
|
-
|
|
282
|
+
### 必要字段
|
|
283
|
+
所有日志必须包含:timestamp, level, message, service, request_id
|
|
259
284
|
|
|
260
285
|
### 敏感数据
|
|
261
|
-
|
|
286
|
+
绝不记录:密码、令牌、信用卡、身份证号码
|
|
262
287
|
```
|
|
263
288
|
|
|
264
289
|
---
|
|
265
290
|
|
|
291
|
+
## 下一步引导
|
|
292
|
+
|
|
293
|
+
`/logging` 完成后,AI 助手应建议:
|
|
294
|
+
|
|
295
|
+
> **日志标准已掌握。建议下一步 / Logging standards understood. Suggested next steps:**
|
|
296
|
+
> - 根据日志指南在代码中实现结构化日志 ⭐ **推荐** — 立即将日志标准应用到项目
|
|
297
|
+
> - 执行 `/errors` 设计错误码以配合日志系统 — 让错误追踪更高效
|
|
298
|
+
> - 执行 `/sdd` 将可观测性需求纳入规格 — 确保日志需求在规格中有定义
|
|
299
|
+
|
|
300
|
+
---
|
|
301
|
+
|
|
266
302
|
## 相关标准
|
|
267
303
|
|
|
268
|
-
- [
|
|
304
|
+
- [日志标准](../../../../core/logging-standards.md)
|
|
269
305
|
- [错误码标准](../../../../core/error-code-standards.md)
|
|
270
306
|
|
|
271
307
|
---
|
|
@@ -274,45 +310,13 @@ logger.error('处理订单失败', {
|
|
|
274
310
|
|
|
275
311
|
| 版本 | 日期 | 变更 |
|
|
276
312
|
|------|------|------|
|
|
277
|
-
| 1.
|
|
313
|
+
| 1.1.0 | 2026-05-26 | 新增:日志文件轮转章节及核心标准轮转策略交叉引用;轮转检查清单(XSPEC-232) |
|
|
314
|
+
| 1.0.0 | 2025-12-30 | 初始发布 |
|
|
278
315
|
|
|
279
316
|
---
|
|
280
317
|
|
|
281
318
|
## 授权
|
|
282
319
|
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
**來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
## Next Steps Guidance | 下一步引導
|
|
289
|
-
|
|
290
|
-
After `/logging` completes, the AI assistant should suggest:
|
|
291
|
-
|
|
292
|
-
> **日誌標準已掌握。建議下一步 / Logging standards understood. Suggested next steps:**
|
|
293
|
-
> - 根據日誌指南在程式碼中實作結構化日誌 ⭐ **Recommended / 推薦** — 立即將日誌標準應用到專案 / Apply logging standards to the project immediately
|
|
294
|
-
> - 執行 `/errors` 設計錯誤碼以配合日誌系統 — 讓錯誤追蹤更有效率 / Make error tracking more efficient
|
|
295
|
-
> - 執行 `/sdd` 將可觀測性需求納入規格 — 確保日誌需求在規格中有定義 / Ensure logging requirements are defined in specs
|
|
296
|
-
|
|
297
|
-
---
|
|
298
|
-
|
|
299
|
-
## Related Standards
|
|
300
|
-
|
|
301
|
-
- [Logging Standards](../../core/logging-standards.md)
|
|
302
|
-
- [Error Code Standards](../../core/error-code-standards.md)
|
|
303
|
-
|
|
304
|
-
---
|
|
305
|
-
|
|
306
|
-
## Version History
|
|
307
|
-
|
|
308
|
-
| Version | Date | Changes |
|
|
309
|
-
|---------|------|---------|
|
|
310
|
-
| 1.0.0 | 2025-12-30 | Initial release |
|
|
311
|
-
|
|
312
|
-
---
|
|
313
|
-
|
|
314
|
-
## License
|
|
315
|
-
|
|
316
|
-
This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
|
|
320
|
+
本技能采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 发布。
|
|
317
321
|
|
|
318
|
-
|
|
322
|
+
**来源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
|
|
@@ -187,7 +187,7 @@ AI: Migration Assessment: Vue 2 → Vue 3
|
|
|
187
187
|
|
|
188
188
|
## AI 代理行为
|
|
189
189
|
|
|
190
|
-
> 完整的 AI 行为定义请参阅对应的命令文件:[`/migrate`](
|
|
190
|
+
> 完整的 AI 行为定义请参阅对应的命令文件:[`/migrate`](../../../../skills/commands/migrate.md#ai-agent-behavior--ai-代理行為)
|
|
191
191
|
|
|
192
192
|
## 授权
|
|
193
193
|
|
|
@@ -14,7 +14,7 @@ description: |
|
|
|
14
14
|
|
|
15
15
|
# Observability Assistant
|
|
16
16
|
|
|
17
|
-
>
|
|
17
|
+
> **语言**: [English](../../../../skills/observability-assistant/guide.md) | 简体中文
|
|
18
18
|
|
|
19
19
|
**版本**:1.0.0
|
|
20
20
|
**最后更新**:2026-04-01
|
|
@@ -305,9 +305,9 @@ routes -> controllers -> services -> repositories -> database
|
|
|
305
305
|
- 根据现况评估发现编写新功能规格
|
|
306
306
|
- 在风险评估区段引用现况评估报告
|
|
307
307
|
|
|
308
|
-
### 搭配 /review(代码审查)
|
|
308
|
+
### 搭配 /code-review(代码审查)
|
|
309
309
|
|
|
310
|
-
步骤 0.4 的快照是 `/review` 的轻量版。在以下情况使用完整的 `/review`:
|
|
310
|
+
步骤 0.4 的快照是 `/code-review` 的轻量版。在以下情况使用完整的 `/code-review`:
|
|
311
311
|
- 现况评估发现重大质量疑虑
|
|
312
312
|
- 规划变更前需要更深入的审计
|
|
313
313
|
|
|
@@ -15,7 +15,7 @@ argument-hint: "[process description | 流程描述]"
|
|
|
15
15
|
|
|
16
16
|
# 流程转 Skill 助手
|
|
17
17
|
|
|
18
|
-
>
|
|
18
|
+
> **语言**: [English](../../../../skills/skill-builder/SKILL.md) | 简体中文
|
|
19
19
|
|
|
20
20
|
引导你从「我一直在手动做这件事」走到「拥有一个正确构建的 Skill」,并在这一过程中保持适量的流程治理。
|
|
21
21
|
|
|
@@ -144,6 +144,6 @@ Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
|
|
|
144
144
|
|
|
145
145
|
## 参考
|
|
146
146
|
|
|
147
|
-
- Skill Brief 模板:[templates/SKILL-BRIEF-TEMPLATE.md](
|
|
148
|
-
- 候选追踪:[templates/SKILL-CANDIDATES.md](
|
|
147
|
+
- Skill Brief 模板:[templates/SKILL-BRIEF-TEMPLATE.md](../../../../templates/SKILL-BRIEF-TEMPLATE.md)
|
|
148
|
+
- 候选追踪:[templates/SKILL-CANDIDATES.md](../../../../templates/SKILL-CANDIDATES.md)(请复制到你的项目)
|
|
149
149
|
- ADR 标准:[core/adr-standards.md](../../core/adr-standards.md)
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../../skills/spec-derivation/guide.md
|
|
3
|
-
source_version:
|
|
4
|
-
translation_version:
|
|
5
|
-
last_synced: 2026-06-
|
|
6
|
-
source_hash:
|
|
3
|
+
source_version: 2.0.0
|
|
4
|
+
translation_version: 2.0.0
|
|
5
|
+
last_synced: 2026-06-10
|
|
6
|
+
source_hash: 8c89e24244a5
|
|
7
7
|
status: current
|
|
8
8
|
scope: partial
|
|
9
9
|
description: |
|
|
@@ -15,7 +15,7 @@ description: |
|
|
|
15
15
|
|
|
16
16
|
# 正向推演指南
|
|
17
17
|
|
|
18
|
-
>
|
|
18
|
+
> **语言**: [English](../../../../skills/spec-derivation/guide.md) | 简体中文
|
|
19
19
|
|
|
20
20
|
**版本**:2.0.0
|
|
21
21
|
**最后更新**:2026-01-25
|
|
@@ -101,7 +101,7 @@ Scenario: User login with valid credentials
|
|
|
101
101
|
|
|
102
102
|
### 3. 推演标签(来自统一标签系统)
|
|
103
103
|
|
|
104
|
-
本 skill 使用 **推演标签(Derivation Tags)** 从规格生成新内容。完整的标签参考见 [Anti-Hallucination Standards](
|
|
104
|
+
本 skill 使用 **推演标签(Derivation Tags)** 从规格生成新内容。完整的标签参考见 [Anti-Hallucination Standards](../../../../core/anti-hallucination.md#certainty-classification-tags)。
|
|
105
105
|
|
|
106
106
|
| 标签 | 使用时机 | 示例 |
|
|
107
107
|
|-----|----------|---------|
|
|
@@ -220,18 +220,17 @@ Scenario: Login shows error for invalid credentials
|
|
|
220
220
|
# Generator: /derive-bdd v1.0.0
|
|
221
221
|
# Generated at: 2026-01-19T10:00:00Z
|
|
222
222
|
|
|
223
|
-
@SPEC-001
|
|
224
223
|
Feature: User Authentication
|
|
225
224
|
[Source] From SPEC-001 Summary
|
|
226
225
|
|
|
227
|
-
@AC-1 @happy-path
|
|
226
|
+
@SPEC-001 @AC-1 @happy-path
|
|
228
227
|
Scenario: User login with valid credentials
|
|
229
228
|
# [Source] From SPEC-001 AC-1
|
|
230
229
|
Given a registered user with valid credentials
|
|
231
230
|
When the user submits login form
|
|
232
231
|
Then the user is redirected to dashboard
|
|
233
232
|
|
|
234
|
-
@AC-2 @error-handling
|
|
233
|
+
@SPEC-001 @AC-2 @error-handling
|
|
235
234
|
Scenario: Login fails with invalid credentials
|
|
236
235
|
# [Source] From SPEC-001 AC-2
|
|
237
236
|
Given a user with invalid credentials
|
|
@@ -218,6 +218,6 @@ The system SHALL [behavior description].
|
|
|
218
218
|
|
|
219
219
|
## AI Agent Behavior | AI 代理行为
|
|
220
220
|
|
|
221
|
-
> 完整的 AI 行为定义请参阅对应的命令文件:[`/sdd`](
|
|
221
|
+
> 完整的 AI 行为定义请参阅对应的命令文件:[`/sdd`](../../../../skills/commands/sdd.md#ai-agent-behavior--ai-代理行為)
|
|
222
222
|
>
|
|
223
|
-
> For complete AI agent behavior definition, see the corresponding command file: [`/sdd`](
|
|
223
|
+
> For complete AI agent behavior definition, see the corresponding command file: [`/sdd`](../../../../skills/commands/sdd.md#ai-agent-behavior--ai-代理行為)
|
|
@@ -102,7 +102,7 @@ UDS 提供 6 个与测试相关的 Skill。使用以下决策树找到合适的
|
|
|
102
102
|
- [测试标准](../../core/testing-standards.md) - 可执行的规则
|
|
103
103
|
- [测试理论](./testing-theory.md) - 教学型知识库
|
|
104
104
|
- [测试金字塔](./testing-pyramid.md) - 详细的金字塔比例
|
|
105
|
-
- [测试骨架模板](
|
|
105
|
+
- [测试骨架模板](../../../../skills/testing-guide/test-skeleton-templates.md) - 面向 UT/IT/ST/Perf/Contract 的多语言骨架
|
|
106
106
|
|
|
107
107
|
### AI 优化格式(Token 高效)
|
|
108
108
|
|
|
@@ -119,7 +119,7 @@ UDS 提供 6 个与测试相关的 Skill。使用以下决策树找到合适的
|
|
|
119
119
|
- 安全测试:`ai/options/testing/security-testing.ai.yaml`
|
|
120
120
|
- 性能测试:`ai/options/testing/performance-testing.ai.yaml`
|
|
121
121
|
- 契约测试:`ai/options/testing/contract-testing.ai.yaml`
|
|
122
|
-
- 骨架模板(涵盖所有层级、多语言):[test-skeleton-templates.md](
|
|
122
|
+
- 骨架模板(涵盖所有层级、多语言):[test-skeleton-templates.md](../../../../skills/testing-guide/test-skeleton-templates.md)
|
|
123
123
|
|
|
124
124
|
## 命名惯例
|
|
125
125
|
|