@ccoalm/ccl-skills 0.1.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.
Files changed (561) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +49 -0
  3. package/dist/assets/marketplace/.agents/plugins/marketplace.json +12 -0
  4. package/dist/assets/marketplace/.claude-plugin/marketplace.json +13 -0
  5. package/dist/assets/marketplace/marketplace-manifest.json +12 -0
  6. package/dist/assets/marketplace/plugins/ccl-skills/.claude-plugin/marketplace.json +16 -0
  7. package/dist/assets/marketplace/plugins/ccl-skills/.claude-plugin/plugin.json +5 -0
  8. package/dist/assets/marketplace/plugins/ccl-skills/.codex-plugin/plugin.json +5 -0
  9. package/dist/assets/marketplace/plugins/ccl-skills/.worktree-only +3 -0
  10. package/dist/assets/marketplace/plugins/ccl-skills/agent-context/session-start.md +45 -0
  11. package/dist/assets/marketplace/plugins/ccl-skills/agent-context/subagent-start.md +12 -0
  12. package/dist/assets/marketplace/plugins/ccl-skills/hooks/AGENTS.md +19 -0
  13. package/dist/assets/marketplace/plugins/ccl-skills/hooks/guard-delegation-owner.sh +125 -0
  14. package/dist/assets/marketplace/plugins/ccl-skills/hooks/guard-edit-isolation.sh +102 -0
  15. package/dist/assets/marketplace/plugins/ccl-skills/hooks/guard-merge-authorization.sh +1156 -0
  16. package/dist/assets/marketplace/plugins/ccl-skills/hooks/hooks.json +131 -0
  17. package/dist/assets/marketplace/plugins/ccl-skills/hooks/merge-authorization-prompt.sh +142 -0
  18. package/dist/assets/marketplace/plugins/ccl-skills/hooks/owner-dispatch-guard.sh +12 -0
  19. package/dist/assets/marketplace/plugins/ccl-skills/hooks/owner-dispatch-stop.sh +13 -0
  20. package/dist/assets/marketplace/plugins/ccl-skills/hooks/remind-post-merge-cleanup.sh +144 -0
  21. package/dist/assets/marketplace/plugins/ccl-skills/hooks/session-context.sh +87 -0
  22. package/dist/assets/marketplace/plugins/ccl-skills/hooks/session-start.sh +86 -0
  23. package/dist/assets/marketplace/plugins/ccl-skills/hooks/skill-extraction-gate-stop.sh +69 -0
  24. package/dist/assets/marketplace/plugins/ccl-skills/hooks/subagent-start.sh +26 -0
  25. package/dist/assets/marketplace/plugins/ccl-skills/hooks/test_guard_delegation_owner.sh +329 -0
  26. package/dist/assets/marketplace/plugins/ccl-skills/hooks/test_guard_edit_isolation.sh +322 -0
  27. package/dist/assets/marketplace/plugins/ccl-skills/hooks/test_guard_merge_authorization.sh +902 -0
  28. package/dist/assets/marketplace/plugins/ccl-skills/hooks/test_merge_authorization_prompt.sh +178 -0
  29. package/dist/assets/marketplace/plugins/ccl-skills/hooks/test_remind_post_merge_cleanup.sh +121 -0
  30. package/dist/assets/marketplace/plugins/ccl-skills/hooks/test_session_start.sh +170 -0
  31. package/dist/assets/marketplace/plugins/ccl-skills/packages/opencode-plugin/AGENTS.md +17 -0
  32. package/dist/assets/marketplace/plugins/ccl-skills/packages/opencode-plugin/ccl-skills.ts +564 -0
  33. package/dist/assets/marketplace/plugins/ccl-skills/packages/opencode-plugin/commands/ccl-install-skills.md +14 -0
  34. package/dist/assets/marketplace/plugins/ccl-skills/packages/opencode-plugin/commands/ccl-update-skills.md +44 -0
  35. package/dist/assets/marketplace/plugins/ccl-skills/packages/opencode-plugin/commands/ccl-verify-skills.md +109 -0
  36. package/dist/assets/marketplace/plugins/ccl-skills/packages/opencode-plugin/commands/ccl-worktree-check.md +36 -0
  37. package/dist/assets/marketplace/plugins/ccl-skills/scripts/owner-dispatch/AGENTS.md +28 -0
  38. package/dist/assets/marketplace/plugins/ccl-skills/scripts/owner-dispatch/README.md +276 -0
  39. package/dist/assets/marketplace/plugins/ccl-skills/scripts/owner-dispatch/owner-dispatch.example.json +10 -0
  40. package/dist/assets/marketplace/plugins/ccl-skills/scripts/owner-dispatch/owner-dispatch.sh +1307 -0
  41. package/dist/assets/marketplace/plugins/ccl-skills/scripts/owner-dispatch/test.sh +941 -0
  42. package/dist/assets/marketplace/plugins/ccl-skills/skills/agents-file-coverage-gate/SKILL.md +45 -0
  43. package/dist/assets/marketplace/plugins/ccl-skills/skills/agents-file-coverage-gate/agents/openai.yaml +4 -0
  44. package/dist/assets/marketplace/plugins/ccl-skills/skills/app-cross-platform-dev/SKILL.md +188 -0
  45. package/dist/assets/marketplace/plugins/ccl-skills/skills/app-cross-platform-dev/agents/openai.yaml +4 -0
  46. package/dist/assets/marketplace/plugins/ccl-skills/skills/app-cross-platform-dev/references/android-dev.md +92 -0
  47. package/dist/assets/marketplace/plugins/ccl-skills/skills/app-cross-platform-dev/references/flutter-dev.md +80 -0
  48. package/dist/assets/marketplace/plugins/ccl-skills/skills/app-cross-platform-dev/references/ios-dev.md +72 -0
  49. package/dist/assets/marketplace/plugins/ccl-skills/skills/app-cross-platform-dev/references/kotlin-multiplatform.md +93 -0
  50. package/dist/assets/marketplace/plugins/ccl-skills/skills/app-cross-platform-dev/references/mobile-platform-boundaries.md +77 -0
  51. package/dist/assets/marketplace/plugins/ccl-skills/skills/app-cross-platform-dev/references/mobile-quality-release.md +77 -0
  52. package/dist/assets/marketplace/plugins/ccl-skills/skills/app-cross-platform-dev/references/source-evidence-map.md +64 -0
  53. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/SKILL.md +353 -0
  54. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/agents/openai.yaml +4 -0
  55. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/references/client-routing.md +419 -0
  56. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/references/manual-invocation-and-prompts.md +126 -0
  57. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/references/staged-review-contract.md +197 -0
  58. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/references/timeout-auth-and-capabilities.md +179 -0
  59. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/AGENTS.md +98 -0
  60. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/classify_envelope.py +93 -0
  61. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/classify_timeout_exit.sh +15 -0
  62. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/claude_review.sh +1438 -0
  63. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/codex_review.sh +324 -0
  64. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/concern_excerpt.py +295 -0
  65. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/egress_schema.py +214 -0
  66. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/init_policy_matrix.py +642 -0
  67. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/kimi_packet_mcp.py +181 -0
  68. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/kimi_review.sh +1165 -0
  69. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/opencode_review.sh +1190 -0
  70. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/parse_cli_review.py +946 -0
  71. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/parse_opencode_review.py +474 -0
  72. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/parse_probe_result.py +1899 -0
  73. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/parse_review_json.py +200 -0
  74. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/review_gate.py +2845 -0
  75. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/review_gate.sh +6 -0
  76. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/run_claude_capture.py +71 -0
  77. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/runtime-surface-verification-design.md +53 -0
  78. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/test_classify_envelope.sh +68 -0
  79. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/test_claude_review_probe.sh +2311 -0
  80. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/test_cli_review_wrappers.sh +1832 -0
  81. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/test_code_review_identity.sh +73 -0
  82. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/test_concern_excerpt.sh +245 -0
  83. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/test_egress_schema.sh +177 -0
  84. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/test_init_policy_matrix.sh +272 -0
  85. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/test_kimi_packet_mcp.py +195 -0
  86. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/test_opencode_review_concurrency.sh +120 -0
  87. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/test_opencode_review_retry.sh +1005 -0
  88. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/test_parse_opencode_review.sh +258 -0
  89. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/test_parse_probe_result.sh +574 -0
  90. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/test_parse_review_json.sh +349 -0
  91. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/test_review_client_compat.py +434 -0
  92. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/test_review_client_order.sh +264 -0
  93. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/test_review_gate.sh +2412 -0
  94. package/dist/assets/marketplace/plugins/ccl-skills/skills/code-review/scripts/verify_native_skill_binding.py +123 -0
  95. package/dist/assets/marketplace/plugins/ccl-skills/skills/defect-diagnosis/SKILL.md +153 -0
  96. package/dist/assets/marketplace/plugins/ccl-skills/skills/defect-diagnosis/agents/openai.yaml +4 -0
  97. package/dist/assets/marketplace/plugins/ccl-skills/skills/defect-diagnosis/references/diagnosis-playbook.md +54 -0
  98. package/dist/assets/marketplace/plugins/ccl-skills/skills/defect-diagnosis/references/prevention-routing.md +36 -0
  99. package/dist/assets/marketplace/plugins/ccl-skills/skills/feature-risk-router/SKILL.md +69 -0
  100. package/dist/assets/marketplace/plugins/ccl-skills/skills/feature-risk-router/agents/openai.yaml +4 -0
  101. package/dist/assets/marketplace/plugins/ccl-skills/skills/feature-risk-router/references/security-review-gate.md +41 -0
  102. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/SKILL.md +165 -0
  103. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/agents/openai.yaml +4 -0
  104. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/api-security-boundaries.md +47 -0
  105. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/architecture-playbook.md +160 -0
  106. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/artifact-generation-architecture.md +37 -0
  107. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/audit-history-architecture.md +29 -0
  108. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/bulk-workflow-architecture.md +33 -0
  109. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/config-rule-routing-architecture.md +34 -0
  110. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/cross-cutting-concerns.md +72 -0
  111. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/data-modeling-and-migrations.md +79 -0
  112. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/data-platform-architecture.md +210 -0
  113. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/dependency-platform.md +105 -0
  114. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/developer-tooling-architecture.md +38 -0
  115. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/error-contract-architecture.md +36 -0
  116. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/event-driven-architecture.md +260 -0
  117. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/http-gateway-architecture.md +74 -0
  118. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/mq-consumer-architecture.md +38 -0
  119. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/multi-tenant-isolation.md +275 -0
  120. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/notification-architecture.md +25 -0
  121. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/ops-checklist.md +57 -0
  122. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/performance-capacity-architecture.md +38 -0
  123. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/protobuf-contract-architecture.md +119 -0
  124. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/redis-cache-coordination.md +93 -0
  125. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/release-runtime-readiness.md +65 -0
  126. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/replay-comparison-architecture.md +26 -0
  127. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/runtime-observability.md +94 -0
  128. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/service-scaffold.md +76 -0
  129. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/source-evidence-map.md +55 -0
  130. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-architecture/references/workflow-state-architecture.md +38 -0
  131. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/SKILL.md +159 -0
  132. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/agents/openai.yaml +4 -0
  133. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/artifact-generation-patterns.md +37 -0
  134. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/audit-history-patterns.md +28 -0
  135. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/bulk-import-export-patterns.md +56 -0
  136. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/config-rule-routing-patterns.md +38 -0
  137. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/data-access-patterns.md +55 -0
  138. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/db-schema-and-dal-patterns.md +109 -0
  139. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/dependency-client-patterns.md +130 -0
  140. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/developer-tooling-patterns.md +70 -0
  141. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/domain-feature-patterns.md +78 -0
  142. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/engineering-patterns.md +119 -0
  143. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/error-contract-patterns.md +55 -0
  144. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/feature-playbook.md +61 -0
  145. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/http-gateway-client-patterns.md +76 -0
  146. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/mq-consumer-patterns.md +55 -0
  147. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/notification-patterns.md +42 -0
  148. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/observability-implementation-patterns.md +101 -0
  149. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/performance-capacity-patterns.md +44 -0
  150. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/protobuf-contract-patterns.md +72 -0
  151. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/public-api-integration-patterns.md +56 -0
  152. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/quality-and-testing-patterns.md +91 -0
  153. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/redis-cache-lock-patterns.md +123 -0
  154. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/release-ops-patterns.md +112 -0
  155. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/reliability-patterns.md +83 -0
  156. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/replay-comparison-patterns.md +32 -0
  157. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/scaffold-and-codegen.md +86 -0
  158. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/source-evidence-map.md +54 -0
  159. package/dist/assets/marketplace/plugins/ccl-skills/skills/go-microservice-dev/references/state-machine-task-patterns.md +45 -0
  160. package/dist/assets/marketplace/plugins/ccl-skills/skills/grill-me/SKILL.md +80 -0
  161. package/dist/assets/marketplace/plugins/ccl-skills/skills/grill-me/agents/openai.yaml +4 -0
  162. package/dist/assets/marketplace/plugins/ccl-skills/skills/llm-inference-integration/SKILL.md +117 -0
  163. package/dist/assets/marketplace/plugins/ccl-skills/skills/llm-inference-integration/agents/openai.yaml +4 -0
  164. package/dist/assets/marketplace/plugins/ccl-skills/skills/llm-inference-integration/references/agent-approval-auto-reviewer.md +106 -0
  165. package/dist/assets/marketplace/plugins/ccl-skills/skills/llm-inference-integration/references/agent-command-sandbox.md +441 -0
  166. package/dist/assets/marketplace/plugins/ccl-skills/skills/llm-inference-integration/references/agent-context-freshness.md +47 -0
  167. package/dist/assets/marketplace/plugins/ccl-skills/skills/llm-inference-integration/references/agent-credentials-auth.md +13 -0
  168. package/dist/assets/marketplace/plugins/ccl-skills/skills/llm-inference-integration/references/agent-extensions-skills.md +13 -0
  169. package/dist/assets/marketplace/plugins/ccl-skills/skills/llm-inference-integration/references/agent-file-edit-protocol.md +129 -0
  170. package/dist/assets/marketplace/plugins/ccl-skills/skills/llm-inference-integration/references/agent-ide-integration.md +5 -0
  171. package/dist/assets/marketplace/plugins/ccl-skills/skills/llm-inference-integration/references/agent-input-ingestion.md +13 -0
  172. package/dist/assets/marketplace/plugins/ccl-skills/skills/llm-inference-integration/references/agent-instruction-composition.md +13 -0
  173. package/dist/assets/marketplace/plugins/ccl-skills/skills/llm-inference-integration/references/agent-lifecycle-hooks.md +92 -0
  174. package/dist/assets/marketplace/plugins/ccl-skills/skills/llm-inference-integration/references/agent-messaging.md +5 -0
  175. package/dist/assets/marketplace/plugins/ccl-skills/skills/llm-inference-integration/references/agent-runtime-bootstrap.md +5 -0
  176. package/dist/assets/marketplace/plugins/ccl-skills/skills/llm-inference-integration/references/agent-session-persistence.md +448 -0
  177. package/dist/assets/marketplace/plugins/ccl-skills/skills/llm-inference-integration/references/agent-task-orchestration.md +13 -0
  178. package/dist/assets/marketplace/plugins/ccl-skills/skills/llm-inference-integration/references/agent-tool-dispatch.md +123 -0
  179. package/dist/assets/marketplace/plugins/ccl-skills/skills/llm-inference-integration/references/agent-turn-lifecycle.md +131 -0
  180. package/dist/assets/marketplace/plugins/ccl-skills/skills/llm-inference-integration/references/inference-capacity-operations.md +162 -0
  181. package/dist/assets/marketplace/plugins/ccl-skills/skills/llm-inference-integration/references/llm-client-gateway.md +156 -0
  182. package/dist/assets/marketplace/plugins/ccl-skills/skills/llm-inference-integration/references/model-prompt-evaluation.md +146 -0
  183. package/dist/assets/marketplace/plugins/ccl-skills/skills/llm-inference-integration/references/retrieval-agent-safety.md +273 -0
  184. package/dist/assets/marketplace/plugins/ccl-skills/skills/miniapp-product-dev/SKILL.md +202 -0
  185. package/dist/assets/marketplace/plugins/ccl-skills/skills/miniapp-product-dev/agents/openai.yaml +4 -0
  186. package/dist/assets/marketplace/plugins/ccl-skills/skills/miniapp-product-dev/references/contracts-and-state.md +62 -0
  187. package/dist/assets/marketplace/plugins/ccl-skills/skills/miniapp-product-dev/references/cross-stack-alignment.md +94 -0
  188. package/dist/assets/marketplace/plugins/ccl-skills/skills/miniapp-product-dev/references/framework-choice.md +76 -0
  189. package/dist/assets/marketplace/plugins/ccl-skills/skills/miniapp-product-dev/references/online-practice-uptake.md +56 -0
  190. package/dist/assets/marketplace/plugins/ccl-skills/skills/miniapp-product-dev/references/platform-capabilities.md +91 -0
  191. package/dist/assets/marketplace/plugins/ccl-skills/skills/miniapp-product-dev/references/product-page-checklist.md +40 -0
  192. package/dist/assets/marketplace/plugins/ccl-skills/skills/miniapp-product-dev/references/qa-release.md +72 -0
  193. package/dist/assets/marketplace/plugins/ccl-skills/skills/miniapp-product-dev/references/source-evidence-map.md +82 -0
  194. package/dist/assets/marketplace/plugins/ccl-skills/skills/multi-agent-delegation/SKILL.md +103 -0
  195. package/dist/assets/marketplace/plugins/ccl-skills/skills/multi-agent-delegation/agents/openai.yaml +5 -0
  196. package/dist/assets/marketplace/plugins/ccl-skills/skills/multi-agent-delegation/references/multi-agent-delegation-playbook.md +100 -0
  197. package/dist/assets/marketplace/plugins/ccl-skills/skills/multi-perspective-research/SKILL.md +70 -0
  198. package/dist/assets/marketplace/plugins/ccl-skills/skills/multi-perspective-research/agents/openai.yaml +4 -0
  199. package/dist/assets/marketplace/plugins/ccl-skills/skills/multi-perspective-research/references/public-data-acquisition.md +549 -0
  200. package/dist/assets/marketplace/plugins/ccl-skills/skills/multi-perspective-research/references/public-disclosure-channels.md +97 -0
  201. package/dist/assets/marketplace/plugins/ccl-skills/skills/multi-perspective-research/references/research-prompts.md +66 -0
  202. package/dist/assets/marketplace/plugins/ccl-skills/skills/multi-perspective-research/scripts/AGENTS.md +32 -0
  203. package/dist/assets/marketplace/plugins/ccl-skills/skills/multi-perspective-research/scripts/test-public-data-acquisition-recipes.sh +379 -0
  204. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-observability/SKILL.md +244 -0
  205. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-observability/agents/openai.yaml +4 -0
  206. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-observability/references/alerting-and-on-call.md +76 -0
  207. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-observability/references/framework-middleware-checklist.md +142 -0
  208. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-observability/references/infra-component-deployment.md +268 -0
  209. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-observability/references/log-correlation-recipe.md +124 -0
  210. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-observability/references/log-schema-canonical.md +208 -0
  211. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-observability/references/metrics-conventions.md +105 -0
  212. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-observability/references/obs-stack-architecture.md +107 -0
  213. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-observability/references/sli-slo-design.md +95 -0
  214. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-observability/references/source-register.md +11 -0
  215. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-release-engineering/SKILL.md +303 -0
  216. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-release-engineering/agents/openai.yaml +4 -0
  217. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-release-engineering/references/canary-and-rollout-strategy.md +163 -0
  218. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-release-engineering/references/config-center-via-etcd.md +245 -0
  219. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-release-engineering/references/custom-control-plane-boundary.md +298 -0
  220. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-release-engineering/references/deploy-cli-concrete-recipe.md +312 -0
  221. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-release-engineering/references/deploy-pipeline.md +165 -0
  222. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-release-engineering/references/env-and-lane-matrix.md +126 -0
  223. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-release-engineering/references/lane-orchestration-control-plane.md +383 -0
  224. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-release-engineering/references/multi-region-and-cluster.md +135 -0
  225. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-release-engineering/references/promotion-gate-and-review.md +149 -0
  226. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-release-engineering/references/python-package-registry-release.md +462 -0
  227. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-release-engineering/references/rollback-playbook.md +123 -0
  228. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-release-engineering/references/secret-and-config-management.md +231 -0
  229. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-release-engineering/references/version-authority-and-deprecation.md +21 -0
  230. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-service-connectivity/SKILL.md +276 -0
  231. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-service-connectivity/agents/openai.yaml +4 -0
  232. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-service-connectivity/references/dual-sidecar-and-traffic-config-center.md +127 -0
  233. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-service-connectivity/references/framework-middleware.md +143 -0
  234. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-service-connectivity/references/grpc-authority-workaround.md +90 -0
  235. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-service-connectivity/references/http-response-envelope-contract.md +24 -0
  236. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-service-connectivity/references/mesh-architecture.md +127 -0
  237. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-service-connectivity/references/multi-env-routing.md +192 -0
  238. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-service-connectivity/references/protobuf-http-contract-signals.md +64 -0
  239. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-service-connectivity/references/retry-timeout-circuit-breaker.md +124 -0
  240. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-service-connectivity/references/rpc-framework-recipe.md +494 -0
  241. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-service-connectivity/references/service-discovery-choice.md +113 -0
  242. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-service-connectivity/references/service-discovery-migration-playbook.md +231 -0
  243. package/dist/assets/marketplace/plugins/ccl-skills/skills/platform-service-connectivity/references/service-discovery-recipe.md +131 -0
  244. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/SKILL.md +235 -0
  245. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/agents/openai.yaml +4 -0
  246. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/adr-convention.md +146 -0
  247. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/algorithm-launch-checklist.md +30 -0
  248. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/algorithm-launch-evaluation-report-template.md +25 -0
  249. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/algorithm-launch-execution-spec.md +108 -0
  250. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/algorithm-launch-sop.md +457 -0
  251. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/algorithm-launch-templates.md +24 -0
  252. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/artifact-egress-confidentiality.md +58 -0
  253. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/code-review-checklist.md +86 -0
  254. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/cross-repo-coordination.md +46 -0
  255. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/delivery-lifecycle.md +192 -0
  256. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/design-review-gate-mechanics.md +62 -0
  257. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/design-routing-and-readiness.md +45 -0
  258. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/diagnostic-spec-match-gate.md +36 -0
  259. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/dispatch-owner-skills.md +35 -0
  260. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/dormant-code-activation.md +47 -0
  261. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/existing-project-assessment-report.md +223 -0
  262. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/external-skill-augmentation.md +46 -0
  263. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/feature-deprecation-cascade.md +15 -0
  264. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/high-risk-resilience-gates.md +73 -0
  265. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/implementation-completeness-and-minimality.md +120 -0
  266. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/implementation-entry-reentry-gate.md +122 -0
  267. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/modular-monolith-heuristic.md +105 -0
  268. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/pre-final-continuation-gate.md +115 -0
  269. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/problem-resolution-and-learning.md +62 -0
  270. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/quality-attributes.md +112 -0
  271. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/quality-remediation-program.md +88 -0
  272. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/rd-standards-doc-family-checklist.md +27 -0
  273. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/refactoring-discipline.md +52 -0
  274. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/review-reception.md +34 -0
  275. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/shared-gate-artifact-classification.md +76 -0
  276. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/source-evidence-map.md +31 -0
  277. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/status-tracker-sync.md +77 -0
  278. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/sync-spec-repo-contract.md +25 -0
  279. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/verify-developer-experience.md +34 -0
  280. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/references/worktree-mechanics.md +55 -0
  281. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/scripts/AGENTS.md +18 -0
  282. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-rd-workflow/scripts/check-agent-contract-coverage.sh +213 -0
  283. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/SKILL.md +136 -0
  284. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/agents/openai.yaml +9 -0
  285. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/analytics-visualization-interactions.md +206 -0
  286. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/behavioral-aesthetic-logic.md +108 -0
  287. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/complex-creation-interactions.md +194 -0
  288. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/design-execution-checklist.md +214 -0
  289. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/design-impl-naming-and-versioning.md +53 -0
  290. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/design-intake-and-acceptance.md +129 -0
  291. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/design-system-source-of-truth.md +97 -0
  292. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/external-ui-ux-quality-benchmarks.md +79 -0
  293. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/frontend-code-evidence-map.md +63 -0
  294. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/interaction-design-patterns.md +146 -0
  295. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/layout-recipes-and-screenshot-acceptance.md +250 -0
  296. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/multi-project-token-consistency.md +237 -0
  297. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/multi-stack-strategy.md +65 -0
  298. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/operational-processing-workflows.md +237 -0
  299. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/platform-mobile-patterns.md +324 -0
  300. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/platform-web-desktop-patterns.md +456 -0
  301. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/product-lifecycle-acceptance-and-iteration.md +114 -0
  302. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/product-surface-patterns.md +79 -0
  303. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/resource-management-interactions.md +113 -0
  304. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/scenario-community-patterns.md +133 -0
  305. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/source-map.md +130 -0
  306. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/tokens-and-components.md +47 -0
  307. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/trust-sensitive-ai-and-data-patterns.md +96 -0
  308. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/ui-ux-audit.md +106 -0
  309. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/ui-ux-design-development.md +176 -0
  310. package/dist/assets/marketplace/plugins/ccl-skills/skills/product-ui-ux-design/references/visual-craft.md +111 -0
  311. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-architecture/SKILL.md +157 -0
  312. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-architecture/agents/openai.yaml +4 -0
  313. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-architecture/references/ai-service-integration-boundaries.md +57 -0
  314. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-architecture/references/api-contract-and-schema.md +62 -0
  315. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-architecture/references/api-security-boundaries.md +39 -0
  316. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-architecture/references/architecture-playbook.md +46 -0
  317. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-architecture/references/async-execution-model.md +24 -0
  318. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-architecture/references/background-jobs-and-scheduling.md +18 -0
  319. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-architecture/references/batch-and-pipeline-architecture.md +11 -0
  320. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-architecture/references/config-secrets-runtime.md +22 -0
  321. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-architecture/references/data-modeling-and-migrations.md +64 -0
  322. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-architecture/references/data-platform-architecture.md +211 -0
  323. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-architecture/references/event-driven-architecture.md +263 -0
  324. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-architecture/references/multi-tenant-isolation.md +281 -0
  325. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-architecture/references/observability-and-ops.md +26 -0
  326. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-architecture/references/packaging-runtime-readiness.md +20 -0
  327. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-architecture/references/redis-cache-coordination.md +41 -0
  328. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-architecture/references/reliability-and-error-contract.md +17 -0
  329. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-architecture/references/source-evidence-map.md +55 -0
  330. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-architecture/references/web-framework-boundaries.md +26 -0
  331. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-dev/SKILL.md +143 -0
  332. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-dev/agents/openai.yaml +4 -0
  333. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-dev/references/ai-service-wiring-patterns.md +16 -0
  334. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-dev/references/async-and-worker-patterns.md +24 -0
  335. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-dev/references/background-job-patterns.md +18 -0
  336. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-dev/references/batch-and-artifact-patterns.md +13 -0
  337. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-dev/references/dependency-client-patterns.md +39 -0
  338. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-dev/references/error-handling-patterns.md +26 -0
  339. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-dev/references/feature-playbook.md +43 -0
  340. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-dev/references/observability-implementation-patterns.md +31 -0
  341. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-dev/references/project-structure-and-tooling.md +24 -0
  342. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-dev/references/public-api-security-patterns.md +52 -0
  343. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-dev/references/redis-cache-lock-patterns.md +78 -0
  344. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-dev/references/schema-and-validation-patterns.md +23 -0
  345. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-dev/references/source-evidence-map.md +56 -0
  346. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-dev/references/sqlalchemy-and-migrations-patterns.md +99 -0
  347. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-dev/references/testing-and-quality-patterns.md +61 -0
  348. package/dist/assets/marketplace/plugins/ccl-skills/skills/python-service-dev/references/web-framework-patterns.md +35 -0
  349. package/dist/assets/marketplace/plugins/ccl-skills/skills/release-coordination/SKILL.md +91 -0
  350. package/dist/assets/marketplace/plugins/ccl-skills/skills/release-coordination/agents/openai.yaml +4 -0
  351. package/dist/assets/marketplace/plugins/ccl-skills/skills/release-coordination/references/config-runtime-readback.md +20 -0
  352. package/dist/assets/marketplace/plugins/ccl-skills/skills/release-coordination/references/mr-merge-authorization.md +31 -0
  353. package/dist/assets/marketplace/plugins/ccl-skills/skills/release-coordination/references/post-release-env-reset.md +31 -0
  354. package/dist/assets/marketplace/plugins/ccl-skills/skills/release-coordination/references/release-closeout-evidence.md +20 -0
  355. package/dist/assets/marketplace/plugins/ccl-skills/skills/release-coordination/references/release-scope-confirmation.md +21 -0
  356. package/dist/assets/marketplace/plugins/ccl-skills/skills/release-coordination/references/tag-and-prod-pipeline-gate.md +20 -0
  357. package/dist/assets/marketplace/plugins/ccl-skills/skills/release-coordination/references/test-scope-prompt.md +24 -0
  358. package/dist/assets/marketplace/plugins/ccl-skills/skills/release-coordination/references/watcher-discipline.md +14 -0
  359. package/dist/assets/marketplace/plugins/ccl-skills/skills/release-doc-writer/SKILL.md +64 -0
  360. package/dist/assets/marketplace/plugins/ccl-skills/skills/release-doc-writer/agents/openai.yaml +4 -0
  361. package/dist/assets/marketplace/plugins/ccl-skills/skills/release-doc-writer/references/comment-safe-release-doc.md +19 -0
  362. package/dist/assets/marketplace/plugins/ccl-skills/skills/release-doc-writer/references/release-evidence-workflow.md +23 -0
  363. package/dist/assets/marketplace/plugins/ccl-skills/skills/release-doc-writer/references/release-testing-scope-section.md +15 -0
  364. package/dist/assets/marketplace/plugins/ccl-skills/skills/requirement-baseline/SKILL.md +87 -0
  365. package/dist/assets/marketplace/plugins/ccl-skills/skills/requirement-baseline/agents/openai.yaml +4 -0
  366. package/dist/assets/marketplace/plugins/ccl-skills/skills/requirement-doc-writer/SKILL.md +130 -0
  367. package/dist/assets/marketplace/plugins/ccl-skills/skills/requirement-doc-writer/agents/openai.yaml +4 -0
  368. package/dist/assets/marketplace/plugins/ccl-skills/skills/requirement-doc-writer/references/prd-composition-contract.md +35 -0
  369. package/dist/assets/marketplace/plugins/ccl-skills/skills/requirement-doc-writer/references/requirement-closure-contract.md +86 -0
  370. package/dist/assets/marketplace/plugins/ccl-skills/skills/requirement-doc-writer/references/security-four-questions.md +38 -0
  371. package/dist/assets/marketplace/plugins/ccl-skills/skills/requirement-intent/SKILL.md +91 -0
  372. package/dist/assets/marketplace/plugins/ccl-skills/skills/requirement-intent/agents/openai.yaml +4 -0
  373. package/dist/assets/marketplace/plugins/ccl-skills/skills/requirement-scope/SKILL.md +88 -0
  374. package/dist/assets/marketplace/plugins/ccl-skills/skills/requirement-scope/agents/openai.yaml +4 -0
  375. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/SKILL.md +337 -0
  376. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/agents/openai.yaml +4 -0
  377. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/analysis-parse-fix-test-challenge-replay.md +47 -0
  378. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/attribution-verification.md +69 -0
  379. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/bootstrap-slim-c3-obligation-table.md +112 -0
  380. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/coverage-exhaustion-traps.md +45 -0
  381. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/description-authoring.md +162 -0
  382. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/dual-track-review-gate.md +507 -0
  383. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/eval-routing.md +86 -0
  384. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/evidence-card-template.md +51 -0
  385. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/example-domain-preselect.md +79 -0
  386. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/external-practice-controls.md +57 -0
  387. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/extraction-lifecycle-handoff.md +65 -0
  388. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/extraction-quickstart.md +194 -0
  389. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/firing-point-placement.md +75 -0
  390. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/harness-patterns-and-eval.md +286 -0
  391. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/incident-postmortem-extraction.md +190 -0
  392. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/l0-l1-l2-routing.md +114 -0
  393. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/online-skill-review.md +47 -0
  394. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/parallel-stack-references-pattern.md +164 -0
  395. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/r0-leakage-audit.md +90 -0
  396. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/recurring-anti-patterns-checklist.md +320 -0
  397. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/resume-paused-delivery.md +16 -0
  398. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/review-feedback-mining.md +33 -0
  399. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/review-finding-standards.md +57 -0
  400. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/review-rubric.md +40 -0
  401. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/rule-consolidation.md +118 -0
  402. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/skill-listing-budget.md +19 -0
  403. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/source-register.md +254 -0
  404. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/source-to-skill-extraction.md +658 -0
  405. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/two-source-extraction-pattern.md +167 -0
  406. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/uiux-judgment-extraction.md +179 -0
  407. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/uiux-routing-map.md +51 -0
  408. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/references/validation-and-landing.md +180 -0
  409. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/AGENTS.md +18 -0
  410. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/check-ccl-skills.sh +1452 -0
  411. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/check-evidence-card-leak.sh +491 -0
  412. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/check-mr-target-freshness.sh +173 -0
  413. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/check-size-budget.sh +488 -0
  414. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/check-sync-pointers.sh +419 -0
  415. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/eval-golden-trace.rb +197 -0
  416. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/eval-health.rb +327 -0
  417. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/eval-routing-bank.rb +401 -0
  418. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/eval-routing.rb +248 -0
  419. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/generic-r0-leak-scan.sh +282 -0
  420. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/governing-chain-diff.py +321 -0
  421. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/impact-chain-gate.rb +964 -0
  422. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/register-firing-path-resolution.rb +708 -0
  423. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/skill-behavior-eval.py +540 -0
  424. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/source-register-lifecycle.rb +51 -0
  425. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/source-register-pending-status.rb +55 -0
  426. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_ai_coding_implementation_gates.sh +829 -0
  427. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_check_ccl_impact_chain_refscripts.sh +1203 -0
  428. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_check_ccl_r0_status.sh +75 -0
  429. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_check_ccl_register_pending_exclusion.sh +137 -0
  430. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_check_ccl_regressions.sh +173 -0
  431. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_check_ccl_route_drift.sh +377 -0
  432. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_check_ccl_size_budget.sh +833 -0
  433. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_check_ccl_skill_catalog.sh +491 -0
  434. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_check_ccl_source_register_lifecycle.sh +114 -0
  435. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_check_mr_target_freshness.sh +261 -0
  436. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_check_sync_pointers.sh +538 -0
  437. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_controlled_escalation_pins.sh +154 -0
  438. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_eval_routing_bank_grader_diagnostics.sh +190 -0
  439. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_eval_routing_bank_surface_binding.sh +178 -0
  440. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_eval_routing_prose_target.sh +86 -0
  441. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_generic_r0_leak_scan.sh +131 -0
  442. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_git_identity_predicate_gate.sh +243 -0
  443. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_governing_chain_diff.sh +419 -0
  444. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_impact_chain_gate_dateless_host.sh +120 -0
  445. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_register_firing_path_resolution.sh +724 -0
  446. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_register_firing_path_wiring.sh +414 -0
  447. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_regression_runner_registration.sh +34 -0
  448. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_routing_bank_integrity.sh +205 -0
  449. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_routing_pointer_integrity.sh +194 -0
  450. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_validate_skill_credential_cwd.sh +61 -0
  451. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_validate_skill_cross_refs.sh +111 -0
  452. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/test_validate_skill_root_depth.sh +53 -0
  453. package/dist/assets/marketplace/plugins/ccl-skills/skills/skill-extraction-workflow/scripts/validate-skill.sh +257 -0
  454. package/dist/assets/marketplace/plugins/ccl-skills/skills/terminal-cli-dev/SKILL.md +98 -0
  455. package/dist/assets/marketplace/plugins/ccl-skills/skills/terminal-cli-dev/agents/openai.yaml +4 -0
  456. package/dist/assets/marketplace/plugins/ccl-skills/skills/terminal-cli-dev/references/input-state-machines.md +36 -0
  457. package/dist/assets/marketplace/plugins/ccl-skills/skills/terminal-cli-dev/references/streaming-rich-output.md +130 -0
  458. package/dist/assets/marketplace/plugins/ccl-skills/skills/terminal-cli-dev/references/terminal-side-channels.md +96 -0
  459. package/dist/assets/marketplace/plugins/ccl-skills/skills/test-artifact-management/SKILL.md +408 -0
  460. package/dist/assets/marketplace/plugins/ccl-skills/skills/test-artifact-management/agents/openai.yaml +4 -0
  461. package/dist/assets/marketplace/plugins/ccl-skills/skills/test-artifact-management/references/AGENTS.md +18 -0
  462. package/dist/assets/marketplace/plugins/ccl-skills/skills/test-artifact-management/references/bitable-setup.md +573 -0
  463. package/dist/assets/marketplace/plugins/ccl-skills/skills/test-artifact-management/references/ci_templates/README.md +120 -0
  464. package/dist/assets/marketplace/plugins/ccl-skills/skills/test-artifact-management/references/ci_templates/github-actions.yml +119 -0
  465. package/dist/assets/marketplace/plugins/ccl-skills/skills/test-artifact-management/references/ci_templates/gitlab-ci.yml +76 -0
  466. package/dist/assets/marketplace/plugins/ccl-skills/skills/test-artifact-management/references/ci_templates/jenkins.Jenkinsfile +106 -0
  467. package/dist/assets/marketplace/plugins/ccl-skills/skills/test-artifact-management/references/classical-test-design-techniques.md +279 -0
  468. package/dist/assets/marketplace/plugins/ccl-skills/skills/test-artifact-management/references/gen_report.py +2807 -0
  469. package/dist/assets/marketplace/plugins/ccl-skills/skills/test-artifact-management/references/makefile-template.md +200 -0
  470. package/dist/assets/marketplace/plugins/ccl-skills/skills/test-artifact-management/references/report-config-schema.md +272 -0
  471. package/dist/assets/marketplace/plugins/ccl-skills/skills/test-artifact-management/references/run_pytestless.py +475 -0
  472. package/dist/assets/marketplace/plugins/ccl-skills/skills/test-artifact-management/references/source-to-case-workflows.md +258 -0
  473. package/dist/assets/marketplace/plugins/ccl-skills/skills/test-artifact-management/references/tc-marker-conventions.md +316 -0
  474. package/dist/assets/marketplace/plugins/ccl-skills/skills/test-artifact-management/references/tc-review-and-prioritization.md +145 -0
  475. package/dist/assets/marketplace/plugins/ccl-skills/skills/test-artifact-management/references/tc_helpers/AGENTS.md +16 -0
  476. package/dist/assets/marketplace/plugins/ccl-skills/skills/test-artifact-management/references/tc_helpers/tc.dart +129 -0
  477. package/dist/assets/marketplace/plugins/ccl-skills/skills/test-artifact-management/references/tc_helpers/tc.go +197 -0
  478. package/dist/assets/marketplace/plugins/ccl-skills/skills/test-artifact-management/references/tc_helpers/tc.py +135 -0
  479. package/dist/assets/marketplace/plugins/ccl-skills/skills/test-artifact-management/references/tc_helpers/tc.ts +285 -0
  480. package/dist/assets/marketplace/plugins/ccl-skills/skills/test-artifact-management/references/test_gen_report.py +2144 -0
  481. package/dist/assets/marketplace/plugins/ccl-skills/skills/test-artifact-management/references/update-lifecycle.md +62 -0
  482. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/SKILL.md +212 -0
  483. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/agents/openai.yaml +4 -0
  484. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/references/ci-fixtures-and-flake-control.md +75 -0
  485. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/references/client-runtime-test-matrices.md +50 -0
  486. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/references/data-and-workflow-testing.md +34 -0
  487. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/references/design-closed-contract-oracles.md +31 -0
  488. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/references/e2e-real-flow-testing.md +71 -0
  489. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/references/fitness-functions.md +240 -0
  490. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/references/integration-contract-testing.md +235 -0
  491. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/references/non-functional-specialized-scenarios.md +296 -0
  492. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/references/rd-testing-standard-template.md +126 -0
  493. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/references/run-killing-mutation-walk.md +43 -0
  494. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/references/scenario-testing.md +136 -0
  495. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/references/source-evidence-map.md +59 -0
  496. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/references/structured-tc-input-translation.md +67 -0
  497. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/references/test-code-authoring-patterns.md +392 -0
  498. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/references/test-data-and-determinism.md +39 -0
  499. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/references/test-topology-and-commands.md +92 -0
  500. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/references/unit-testing.md +46 -0
  501. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/references/vendored-contract-drift-checklist.md +64 -0
  502. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/references/verify-enforcement-mechanisms.md +18 -0
  503. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/scripts/AGENTS.md +17 -0
  504. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/scripts/client-terminal-ansi-check.py +140 -0
  505. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/scripts/client-terminal-ansi-check.test.sh +75 -0
  506. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/scripts/lang-basics-ast-check.py +170 -0
  507. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/scripts/lang-basics-ast-check.test.sh +87 -0
  508. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/scripts/lang-basics-go-check.go +198 -0
  509. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/scripts/lang-basics-go-check.test.sh +109 -0
  510. package/dist/assets/marketplace/plugins/ccl-skills/skills/testing-strategy/scripts/test_mutation_backup_recipe.sh +237 -0
  511. package/dist/assets/marketplace/plugins/ccl-skills/skills/tighten-doc/SKILL.md +184 -0
  512. package/dist/assets/marketplace/plugins/ccl-skills/skills/tighten-doc/agents/openai.yaml +4 -0
  513. package/dist/assets/marketplace/plugins/ccl-skills/skills/tighten-doc/references/comment-safe-feishu.md +93 -0
  514. package/dist/assets/marketplace/plugins/ccl-skills/skills/tighten-doc/references/cross-model-co-review.md +3 -0
  515. package/dist/assets/marketplace/plugins/ccl-skills/skills/tighten-doc/references/delivery-face-closeout.md +60 -0
  516. package/dist/assets/marketplace/plugins/ccl-skills/skills/tighten-doc/references/doc-charter-first.md +17 -0
  517. package/dist/assets/marketplace/plugins/ccl-skills/skills/tighten-doc/references/session-vantage-leakage.md +58 -0
  518. package/dist/assets/marketplace/plugins/ccl-skills/skills/web-react-dev/SKILL.md +126 -0
  519. package/dist/assets/marketplace/plugins/ccl-skills/skills/web-react-dev/agents/openai.yaml +4 -0
  520. package/dist/assets/marketplace/plugins/ccl-skills/skills/web-react-dev/references/complex-workspace-patterns.md +47 -0
  521. package/dist/assets/marketplace/plugins/ccl-skills/skills/web-react-dev/references/embedded-h5-in-host.md +87 -0
  522. package/dist/assets/marketplace/plugins/ccl-skills/skills/web-react-dev/references/react-architecture.md +194 -0
  523. package/dist/assets/marketplace/plugins/ccl-skills/skills/web-react-dev/references/source-evidence-map.md +60 -0
  524. package/dist/assets/marketplace/plugins/ccl-skills/skills/web-react-dev/references/web-quality-release.md +190 -0
  525. package/dist/assets/marketplace/plugins/ccl-skills/skills/web-react-dev/references/web-ui-quality.md +83 -0
  526. package/dist/assets/marketplace/plugins/ccl-skills/skills/worktree-isolation/SKILL.md +179 -0
  527. package/dist/assets/marketplace/plugins/ccl-skills/skills/worktree-isolation/agents/openai.yaml +4 -0
  528. package/dist/assets/marketplace/plugins/ccl-skills/skills/worktree-isolation/references/shared-branch-rebase.md +25 -0
  529. package/dist/assets/marketplace/plugins/ccl-skills/skills/worktree-isolation/scripts/AGENTS.md +23 -0
  530. package/dist/assets/marketplace/plugins/ccl-skills/skills/worktree-isolation/scripts/test_worktree_status.sh +207 -0
  531. package/dist/assets/marketplace/plugins/ccl-skills/skills/worktree-isolation/scripts/test_worktree_sweep.sh +481 -0
  532. package/dist/assets/marketplace/plugins/ccl-skills/skills/worktree-isolation/scripts/worktree-status.sh +325 -0
  533. package/dist/assets/marketplace/plugins/ccl-skills/skills/worktree-isolation/scripts/worktree-sweep.sh +245 -0
  534. package/dist/assets/release.json +2797 -0
  535. package/dist/claude-adapter.d.ts +9 -0
  536. package/dist/claude-adapter.js +240 -0
  537. package/dist/cli-worker.d.ts +1 -0
  538. package/dist/cli-worker.js +32 -0
  539. package/dist/cli.d.ts +22 -0
  540. package/dist/cli.js +214 -0
  541. package/dist/codex-host.d.ts +30 -0
  542. package/dist/codex-host.js +162 -0
  543. package/dist/fs-safe.d.ts +21 -0
  544. package/dist/fs-safe.js +241 -0
  545. package/dist/index.d.ts +2 -0
  546. package/dist/index.js +1 -0
  547. package/dist/manifest.d.ts +8 -0
  548. package/dist/manifest.js +135 -0
  549. package/dist/opencode-adapter.d.ts +10 -0
  550. package/dist/opencode-adapter.js +416 -0
  551. package/dist/operations.d.ts +3 -0
  552. package/dist/operations.js +956 -0
  553. package/dist/paths.d.ts +20 -0
  554. package/dist/paths.js +4 -0
  555. package/dist/types.d.ts +58 -0
  556. package/dist/types.js +1 -0
  557. package/dist/unified.d.ts +4 -0
  558. package/dist/unified.js +64 -0
  559. package/dist/version.d.ts +2 -0
  560. package/dist/version.js +5 -0
  561. package/package.json +35 -0
@@ -0,0 +1,75 @@
1
+ # Firing-point placement — worked recurrence-chain + the owner-dispatch implementation
2
+
3
+ Companion to the **firing-point-placement corollary** in `SKILL.md` (under *Retrospectives, corrections & auto-triggered learning*, in the repeated-user-corrections rule). The Core Rule carries the gates: under-trigger is a tracked failure class; the self-trigger is recognition-dependent (bootstrap raises salience but is not mechanical); the two mechanical backstops (closeout gate + user-signal escalation); and the red-line — when the same meta-class recurs at a *new* sub-point, move the owning gate's firing point ONTO the transition and sharpen *name→invoke*, not more prose. This file carries the **worked recurrence-chain** (the concrete history that justifies the corollary), the **landed mechanical implementation** for the owner-invoke case, and two expansions relocated from the Core Rule: the self-detect firing point's authority boundary + observed shape, and the record-field corollary's forgery-surface mechanics. The gates themselves stay in the Core Rule.
4
+
5
+ ## The worked recurrence-chain (why "move the firing point", not "add another bullet")
6
+
7
+ The same meta-class — a rule is precise but is walked past at the routing → pre-code-gate / → first-implementation-edit transition — recurred at a *new* lifecycle sub-point each time, despite prior bootstrap-salience and a completion-time closeout gate:
8
+
9
+ 1. **entry-routing** — landed in the bootstrap layer.
10
+ 2. **impl-entry** — then recurred at the first-implementation-edit transition; landed in the owner workflow.
11
+ 3. **design-substance ownership** — design produced by the router + an external/codex review, with no owner stack skill invoked.
12
+ 4. **impl-mechanics ownership** — the impl-owner skill was **named/known but never invoked**, so its own current mechanical rules (e.g. directory-`AGENTS.md` sync) never fired across a multi-slice loop until the user flagged it.
13
+ 5. **design-gate ownership** — the visible-UI design-gate owner, named in the coordinator's visible-UI checkpoint clause + the stack owner's body but **never invoked** before a visible-UI slice (even though the impl-mechanics owner WAS invoked), so the page-slice gate never ran until the user asked whether the design skill was used.
14
+
15
+ The lesson: a repeat at a new sub-point signals the prior firing point was under-specified. **Naming/knowing an owner is not invoking/loading it** — a named-but-unloaded owner's mechanical rules never fire. The durable lever is to move the owning gate's firing point ONTO the transition itself (pre-substance-draft AND pre-first-impl-edit) and sharpen *name→invoke* at the SAME transition, rather than adding a downstream bullet or more prose. And note the honest limit: a completion-time "interim until the map exists" check does not fire if the agent produces+completes the substance without ever building the map — so the closeout gate + user-signal escalation remain the real-world backstops (do not overclaim the moved firing point is mechanical).
16
+
17
+ ## The landed mechanical implementation (owner-invoke case)
18
+
19
+ For the specific owner-dispatch case, the firing point is now **mechanically enforceable where the plugin hooks + a wired CI gate are present** (not merely prose):
20
+
21
+ - `owner-dispatch` PreToolUse/Stop hooks (`hooks/owner-dispatch-guard.sh`, `hooks/owner-dispatch-stop.sh`) gate the first product-code edit and session close.
22
+ - **Subagent extension** (delegated workers are a separate firing surface — SessionStart routing is NOT inherited by subagents, so a cold worker never sees the gate): `SubagentStart` (`hooks/subagent-start.sh`) injects a slim self-gating routing pointer, and `SubagentStop` reuses `owner-dispatch-stop.sh` (PreToolUse already fires inside subagents) with `agent_id`-scoped, actor-precise markers/cap so the invoke-owner backstop applies one level down for a worker's **path-attributable** gated Edit/Write (Bash-only and missing-baseline cases stay advisory under the session Stop / CI backstop, not SubagentStop). This closes the recurrence where `multi-agent-delegation` had to *manually* inject owners into every worker prompt (`skills/multi-agent-delegation/SKILL.md` Core Rules) and the user reminded when it was forgotten.
23
+ - `scripts/owner-dispatch/owner-dispatch.sh ci` is the host-agnostic merge backstop (engine: `scripts/owner-dispatch/owner-dispatch.sh`; rationale + safety posture: `scripts/owner-dispatch/README.md`).
24
+
25
+ This is the worked example of moving an already-precise recognition-dependent gate ONTO the transition. **Honesty preserved — enforcement is partial, not total:** opt-in per product repo (`.owner-dispatch.json`), default `ask`, fail-open, Claude-hook-hard / Codex-advisory, in-session Bash-write detection is best-effort (the un-bypassable layer is CI, and only when the CI job itself is enforced), and the whole thing is a no-op on the generic Agent-Skills channel. So it raises enforcement where the plugin/hook + CI layers load, but the closeout gate + user-signal escalation remain the backstop everywhere they do not. The opt-in gap itself is now narrowed by a **closeout-acquire check** in `product-rd-workflow` (a gated multi-owner delivery whose repo lacks `.owner-dispatch.json` installs the backstop or records exempt at closeout) — so "silently absent" is caught, though still recognition-dependent at closeout, not a hard gate.
26
+
27
+ **When a future recognition-dependent gate recurs, prefer building the analogous in-session-hook + CI-backstop pair over adding more prose.**
28
+
29
+ ## Recursive worked example: the gate's own agent-facing guidance must also sit at the seen surface
30
+
31
+ The same placement principle applies to the *guidance about the gate*, not only the gate. The clarification — *a `deny`/`ask`/`Stop` is the agent's to clear by invoking owners + `record`, **not** a user-authorization prompt (it clears only this gate; merge/push/destructive/scope/product decisions still need the user); and `strict:true` is a maintainer/committed-config decision, not an agent prompt-reduction knob* — originally lived only as `scripts/owner-dispatch/README.md` prose. An agent does not auto-read reference files, so it misread the runtime `ask` prompts as per-edit *user* authorization and pushed the approvals onto the user. Fix: move that one-liner onto the surfaces the agent actually reads at the firing moment — the `deny`/`ask`/`Stop` **message text** and the always-on `agent-context/session-start.md` — keeping the full rationale in the README. Same lesson, one level up: a precise clarification in an unread doc does not fire; place it where it is seen when it matters.
32
+
33
+ ## The self-detect firing point — authority boundary and observed shape (relocated from `SKILL.md`)
34
+
35
+ When the self-detect firing point fires (your own output names 沉淀 / 提炼 / 复盘 / "distil this into a skill" as a recommended or deferred next action), concretely: invoke the workflow and do the read-only part (charter, RCA, owner map) rather than parking it as a low-priority follow-up; but **shared-skill edits still need the authority you already have** — when the user's request covered only a status review or a narrow fix, record the extraction as `pending` with the owner named and ask, instead of self-authorising a shared-skill change off your own suggestion. Observed shape: the agent proposes "沉淀方法论" as one of several optional next steps, the user answers "是应该沉淀", and only then is the workflow invoked — so recognition was owed one turn earlier, while the edit authority arrived with the user's answer.
36
+
37
+ ### The output-shape sibling — your own deliverable names the owner the entry phrasing did not
38
+
39
+ The self-detect firing point above triggers on what your output *mentions*; this one triggers on what your output *has become*. Entry phrasing and deliverable shape diverge routinely — the request reads as a narrow how-to ("how do I configure X"), and the answer grows into candidate comparison, rejection rationale, and a recommendation. At that point the deliverable is a selection/assessment artifact regardless of how the request was worded, and the owner that governs it never entered.
40
+
41
+ Walk these three shapes against your own draft — holding them as one conjunction is what fails, so check them one at a time. Any single hit means the deliverable is a selection/assessment artifact regardless of how the request was worded:
42
+
43
+ Throughout, **candidate** means a component, service, product, library, vendor, or replacement that is actually up for selection — never a configuration value, parameter, or technique when nothing is being selected. Comparing fixed delay with exponential backoff inside a how-to is not a candidate comparison.
44
+
45
+ - Named candidates compared side by side.
46
+ - An adopt / reject / replace verdict on a named candidate — "just use X" counts, with or without a comparison.
47
+ - As-is evidence gathered across several artifacts to support such a verdict.
48
+
49
+ - **On any hit, re-judge the entry owner before writing further** — you must not keep writing under the initial narrow classification, because the gates that would have constrained the work (research routing before a selection verdict, named-source-plus-freshness discipline on as-is claims) hang off that owner; with no owner in play, none of them fire, and the output looks complete while resting on unexamined evidence.
50
+
51
+ A fourth trigger on recommendation *wording* was tried and removed: it kept firing on ordinary how-to advice that prefers one configuration value or technique over another ("enable jitter", "prefer exponential backoff over fixed delay") while adding no coverage, because recommending a named candidate is already an adopt verdict. The three that remain key on the deliverable's SHAPE, which is what this section is about; a wording-keyed trigger drifts back toward matching phrases.
52
+
53
+ Observed shape: an entry judged as configuration how-to produced several rounds of candidate comparison and a recommendation; the current-state evidence discipline and the research-routing rule both stayed dormant for the whole stretch, surfacing only when the user challenged what the conclusion rested on. Same honesty bound as the rest of this section — this is recognition-dependent and must not be overclaimed as a mechanical gate; what is self-checkable is the shape of your own output, not the intent behind the request.
54
+
55
+ ## The record-field corollary — expansion (the forgery surface, relocated from `SKILL.md`)
56
+
57
+ When you land an owner gate as a *field in a record* — a checklist row, a boundary-record line, a CLI flag taking owner names, a "decision:" slot — that field is fillable without invoking the owner, and filling it is what *feels* like discharging the gate, so the record reads complete while none of the owner's mechanical rules fired. Any field naming an owner therefore carries an explicit invoke bar on its triggered values, and the coverage question is a **set-diff over every owner-naming field in that record**, not a fix for the one owner that just failed (the recurrence shape: a record whose salient fields carry the bar while its siblings silently do not). Prefer a firing point the controller cannot route around: when the gated action produces no local artifact — delegation dispatch being the worked case, where substance is produced by a worker and the controller edits nothing — every edit-triggered and dirty-tree-triggered backstop stays silent, so the gate must hang on the action itself (`hooks/guard-delegation-owner.sh` asks once per session at dispatch when the delegation owner was never invoked).
58
+
59
+ ### The IMPOSSIBLE-invocation value (a bar with no legal third value forges itself)
60
+
61
+ An invoke bar — or a mandatory-read/mandatory-load gate ("read `X.md` before answering") — **that names no legal value for the case where the invocation is IMPOSSIBLE (no file tool in this session, artifact absent, load fails) forges itself.** Such gates are usually written as a pair: skipping the read is forbidden AND answering from memory is *also* a violation. When the read is unavailable, every action the agent can take is a violation, so the cheapest exit is to assert the gate was satisfied — and if the gate's evidence is a fixed attestation string, that string is emitted by an agent that read nothing and the record reads compliant to every downstream consumer.
62
+
63
+ So every such gate defines a **third legal value — an unavailable form textually distinct from the satisfied form** (`依据: 不可得(<reason>)` vs the satisfied `依据: <path>`). Two placement rules make it real:
64
+
65
+ - The unavailable value must sit on a surface still reachable when the artifact is not — the `SKILL.md` or always-on layer; a branch written only into the file you cannot read never fires.
66
+ - The gap that value records is the risk owner's to close: the agent must not self-accept it, and the requesting party must not either — a requester who can self-accept can trigger or claim a read failure and bypass the gate entirely.
67
+
68
+ Honest scope, from the eval that landed this (2 arms x 5 fixtures x 6 samples in a genuinely tool-restricted environment, oracle canary-validated): adding the third value moved the **record form** (legal unavailable record 0/30 -> 29/30; ad-hoc refuse-and-leave-blank 18/30 -> 0/30), and did **not** demonstrate a drop in fabrication — the motivating "agent claims it read the file" did not reproduce at all (0/30 in the unpatched arm, where an always-on no-evidence-no-completion-claim layer was present). Claim the auditability gain, not a forgery-prevention gain; if a true 10% fabrication rate is suspected, 0/30 is only ~4% likely under it, so the premise is weakened for that configuration, not refuted for every host.
69
+
70
+
71
+ ## The tool-skill-masks-deliverable-owner variant — a loaded platform/tool skill is not the deliverable owner
72
+
73
+ Observed shape: a session produces a reader-facing deliverable end-to-end through a platform/tool skill pack (a collaborative-doc platform, spreadsheet, or browser pack), and the loaded tool skill supplies enough "already being guided" feeling that nobody ever asks which skill owns the DELIVERABLE's quality bar — so the finalization owner's gates (doc charter, completeness audit, closeout sweep, structural-reference re-resolution) stay dormant for the whole effort, surfacing only when the user asks "did you run the doc-optimization skill". This is the behavioral twin of the digest-masks-corpus trap: the tool layer's presence masks the owner layer's absence.
74
+
75
+ Firing point: **producing or first-publishing a reader-facing deliverable is an owner-check transition** — before the first publish to a collaborative or reader-visible surface, answer "which skill owns this deliverable's quality bar" as a separate question from "which tool writes it"; a tool-skill invocation never discharges that check, and a deliverable with no matching owner routes to the finalization skill's Draft mode rather than proceeding ownerless. Mechanical anchors: the no-owner-deliverable triggers on the finalization skill's routing surface (`tighten-doc` description), and this workflow's closeout gate when the session later lands skill changes. Honesty bound as elsewhere in this section: between those anchors the check is recognition-dependent — do not overclaim it as a mechanical gate.
@@ -0,0 +1,286 @@
1
+ # Harness Patterns & Skill Eval
2
+
3
+ 公开 harness / agent 文献里的成熟命名概念 + skill 系统的对应映射。让我们的 skill 互引用 / extraction / debug 时能用业内通用术语,而不是各自发明。
4
+
5
+ 不替代 Anthropic / OpenAI 等官方 harness 文档 — 这份只总结**与我们 skill 系统直接相关的部分**。
6
+
7
+ ## 外部来源(可核验)
8
+
9
+ - **Anthropic, "Building effective agents"** (anthropic.com/engineering/building-effective-agents, Dec 19 2024) — workflow vs agent 区分 + 5 workflow patterns(base taxonomy,不是最新 harness 指南)
10
+ - **Anthropic, "Building agents with the Claude Agent SDK"** (Sep 29 2025) + **"Effective harnesses for long-running agents"** (Nov 26 2025, anthropic.com/engineering/effective-harnesses-for-long-running-agents) + **"Writing effective tools for agents"** (Sep 11 2025) — 后续补充(long-running 已提炼入 §6)
11
+ - **Anthropic, "Harness design for long-running application development"** (anthropic.com/engineering/harness-design-long-running-apps, WebFetch 核 2026) — 比上一条更新:从一句话长跑**建完整应用**的 generator–evaluator–planner 三角色 harness(提炼入 §6.1)。这是 Anthropic 自己的 harness-design primary 例;社区"loop engineering / 写循环不写提示词"的公开说法(Cherny / Steinberger 等)是**相关但独立的二手讨论** —— 没有直接一手源就按 hypothesis 对待,别把本文当成那套口号的出处
12
+ - **Anthropic, "Effective context engineering for AI agents"** (2025, anthropic.com/engineering/effective-context-engineering-for-ai-agents) — context 即稀缺资源 / compaction / 结构化笔记 / JIT 检索 / context rot(提炼入 §5)
13
+ - **Anthropic, "Demystifying evals for AI agents"** (Jan 09 2026) — agent eval 方法(realistic tasks / robust criteria / multiple graders / transcripts)
14
+ - **Anthropic Claude Code sub-agent docs**(Claude Code 官方文档 sub-agents 段)— sub-agent 隔离 / 独立 context window / 独立 permission
15
+ - **SWE-bench** (Jimenez et al., arXiv 2023, ICLR 2024, Princeton + UChicago) — agent 在真 GitHub issues 上的 task replay eval
16
+ - **Aider benchmarks / leaderboard** (aider.chat/docs/leaderboards/) — code editing/refactoring 固定 task set + pass rate
17
+ - **AutoGen** (Microsoft Research, 2023) — multi-agent conversation framework
18
+ - **LangGraph** (LangChain, 2024) — graph-based agent orchestration
19
+ - **mem0 / MemGPT / Letta** — agent memory layering
20
+ - **OpenSSF Scorecard** (github.com/ossf/scorecard) — 仓库安全/健康度评分:**每 check 0–10 → 按风险加权聚合 0–10**(Critical=10 / High=7.5 / Medium=5 / Low=2.5),weekly 扫 + 公开 BigQuery 数据集追历史。直接印证"加权 0–10 综合分 + 趋势"是业内做法(§3.4 的外部锚)
21
+ - **Goodhart's law**(Goodhart 1975,英格兰货币政策;Strathern 1997 普及化:"When a measure becomes a target, it ceases to be a good measure")— 度量一旦成为目标就被博弈优化、失去原效。§3.4 综合分**只做 advisory 不当 gate**、历史文件 git-ignore 的依据
22
+ - **Eval-driven development**(evaldriven.org + Braintrust 等多个独立 practitioner 源)— 改动前先写 eval/场景、每次改动跑同一套、**绝不为过测试而特判 eval**;把"改了才发现"提前成"改前就量"。§3.2 的 authoring-time RED-baseline + F4 防作弊(冻结 task、改 skill 顺手改测试告警)即此实践;映射的"watch it fail first"= TDD red-green(`superpowers` owns)
23
+
24
+ ---
25
+
26
+ ## §1 Workflow vs Agent + 5 workflow patterns
27
+
28
+ **定义**(Anthropic 2024-12 — base taxonomy;后续 Agent SDK / long-running harness / evals 帖子补充更细落地):
29
+
30
+ - **Workflow**:LLM 与 tool 通过**预定义代码路径**编排(执行流程是人写死的)
31
+ - **Agent**:LLM **自主决定**下一步动作和 tool 使用(执行流程由模型决策)
32
+
33
+ Workflow 更适合可预测 / 可调试 / 可控成本的任务;agent 更适合开放领域 + 任务边界模糊。先从简单 workflow 起手,只在真需要 model-directed 决策时才升级到 agent。
34
+
35
+ **Anthropic workflow taxonomy 的 5 个 patterns**(按复杂度递增;非"所有 harness patterns"穷举 — ReAct / Reflexion / Tree-of-Thoughts / planning-search 等 agent 类 pattern 不在该 taxonomy):
36
+
37
+ | Pattern | 形态 | 我们映射 |
38
+ |---|---|---|
39
+ | **Prompt chaining** | step 1 → step 2 → step 3 顺序,每步输出是下步输入;中间可加 gate check | 多轮 codex review(迭代收口);`source-to-skill-extraction.md` 的 charter → source register → draft → validate 顺序 |
40
+ | **Routing** | input classifier 决定走哪个下游 path | **SKILL.md `Use when` / `Skip when`** + 跨 skill 路由;`product-rd-workflow` 路由到 stack-dev |
41
+ | **Parallelization** | 独立子任务并发执行,结果聚合。两子型:**Sectioning**(任务拆成独立块各跑)和 **Voting**(同任务多次跑取共识) | Sectioning = `multi-agent-delegation` 分发;**Voting = 同一改动并行跑 codex review + challenge** 两个独立视角(彼此不串行,结果聚合)|
42
+ | **Orchestrator-workers** | 中央 LLM 动态拆任务给 worker LLM,再聚合结果 | `product-rd-workflow` orchestrate + stack-dev workers |
43
+ | **Evaluator-optimizer** | 一 LLM 产出,另一 LLM 评估并给反馈,循环迭代 | **顺序的 review → fix → re-review 循环**(与 Voting 区别:是串行 + 迭代,不是并行 + 投票)|
44
+
45
+ **用**:写 skill / 设计新 workflow 时,先识别这是哪种 pattern(不识别会导致命名混乱:把 voting 写成 evaluator-optimizer、把 routing 写成 chaining 等,跨 skill 文档读起来不一致);用通用术语描述以便互引用清晰。
46
+
47
+ **不用**:纯 chat-based 单次回答不算 workflow;不必硬套 5 patterns;agent 类(ReAct / Reflexion 等)超出此 taxonomy。
48
+
49
+ **落地**:
50
+ - 跨 skill 路由文档里直接用 `routing / orchestrator-workers / evaluator-optimizer` 术语
51
+ - 解释自动化流程时优先用 workflow 命名(更可预测),只在边界模糊时退到 agent
52
+ - 区分**有 gate 的 chaining**(推荐)vs **裸 chaining**(脆弱)— 失败模式:裸 chaining step N 失败时整链失败,无中间产物可继续;有 gate 的 chaining 每步 validate 后可在中间点止损 / 切策略
53
+
54
+ ---
55
+
56
+ ## §2 Sub-agent isolation patterns
57
+
58
+ **定义**(Anthropic Claude Code docs + 业内通用):sub-agent 是**独立 context window** 的工作单元 — 不继承父 agent 的对话历史,由父 agent 通过 prompt 显式传递必要上下文。
59
+
60
+ **Why isolation matters**:
61
+ - **Context 不污染**:父 agent 的失败尝试 / 错误推理不传染给 sub-agent
62
+ - **Cost 可控**:sub-agent 用完即弃,不累积 token
63
+ - **Failure 可定位**:sub-agent 失败只回报 result,父 agent 决定 retry / escalate / proceed
64
+
65
+ **典型 isolation 失败模式**(**内部命名的 isolation failure checklist**,非业内 literature 标准命名 — 自用方便定位失败种类):
66
+
67
+ | 失败 | 症状 | 修 |
68
+ |---|---|---|
69
+ | **Context starvation** | 父 agent prompt 太短 / 模糊,sub-agent 缺关键信息硬编 | prompt 必含:任务目标 + 已有 context 摘要 + 期望输出形状 + 边界("不要做 X")|
70
+ | **Result inflation** | sub-agent 返回大段 raw output,污染父 agent context | prompt 显式 "report in under N words" + 结构化字段 |
71
+ | **Hidden dependency** | sub-agent 默认能读某文件 / 调某 tool,父 agent 没确认 | prompt 明确列可用工具 + 文件路径 |
72
+ | **Trust drift** | sub-agent 自信报告"完成",实际只完成一部分 | 父 agent 用独立 verification(read diff / grep / 跑 test)核对,不只看 sub-agent 自述 |
73
+
74
+ **在本 scheme 怎么落**:
75
+ - `multi-agent-delegation` skill 主体覆盖 isolation 决策;本 ref 补充失败模式 checklist
76
+ - 用 sub-agent 后**必须独立核对结果**(reading diff / grep specific changes),不依赖 sub-agent self-report
77
+
78
+ ---
79
+
80
+ ## §3 Skill effectiveness eval(task replay / before-after / golden trace)
81
+
82
+ **定义**(**内部 skill eval 方法 — 受 SWE-bench / Aider leaderboard / Anthropic 2026 evals 启发的本团队 recipe**,非已发表的命名方法):业内 agent eval 走固定 task-set + golden answer 比对(SWE-bench / Aider 是此类)。Anthropic 2026 evals 文章强调 realistic tasks / robust success criteria / multiple grader types / 读 transcript(不只看 final prose)。
83
+
84
+ 我们的 skill 没有这样的 benchmark。**真问题**:怎么知道 skill 改动是变好还是变坏?
85
+
86
+ 3 个可落地方法(轻重排):
87
+
88
+ ### 3.1 Before-after task diff(轻量)
89
+
90
+ **跑之前先过 consolidation 检查**(canonical 在 `SKILL.md` 的 `Consolidate and retire rules` 条,不在这里重复):候选若是"往既有技能加文本"型,那条规则要求先找同 failure-class 的既有 owner 并**合并**——那是合并决策,不是一个待验的新增文本,别拿 eval 给重复落地放行。本处只加一条读数纪律:**别把零差分读成"这类文本一律无效"**。实测踩过一次:一条候选原理句被既有的一条判定规则整条覆盖,5 任务 16 次跑两臂行为无差异,唯一差别是 agent 引用时换了措辞;把那个结果当通用结论,就是把一次选题失误记成了规律。
91
+
92
+ 每次 skill 重大改动前:
93
+ 1. 在 changed skill 触发场景下记录**预先冻结的 task set 中代表性 task** 的 agent 行为(任务描述 + tool calls + final output)
94
+ 2. 改动后跑同一 task,diff 两次行为
95
+ 3. **diff 显示行为**朝预期改善 = 改动有效;恶化 = 反效;**unchanged 不在这一步定性**——按下面 anti-game 最后一条先分清成因再下结论
96
+
97
+ **Anti-game 要求**(防止 agent 自选简单 task 造假证):
98
+ - **Task bank 在 skill 改动之前就冻结**,agent 不能改动后再挑 task
99
+ - 抽样必含历史失败 / user correction / known regression case,不只 happy path
100
+ - 至少 1 个 hard / control case(agent 改不动也不该挂的 task)
101
+ - reviewer 或 challenger 核准 task 抽样
102
+ - 成功标准 改前定义 (specific assertions on output / behavior)
103
+ - 比对 **transcript + outcome**,不只 final prose(per Anthropic 2026 evals)
104
+ - **两臂无差异时不得在这一步定性为该文本无用**:成因至少两种——既有规则已覆盖该 failure-class(那是合并决策,见上),或该行为在 host 基线上本就存在。要分清得另取证据,**本节不规定取法**:低 N、臂配置混杂、以及"只给对照臂换夹具或换权限就多一个变量"这三样让这类归因很容易做错,宿主自身系统层也始终在场。取不到可靠证据就把成因判为**未确定**,别猜一个填上——本节判"改动有没有效"的对照始终是 before/after 两臂
105
+
106
+ 实测踩过的那次里,零差分的成因是既有规则已覆盖,不是这句话本身无效。
107
+
108
+ **用**:本 skill `skill-extraction-workflow` 自身的 R0 / drafting 类大改动;产品 skill 的 routing 调整。
109
+
110
+ ### 3.2 Golden trace(中量)
111
+
112
+ 为每个 stable skill 沉淀 1-2 个 **golden agent trace**:
113
+ - 触发 prompt("写测试用例 for 这个 module")
114
+ - 期望 agent 行为序列("读源 → 跑 testing-strategy → 写矩阵 → 入 Bitable")
115
+ - 期望最终产出("N 条 TC + matrix")
116
+
117
+ skill 改动后,让 agent 重跑这条 trace,**结构性偏离 = 回归信号**。
118
+
119
+ **用**:被多 skill 引用的 hub skill(`product-rd-workflow` / `defect-diagnosis` / `testing-strategy`)。
120
+
121
+ **不用**:单次或 niche skill — 写 golden trace 的成本 > 收益。
122
+
123
+ **双用途(authoring-time RED-baseline)**:同一条 golden-trace 机制(F4 Tier-3 `eval-golden-trace.rb`)除了**回归**,还可当**改技能前的 RED**——改前手动跑触发场景看真 agent 不带改动时是否**真的**路由错(**只有真观察到 miss 才算 RED**;PASS/INCONCLUSIVE 不算),改后再看 compliance。借的是 **eval-driven development** 的*原则*(改动前先量、绝不为过测试而特判),**不是**说这套小 N、advisory、只断言路由结构的回放有生产级 eval gating 的严谨度。落地契约 + 防作弊注意(优先用既有冻结 trace;同改动新写的 trace 是 self-authored 证据)见 [validation-and-landing.md](validation-and-landing.md) "Optional real-agent RED-baseline"。**可选**:小改动用**执行并记录**的 pressure scenario 即可。code 级 RED-GREEN 方法 route→`superpowers:writing-skills` + `:test-driven-development`,不抄。
124
+
125
+ ### 3.3 Behavioral task-set A/B(重量,system-wide 变更专用)
126
+
127
+ 学 SWE-bench 思路:维护一个固定的**行为夹具集**(每条 = 一个 prompt + 一条 rubric,覆盖一条纪律轴:安全反射 / 无证据不声称完成 / 回归测试负控 / 假绿识别 / re-entry gate / 测量先于断言 …),把**候选操作层**与**当前操作层**双臂并跑同一夹具集,逐夹具比行为。
128
+
129
+ **落地形态**(不再是"待用"):`skill-extraction-workflow/scripts/skill-behavior-eval.py` + `eval/behavior-fixtures.jsonl`(12 条起,与 `eval/routing-tasks.jsonl`、`eval/golden-traces/` 并列同一 `eval/` 语料区)。两臂:
130
+
131
+ - `current` —— 普通 `claude -p`:装好的 bootstrap + 全部 skills(当前操作层)。
132
+ - `candidate` —— `--settings '{"disableAllHooks":true}' --disable-slash-commands --append-system-prompt "$(候选契约)"`:**关掉 ccl-skills 的 bootstrap + skills**,把候选契约**追加**注入。注意这不是"唯一常驻层"——base Claude Code 系统层仍在;准确说法是"移除 ccl-skills 层后、以候选契约为附加操作层"。契约用 `--contract PATH`(或 env `CANDIDATE_CONTRACT`)传。
133
+
134
+ **输出 = 能力 delta 报告(这才是 A/B 的点)**:跑完双臂后产出 `capability-delta-report.md` + `judge-verdicts.jsonl` —— 逐夹具给"候选比当前**减少的能力** / **新增的能力** / **表现怎么变**"+ 汇总 delta 计数。delta 由 **LLM-judge**(一个模型读**两臂**回答、对着 rubric 轴推理行为)产出——这正是硬教训要求的"判断评分"的**自动形态**,不是关键词打分。它是 judgment-**assist** 非 score:原始回答留存可审、judge 对畸形输出拒绝猜判、每条 security/authority/data-loss 轴或低置信行标 🔴 HUMAN 待人眼确认。`--no-judge` 则只出**填空脚手架**(judge 不跑、由人填 delta)。别只把双臂回答堆一地叫"自己看"——工具**一定要产出 delta**。
135
+
136
+ **judge 的固有限度(诚实写清,别当它是权威裁决)**:(1) LLM-judge 读的是**不可信的模型输出**,理论上可被 answer 里的注入操纵——所以 answer 里出现指令状内容会**程序化强制标 🔴 HUMAN**(judge_prompt 里也 fence+禁止服从,双保险),但没有任何单行 verdict 在没核对原始回答前算权威。(2) 敏感轴的关键词表**永远不可能穷举**——它只是 best-effort 兜底;**真正权威的标记是夹具里显式 `"human": true`**,凡涉及 security/权限/隐私/PII/数据丢失/删除/计费/凭证 的夹具**必须**设它(见 `behavior-fixtures.jsonl` 里 F1/F5)。(3) 每行只取单 sample,多 sample 差异看 `.sN.txt`。incomplete(缺臂/陈旧/judge 报错/额度跳过)行**顶部横幅显式计数**,别把部分跑当满覆盖。(4) **invoke 证据 vs 自报(name≠invoke)**:agent 回答里"我先加载 owner 技能 X"是**自报**,不等于真调了 Skill 工具。harness 从 stream 里抓真实 `Skill` tool_use 记进 `# skills_invoked` 头(空则 `[]`)——这正是 owner-dispatch invocation-evidence 那条"验 invoke 别信 name"用在 eval 自身。**注意**:这个头是 `#` 注释头,`read_saved_response` 会把它剥掉,所以**自动 LLM-judge 看不到它**;它是**人工/原始文件审计**的证据,不喂给 judge。判"某能力靠加载 skill 存活"时**人工先看 `# skills_invoked`**:若为空、而纪律却在,说明能力来自契约文本/通用知识而非被加载的 skill,别把自报当已加载。
137
+
138
+ **触发边界(不是 routine 迭代工具)**:只在**一次改动同时改动多行为的常驻操作层**时用 —— 换/瘦 bootstrap、替换路由层、采用一套新操作契约。单个 skill 的普通改动仍用 3.1(before-after)/ 3.2(golden trace),别用这个重家伙。它回答的是"压缩/替换操作层后,安全纪律是否还在",不是"这条 skill 改好没有"。
139
+
140
+ **硬教训(首次真跑校准出来的,写进来免得重犯)**:
141
+
142
+ 1. **判断评分,不是关键词评分。** regex/关键词 grader 是**噪声**:会 false-fail 真正优秀的回答(把否定句里被引用来反驳的禁语当命中;概念在但精确词不在;行为做了但没吐出 skill 的**名字**),并在同夹具的不同 sample 间 PASS↔FAIL 翻转。所以 harness **不自动打分**:它把每条夹具双臂 × N sample 跑完、连同 rubric **存下回答**,由人(或另行校准、带 human-golden 锚点的 LLM-judge)读判。报告**逐夹具**给结论,永不给单一 regex 通过率。
143
+ 2. **非确定性是真的。** 同 prompt 不同跑会微差,`--samples ≥2`,单 sample 只当一个数据点。
144
+ 3. **rate-limit 中止护栏。** 一次全量 A/B(12 夹具 × 2 臂 × 2 sample = 48 次 headless 跑)会吃掉可观的额度池;harness 从流里解析 7 日利用率,超 `--stop-util`(默认 0.93)**在下一次跑前中止**、存部分结果、可续跑,免得大 A/B 把用户的真实活儿挤没。
145
+ 4. **抓全部 assistant 文本。** route-first 的操作层会**先**吐一条路由消息**再**给实质答案;只抓最后一条会漏掉实质回答。拼接全部 assistant text 再判。
146
+ 5. **臂配置细节。** `--bare` 会连 OAuth/keychain 认证一起去掉(需要 API key,否则跑不起来);`disableAllHooks + --disable-slash-commands` 才是"去掉 bootstrap 但保住认证"的正确姿势 —— 已在 candidate 臂验证:该 flag 组合下 agent 确认自己没有 ccl-skills 路由。
147
+
148
+ **用时机**:操作层月级别稳定 + 要做一次 system-wide 换层/瘦身时;把它当"换层前的对抗性回归证据",不是频繁迭代期的日常闸。
149
+
150
+ ### 3.4 Composite health score + trend(综合分,advisory roll-up)
151
+
152
+ 3.1–3.3 都是**单次**判定(这次改动好不好、这条 trace 偏没偏、这次换层纪律掉没掉);即便 3.3 横跨一整个夹具集,判的仍是**某一次改动**的即时行为。缺的是**跨时间的一个数**:仓库整体在变好还是变差。
153
+
154
+ **外部锚**:OpenSSF Scorecard 给代码仓的做法是 —— 每个 check 0–10,再**按风险加权**聚合成一个 0–10 总分(Critical=10 / High=7.5 / Medium=5 / Low=2.5),并跨时间追。gstack-health 给代码仓同形态(加权 composite + 历史趋势 + dashboard)。**这是成熟业内形态,不是某一家发明的**。
155
+
156
+ **我们的映射(route-not-copy:不打分代码工具,套到 F4 信号上)**:`eval-health.rb` 把四个信号卷成一个加权 0–10 + 趋势 ——
157
+
158
+ | 维度 | 风险/权重 | 0–10 来源 |
159
+ |---|---|---|
160
+ | `structural` | Critical 10 | `validate-skill.sh` pass→10 / fail→0 |
161
+ | `routing_static` | Critical 10 | T1 blocking=0→满分、有 blocking→3、advisory 轻罚 |
162
+ | `trace` | High 7.5 | T3 pass/considered |
163
+ | `bank` | Medium 5 | T2 pass/tasks |
164
+
165
+ `composite = Σ(score·weight) / Σ(weight)`,只算在场维(skip 维权重重分,同 OpenSSF/gstack)。确定性两维自动跑,T2/T3 喂报告进来(否则 skip)。契约见 [eval-routing.md](eval-routing.md) 的 Health roll-up 节。
166
+
167
+ **两条不可省的护栏**(否则这个数会骗人):
168
+
169
+ 1. **advisory,不当 gate**(Goodhart):度量变成 target 就被博弈。综合分**永不接门禁**,二元门禁(结构 + T1 blocking)仍独立挡 merge;历史文件 git-ignore,免得"committed 的数"招人调数不修仓。
170
+ 2. **corpus/version 守卫**:T2/T3 的 task-bank、golden-traces **本身会变**。加 10 条简单 task,pass-rate 涨了但仓没变好 —— **尺子换了**。每条历史记 `corpus` 指纹(输入内容 hash)+ 在场 `dims`;**趋势只跟 `(corpus, dims)` 全同的历史比**,否则 baseline reset 不偷偷比。等价于 gstack-health "尺子变了就从新基线重新追"。
171
+
172
+ **用**:周期性(nightly / 改动后)看一眼仓库 health 趋势,**辅助判断**,不替代任何门禁。**不用**:别把它当通过标准、别committed、别跨 corpus 硬比。
173
+
174
+ ---
175
+
176
+ ## §4 Failure escalation thresholds
177
+
178
+ **定义**:agent 何时应**停止重试 / 升级到人** vs **继续自主迭代**。Anthropic + AutoGen 等都有讨论但无统一标准。
179
+
180
+ **Trigger 类别**(分两种性质 — 命中行为不同):
181
+
182
+ **Hard stop(命中即停 + 必须用户确认 / 解决依赖才继续)**:
183
+
184
+ | Trigger | 启发阈值 | 行为 |
185
+ |---|---|---|
186
+ | **副作用边界触达** | 任何 destructive op(rm -rf / force-push / drop table / cross-team shared-doc overwrite)| stop + 等用户确认 |
187
+ | **不可解决依赖** | 等外部服务 / 等人审批 / 等数据到 | stop + 报当前状态 + 等依赖解除 |
188
+
189
+ **Warning(命中即报告 + 用户决策继续 / 切策略 / 停,不自动停)**:
190
+
191
+ | Trigger | 启发阈值 | 决策 |
192
+ |---|---|---|
193
+ | **同一失败重复 N 次** | N = 3(同 error 第 4 次出现)| 报告 + 等人;**严格指"identical retry"**,不是 challenge 多轮发现新问题 |
194
+ | **预算 warning** | tool call > 100 / token 紧张 / wallclock > 30 分钟 | 报中间状态 + 用户决定继续 / 切策略 / 停;不自动停(大 codebase + flaky 外部依赖 + 长跑但有进展的工作 都可能合理超阈值)|
195
+
196
+ **与 convergence standard 的区别**(重要):本节阈值针对 **same-error retry**(重复尝试同一失败方案),不替代 [convergence standard](../SKILL.md)(针对 challenge round — 只要每轮还有 P1 required 就继续,不按 round 计数停)。区分:
197
+ - **Same-error retry**:每次尝试本质相同方案 → N=3 后升级
198
+ - **Challenge convergence round**:每轮发现不同新层 / 新 P1 → 继续直到 0 P1 required(recursive self-validation 类 extraction 可能走 5-6 轮,每轮抓不同层的新 P1,不该按 round count 停)
199
+
200
+ **Escalation 必含 5 字段**(避免"escalate"沦为"stop"):
201
+ 1. **Blocker**:具体卡在哪步(不是"卡住了")
202
+ 2. **Attempts made**:试过哪 N 种方案 + 各自结果
203
+ 3. **Current state**:worktree diff / 工作区状态 / 已 commit 哪些
204
+ 4. **Safest next action**:建议的下一步(让用户对齐)
205
+ 5. **Lower-risk continuation**:agent 能不能在等 escalation 同时做其它低风险工作?能 = 继续;不能 = 停
206
+
207
+ 职责切分:`multi-agent-delegation` skill 定义 agent / sub-agent 执行中的 broad "stop and escalate" 条件 + review / completion gates;本 ref §4 补充通用 failure-escalation thresholds(same-error retry / budget warning / dependency stop)+ escalation **message 5 字段 contract**。
208
+
209
+ ---
210
+
211
+ ## §5 Context engineering(harness 的核心 = 管 context,不是堆 prompt)
212
+
213
+ **定义**(Anthropic "Effective context engineering for AI agents" 2025,primary,WebFetch 核):harness 的核心不是更聪明的 prompt,而是把**有限 context 当稀缺资源**管理 —— "find the smallest possible set of high-signal tokens that maximize the likelihood of some desired outcome"。原因是 **context rot**:token 越多,模型从中精确召回的能力越降(部分源于 transformer attention 的 n² 关系等因素),所以 working set 要小而高信噪,不是越塞越好。
214
+
215
+ 5 个技术 + 我们的映射:
216
+
217
+ | 技术 | 含义 | 我们已/应怎么落 |
218
+ |---|---|---|
219
+ | **最小高信噪集 / 渐进式披露** | 不预载全部,只放当前所需 | SKILL.md 入口只放 trigger+路由,细节进 references 按需读;skill-system 三级渐进式披露(见 `llm-inference-integration` 的 retrieval-agent-safety 参考)|
220
+ | **Compaction** | 近 context 上限时摘要历史(保留架构决策/未解 bug/实现细节,丢**冗余/可复现**的 tool 输出),重开窗口 | 长 extraction 线程靠 harness 自动 compaction;写 skill 时把"决策+未决项"放在可被摘要保留处。**只丢可复现/噪声输出**:compaction 前把 load-bearing 实证(命令 + 路径/source id + 关键摘录 + 退出码 + validation/audit 结论)落进 durable 产物,别让下一 session 从丢了唯一可证伪细节的摘要里"确认"完成 |
221
+ | **结构化笔记 / agentic memory** | 在窗口外持续写笔记(NOTES.md / memory tool),需要时再注入;"persistent memory with minimal overhead" | **我们的 source-register + 私有 provenance YAML + per-host scratch 就是外部持久记忆**;跨轮的 owner-map / R0 结论写文件、不靠记忆。**项目级分层 context 文件(从根目录到各层目录的 AGENTS.md/CLAUDE.md/agent.md "地图模式")也是这一条**:每层约定写在该层文件,agent 进到该目录才加载,是文件系统级的结构化外部记忆 |
222
+ | **Just-in-time retrieval** | 只存轻量标识(文件路径/查询/链接),运行时再拉数据,不预载 | reference-loading 指针(`read references/X.md`)+ alias-map 查表 + 分层 AGENTS.md 按目录加载都是 JIT。**但 JIT 不能绕过 trigger 必读的 ref/gate**(R0 / lifecycle handoff / dual-track / incident / two-source 等必读项):minimal-context 只省非必需上下文,不省强制工作流依赖 |
223
+ | **Sub-agent 隔离** | 专项 sub-agent 独立窗口,只回精简摘要(context-engineering post 给的典型值 1,000–2,000 token)| 见 §2;"report in under N words" 即此条落地 |
224
+
225
+ 右海拔 system prompt("specific enough to guide … yet flexible enough … strong heuristics")= 我们 skill 措辞的同一标准(对应 skill-authoring 的 set-appropriate-degrees-of-freedom)。
226
+
227
+ **用**:写/改 skill 时问"这段 token 值不值它占的位置";长流程靠外部文件(register/provenance/git)保状态,不靠长 context。
228
+
229
+ ## §6 Long-running / 多 session harness(跨 context 窗口保进度)
230
+
231
+ **定义**(Anthropic "Effective harnesses for long-running agents" 2025,primary,WebFetch 核):长任务的核心难点 —— **"each new session begins with no memory of what came before"**(每个新 session 从零记忆开始)。只靠 compaction 不够;解法是 **durable、可查询的状态产物**跨窗口桥接:
232
+
233
+ - **进度文件**(如 `claude-progress.txt`):记录已做/在做
234
+ - **特征清单**(JSON,逐条带 pass/fail 状态):**用 JSON 不用 Markdown** —— 模型更不易误改/覆盖 JSON
235
+ - **git history**:descriptive commit message = 可恢复 checkpoint
236
+
237
+ **Context reset vs compaction**(区分):compaction 原地摘要、保连续性但不给干净 slate;**reset 给干净 slate,代价是 handoff 产物必须含足够状态让下一 session 干净接手**。新 session 第一步:读 git log + 进度文件 get up to speed。
238
+
239
+ **单 session 循环**:① 读目录状态+进度产物 → ② 选下一个未完成项 → ③ 增量实现 → ④ **按任务合适的真实验证后才标完成**(web app 场景优先 browser/end-to-end 验证;不验证会"以为做完、实际没通")。反模式:**一次想做太多(one-shot 整个任务)→ 半成品 + context 耗尽**;强制单项增量。
240
+
241
+ **映射到我们的 extraction**:多轮"深度提炼"本质就是 long-running 多 session 任务 ——
242
+ - durable handoff 产物按**存储类**分(R0 + lifecycle handoff 红线,不可混):项目实证(真路径/key/分支/人名/provenance)只进**私有 scratch + 私有 provenance YAML**;shared 树的 source-register 只放**泛化方法行/模板**;git history 与 commit message 是 shared 树,**只用 sanitized label**。"状态进文件"绝不等于"把项目实证写进共享 register / 进度文件 / commit"。
243
+ - 单 session 循环 = per-round Skill 重新 invoke + charter(gather/plan)→ 落 diff(act)→ dual-track gate(verify-before-done)
244
+ - 反 one-shot = challenge **每轮只收敛一层 P1**,不一次性宣称全完成
245
+
246
+ **用**:任何跨多 session / 多轮的 skill 工作,状态进文件不进记忆(按上面存储类分流),每轮 verify 后才标 landed。**不用**:单轮小改不需要 progress-file 开销。
247
+
248
+ ### §6.1 Generator–Evaluator–Planner build-harness(长跑*建应用*的前沿 harness 形态)
249
+
250
+ (Anthropic "Harness design for long-running application development",primary,WebFetch 核 2026):把"从一句话长跑建出完整应用"拆成三角色 —— 核心的 generator↔evaluator 回路就是 §1 **evaluator-optimizer**,planner 的 spec 展开 + sprint 契约协商是绕着它的 **chaining / orchestration**;整体不是新 pattern,别重造命名:
251
+
252
+ - **Planner**:把 1–4 句 prompt 扩成完整 product spec —— 只管产品上下文 + 高层技术取向,**不下沉实现细节**(过早定细节会向下游级联错误)。缺 planner 时 generator 会 under-scope、直接开干、产出更单薄。
253
+ - **Generator**:按 spec 实现 feature。("一次一个 feature 分 sprint" 是**可拆的脚手架、不是角色本质** —— 原文在 Opus 4.6 后整段去掉 sprint、让模型自己分解;见第 4 条。)
254
+ - **Evaluator**:用**真交互**(如 Playwright 点真应用、测 UI/API/DB 状态)按任务专属标准打分,**不是只读 diff**。
255
+
256
+ 四条落到我们已有纪律上(route-not-duplicate,别在本 ref 重写下游 owner 的规则):
257
+
258
+ 1. **别让 generator 自评**:模型对自己的产出会"自信地夸",哪怕明显平庸;"把一个独立 evaluator 调 skeptical"比"让 generator 自我批判"可操作得多。= 我们的 **dual-track gate**(独立 review + 对抗 challenge)+ §2 trust-drift 的产品-harness 版。建产品 agent loop 时同理 —— role-separation / LLM-as-judge owner 是 `llm-inference-integration` 的 `model-prompt-evaluation.md`。
259
+ 2. **写码前先谈拢 "done" 契约**:每个 sprint 前 generator 提"建什么 + 怎么验证成功",evaluator 审范围(是否过大 / 测试太弱 / 漏边界)形成契约;之后 evaluator **按契约验收,不按最初模糊 prompt 验收**。= `product-rd-workflow` "先定 done 再实现" + challenge 审范围的强化命名(owner 仍是 product-rd,本条只给映射)。
260
+ 3. **主观质量也能打分**:把"品味"拆成显式量规(原文举例:design / originality / craft / functionality 加权)+ few-shot 校准 evaluator 降 judge drift。量规/校准机制 owner = `llm-inference-integration` 的 `model-prompt-evaluation.md`(LLM-as-judge);设计维度 owner = `product-ui-ux-design`。
261
+ 4. **scaffold 是模型版本的函数、会过时**:能力提升后该**减 scaffold**、别镀金 —— 原文 **Opus 4.5** 后去掉 context-reset(靠 SDK 自动 compaction 接管),**Opus 4.6** 后又去掉 sprint 分解(模型能自己分解任务)。呼应 §5/§6 的 reset-vs-compaction:选哪个取决于当前模型、不是永久结构;写 harness 规则时别把某代模型的脚手架(context-reset / sprint 这类)写成不变式。
262
+
263
+ **用**:描述/设计多 agent 建造 workflow 时用 planner/generator/evaluator 通用术语,并把上面 4 条 route 到对应 owner。**不用**:小改 / 单文件任务不需要三角色 harness(原文成本例:solo 20min/$9 vs 全 harness 6hr/$200,~22×,与 `multi-agent-delegation` 的并行 ~15× 同量级 —— 只对高价值、宽度优先的工作划算)。
264
+
265
+ ## §7 业界形态记录:插件式 agent harness(可借鉴的架构原则,非执行规则)
266
+
267
+ 2026 年公开的一类 agent harness 把**运行时的每个部件都做成可热插拔的插件**——模型适配器、工具注册表、审批策略、沙箱、子 agent provider,乃至 agent 主循环本身——并声明"没有特权核心可打补丁":扩展 = 在旁边挂一个插件,注册是可逆的效果,卸载即撤销。与我们 skill 层直接相关、值得在设计 agent 运行时或评审别人的运行时时拿来对照的原则(来源是一个仍在 developer preview 的开源仓,按 evolving portfolio 处理:**形态之一,不是标准**):
268
+
269
+ - **能力三角**:一个可替换能力 = 接口定义 + 实现(提供者)+ 消费者(通常是面向模型的工具)三者齐备才算一个可替换的能力边界;只有其中一角不算。为**所有当前消费者**设计接口,不让某一个消费者的 UI/传输/私有需求定义契约;一个只有单个内部调用者的公共方法是不必要的 API 扩张——改成构造时注入的私有能力闭包。
270
+ - **事件即扩展点**:持久事实(可重放)、在途 agent 事件(观察/拦截)、能力事件(给能力边界挂策略)三类分开;瀑布式监听器必须显式 `next()` 委托,返回即短路。
271
+ - **组合分层**:运行时 = 有序的 profile/bundle 层叠加出来的插件树,每层可用 patch 覆盖任一行配置;能打印出机器实际启动的树来核对。
272
+ - **决策在执行处强制**:schema 省略、prompt 过滤、facade、监听顺序都不是权限边界(已进 `llm-inference-integration` / `product-rd-workflow` 评审清单)。
273
+ - 与之相对,把插件系统的**依赖注入与跨插件解析**做得很重是否值得,业界有争议(一线 harness 作者的公开评价:多数插件互不依赖,复杂 DI 在 90% 场景不带来收益,且跨插件类型仍需另解);本仓不采纳"人人可发的插件生态"作为 skill 分发形态。
274
+
275
+ 不含日志/持久化表述——模型可见内容与事件日志的账目不变量另由安全 owner 参与的独立设计处理。
276
+
277
+ ## 故意不借鉴
278
+
279
+ | 概念 | 原因 |
280
+ |---|---|
281
+ | 多 agent 角色扮演(CrewAI / MetaGPT 的 PM / Engineer / Tester 多角色对话)| 我们的 SKILL.md routing 已分工,没必要再加 role-play 层 |
282
+ | Graph-based orchestration(LangGraph)| 我们的 routing 是 description-driven,不需要图结构;图结构对大型 workflow 才划算 |
283
+ | Approval mode / sandbox profile 设计 | Claude Code / Codex CLI 自带,无需在 skill 层重做 |
284
+ | Memory layering(mem0 多层显式分层 API) | 结构化笔记/外部记忆的**原则**已采纳(见 §5:source-register / provenance / scratch 即外部持久记忆);此处只拒 mem0 式**显式多层分层 API** —— 当前 auto-memory + MEMORY.md + repo docs + register 已是事实层级,分层 API ROI 低 |
285
+ | Cost-aware model routing 显式实现 | 当前不是主要优化目标。**规范的是 tier(成本/延迟/能力档)**:简单/高频任务路由到便宜快档,复杂任务留 frontier 档 —— 这条原则不过时。**vendor 型号名只是举例、用时再核**(各家 tier 标签如 Haiku/Sonnet/Opus 且版本随时间漂移,别把型号或版本号写死进规则)。未来成本压力上来可重启显式路由 |
286
+ | MCP server 开发 | harness 实现层,不是 skill 内容;跳 |