@tinkcarlos/skillora 0.2.0

package/.claude/skills/shared-references/skill-orchestration-protocol.md

@@ -0,0 +1,281 @@
+# Skill Orchestration Protocol v1.0
+
+统一的技能编排协议，确保 skill 之间调用时不会造成上下文污染。
+
+## The Iron Law
+
+```
+NO SKILL CALL WITHOUT ISOLATION. NO DELEGATION WITHOUT ANCHOR. NO RETURN WITHOUT VERIFICATION.
+```
+
+---
+
+## 一、编排器 Skills 列表
+
+| Skill | 角色 | 可调用的 Skills |
+|-------|------|----------------|
+| **fullstack-developer** | 主编排器 | 几乎所有 skills |
+| **bug-fixing** | Bug 修复器 | frontend-design, database-migration, test-driven-development, code-review |
+| **code-review** | 代码审查器 | bug-fixing, test-driven-development, verification-before-completion |
+| **product-requirements** | 需求分析器 | frontend-design, bug-fixing, code-review, fullstack-developer |
+| **frontend-design** | 前端设计器 | react-best-practices, code-review |
+
+---
+
+## 二、三层保护机制
+
+### 1. 锚点层 (Anchor Layer)
+
+**不可变的任务信息，始终记住原始目标**
+
+```markdown
+### 主上下文锚点
+- **原始任务**: [用户的原始请求]
+- **任务 ID**: [Bug ID / 需求文档路径]
+- **成功标准**: [明确的完成条件]
+- **当前计划任务**: T[X] - [任务描述]
+```
+
+### 2. 约束层 (Constraint Layer)
+
+**委托范围限制，防止范围膨胀**
+
+| 调用场景 | 范围约束 |
+|----------|----------|
+| bug-fixing → fullstack-developer | **最小 API only** |
+| bug-fixing → frontend-design | **Fix-related only** |
+| bug-fixing → database-migration | **Required changes only** |
+| code-review → bug-fixing | **P0/P1 issues only** |
+
+### 3. 检查层 (Verification Layer)
+
+**进入/退出验证，确保正确切换上下文**
+
+- 委托前：输出锚点确认
+- 委托后：验证是否偏离
+- 偏离时：立即停止并询问
+
+---
+
+## 三、委托模板
+
+### 委托进入模板
+
+```markdown
+## 🔄 技能委托通知
+
+### 主上下文锚点确认
+- **原始任务**: [用户的原始请求]
+- **任务 ID**: [Bug ID / 需求文档路径]
+- **当前计划任务**: T[X] - [任务描述]
+- **成功标准**: [明确的完成条件]
+
+### 委托详情
+- **目标 Skill**: `[skill-name]`
+- **委托目的**: [为什么需要这个 Skill]
+- **范围限定**:
+  - ✅ 允许: [具体允许的操作]
+  - ❌ 禁止: [明确禁止的操作]
+- **退出条件**: [什么标志完成]
+- **预计步骤**: [X] 步
+
+---
+⏱️ 开始委托任务...
+```
+
+### 委托退出模板
+
+```markdown
+## ✅ 委托任务完成
+
+### 完成情况
+- **目标达成**: ✅ / ❌
+- **范围遵守**: ✅ / ❌
+- **产出物**: [创建/修改的文件列表]
+
+### 偏离检查
+- **是否偏离原始目标**: ✅ 未偏离 / ❌ 已偏离
+- **偏离说明**: [如有偏离，说明原因]
+
+### 返回主上下文
+- **继续任务**: T[X+1]
+- **计划状态更新**: [更新内容]
+
+---
+🔄 返回主上下文
+```
+
+---
+
+## 四、调用方式
+
+### 方式 1: Task 工具 (Subagent 隔离) - 推荐
+
+```python
+Task(
+    subagent_type="superpowers:code-reviewer",
+    prompt="""
+    ## 主上下文锚点
+    - 原始任务: [任务描述]
+    - 成功标准: [完成条件]
+
+    ## 委托任务
+    审查以下变更: [变更列表]
+
+    ## 范围约束
+    - ✅ 允许: 审查代码质量
+    - ❌ 禁止: 修改代码
+    """,
+    description="代码审查"
+)
+```
+
+**优点**: 天然隔离，subagent 有独立上下文
+
+### 方式 2: Skill 工具
+
+```python
+Skill(skill="code-review")
+```
+
+**注意**: 需要手动管理上下文，使用委托模板
+
+---
+
+## 五、强制调用链
+
+### 闭环 1: 代码审查闭环
+
+```
+code-review → bug-fixing → code-review (循环直到通过)
+```
+
+### 闭环 2: 开发完成闭环
+
+```
+development → verification-before-completion → code-review → (bug-fixing →)* → merge
+```
+
+### 闭环 3: Bug 修复闭环
+
+```
+bug-fixing → code-review → verification-before-completion
+```
+
+---
+
+## 六、触发条件表
+
+| 主 Skill | 触发条件 | 调用 Skill | 范围约束 | 强制? |
+|----------|----------|------------|----------|-------|
+| fullstack-developer | 任何 UI 工作 | frontend-design | - | ✅ |
+| fullstack-developer | ORM 模型变更 | database-migration | - | ✅ |
+| fullstack-developer | 开发完成 | code-review | - | ✅ |
+| fullstack-developer | 审查发现问题 | bug-fixing | P0/P1 only | - |
+| bug-fixing | 修复需要新 API | fullstack-developer | 最小 API only | - |
+| bug-fixing | 修复涉及 UI | frontend-design | Fix-related only | - |
+| bug-fixing | 修复完成 | code-review | - | ✅ |
+| code-review | 发现 P0/P1 Bug | bug-fixing | - | ✅ |
+| frontend-design | React/Next.js | react-best-practices | - | ✅ |
+
+---
+
+## 七、上下文污染的表现
+
+| 问题 | 表现 | 后果 | 预防 |
+|------|------|------|------|
+| **目标漂移** | 忘记原始任务目标 | 偏离用户需求 | 锚点层 |
+| **范围膨胀** | 小修复变成大工程 | 引入更多风险 | 约束层 |
+| **上下文丢失** | 忘记已完成的任务 | 重复执行 | 检查层 |
+| **循环调用** | A→B→A 无限循环 | 死循环 | 退出条件 |
+
+---
+
+## 八、偏离处理
+
+### 检测偏离
+
+```markdown
+## ⚠️ 偏离检测
+
+当前操作: [正在做的事情]
+原始目标: [应该做的事情]
+
+**偏离类型**:
+- [ ] 目标漂移
+- [ ] 范围膨胀
+- [ ] 上下文丢失
+
+**处理方式**:
+1. 立即停止当前操作
+2. 询问用户是否继续
+3. 如继续，更新锚点
+4. 如不继续，回滚到锚点
+```
+
+---
+
+## 九、最佳实践
+
+### DO ✅
+
+1. 每次委托前输出锚点确认
+2. 明确范围约束 (允许/禁止)
+3. 委托完成后验证是否偏离
+4. 使用 Task 工具实现 subagent 隔离
+5. 保持委托链简短 (≤3 层)
+
+### DON'T ❌
+
+1. 不要在委托中修改原始目标
+2. 不要跳过强制调用链
+3. 不要忽略范围约束
+4. 不要在委托中创建新的委托链
+5. 不要在偏离时继续执行
+
+---
+
+## 十、Hooks 集成
+
+### 自动触发的 Hooks
+
+| Hook 类型 | Matcher | 触发时机 | 作用 |
+|-----------|---------|----------|------|
+| PreToolUse | Skill | Skill 调用前 | 记录调用、提醒锚点 |
+| PostToolUse | Skill | Skill 调用后 | 验证完成、检查偏离 |
+| PreToolUse | Task | Subagent 派发前 | 检查锚点完整性 |
+| PostToolUse | Task | Subagent 返回后 | 验证偏离、更新进度 |
+| SubagentStop | * | Subagent 停止时 | 恢复上下文、输出检查清单 |
+
+### Hook 输出解读
+
+| 输出 | 含义 | 处理 |
+|------|------|------|
+| `⚠️ WARNING: missing context anchor` | Subagent 缺少锚点 | 重新派发，添加锚点 |
+| `🔄 Subagent completed` | Subagent 正常完成 | 验证范围，继续任务 |
+| `📋 Checklist` | 检查清单 | 逐项验证 |
+
+### 日志文件
+
+| 文件 | 内容 |
+|------|------|
+| `~/.claude/skill-invocation-log.jsonl` | Skill 调用记录 |
+| `~/.claude/subagent-dispatch-log.jsonl` | Subagent 派发记录 |
+
+---
+
+## 十一、Subagent 调用模板
+
+详见 `shared-references/subagent-dispatch-templates.md`
+
+---
+
+## 十二、引用此协议
+
+在 SKILL.md 中添加:
+
+```markdown
+## 技能编排
+
+遵循 `shared-references/skill-orchestration-protocol.md` 协议。
+```

package/.claude/skills/shared-references/subagent-dispatch-templates.md

@@ -0,0 +1,199 @@
+# Subagent Dispatch Templates
+
+标准化的 Subagent 调用模板，确保上下文隔离和防止目标漂移。
+
+---
+
+## 核心原则
+
+```
+NO SUBAGENT WITHOUT ANCHOR. NO DELEGATION WITHOUT SCOPE. NO RETURN WITHOUT VERIFICATION.
+```
+
+---
+
+## 模板 1: 通用 Skill 委托
+
+适用于大多数 skill 调用场景。
+
+```python
+Task(
+    subagent_type="general-purpose",
+    prompt="""
+## 🔒 主上下文锚点 (IMMUTABLE)
+- **原始任务**: {original_task}
+- **任务 ID**: {task_id}
+- **成功标准**: {success_criteria}
+- **当前阶段**: {current_phase}
+
+## 📋 委托任务
+执行 `{skill_name}` 技能完成以下工作:
+{task_description}
+
+## ⚠️ 范围约束
+- ✅ 允许: {allowed_actions}
+- ❌ 禁止: {forbidden_actions}
+- ⏱️ 预计步骤: {estimated_steps}
+
+## 🚪 退出条件
+{exit_condition}
+
+## 📤 输出要求
+完成后输出:
+1. 目标达成: ✅/❌
+2. 范围遵守: ✅/❌
+3. 产出物列表
+4. 偏离说明 (如有)
+""",
+    description="{short_description}"
+)
+```
+
+---
+
+## 模板 2: 代码审查委托
+
+专用于 code-review skill。
+
+```python
+Task(
+    subagent_type="superpowers:code-reviewer",
+    prompt="""
+## 🔒 主上下文锚点
+- **原始任务**: {original_task}
+- **变更范围**: {changed_files}
+
+## 📋 审查任务
+按照 `code-review` 技能标准审查以下变更:
+{file_list}
+
+## ⚠️ 范围约束
+- ✅ 允许: 审查代码质量、发现 Bug、提出改进建议
+- ❌ 禁止: 修改代码、添加功能、重构
+
+## 🚪 退出条件
+输出审查报告，包含 P0-P3 问题列表
+""",
+    description="代码审查"
+)
+```
+
+---
+
+## 模板 3: Bug 修复委托
+
+专用于 bug-fixing skill。
+
+```python
+Task(
+    subagent_type="general-purpose",
+    prompt="""
+## 🔒 主上下文锚点
+- **Bug ID**: {bug_id}
+- **原始症状**: {symptom}
+- **根因**: {root_cause}
+
+## 📋 修复任务
+执行 `bug-fixing` 技能修复:
+{fix_description}
+
+## ⚠️ 范围约束
+- ✅ 允许: 修复 Bug 相关代码
+- ❌ 禁止: 重构、优化、添加功能
+
+## 🚪 退出条件
+Bug 修复完成，测试通过
+""",
+    description="Bug 修复"
+)
+```
+
+---
+
+## 模板 4: 前端开发委托
+
+专用于 frontend-design skill。
+
+```python
+Task(
+    subagent_type="general-purpose",
+    prompt="""
+## 🔒 主上下文锚点
+- **原始任务**: {original_task}
+- **UI 需求**: {ui_requirements}
+
+## 📋 前端任务
+执行 `frontend-design` 技能完成:
+{task_description}
+
+## ⚠️ 范围约束
+- ✅ 允许: 创建/修改 UI 组件、样式
+- ❌ 禁止: 修改后端逻辑、数据库
+
+## 🚪 退出条件
+UI 组件完成，符合设计规范
+""",
+    description="前端开发"
+)
+```
+
+---
+
+## 模板 5: 数据库迁移委托
+
+专用于 database-migration skill。
+
+```python
+Task(
+    subagent_type="general-purpose",
+    prompt="""
+## 🔒 主上下文锚点
+- **原始任务**: {original_task}
+- **数据模型变更**: {model_changes}
+
+## 📋 迁移任务
+执行 `database-migration` 技能完成:
+{migration_description}
+
+## ⚠️ 范围约束
+- ✅ 允许: 创建迁移文件、修改模型
+- ❌ 禁止: 修改业务逻辑、删除数据
+
+## 🚪 退出条件
+迁移文件创建完成，可正常执行
+""",
+    description="数据库迁移"
+)
+```
+
+---
+
+## 使用指南
+
+### 何时使用 Subagent
+
+| 场景 | 是否使用 Subagent | 原因 |
+|------|-------------------|------|
+| 简单单步任务 | ❌ | 直接执行更高效 |
+| 复杂多步任务 | ✅ | 需要上下文隔离 |
+| 跨 Skill 委托 | ✅ | 防止目标漂移 |
+| 代码审查 | ✅ | 使用专用 reviewer |
+
+### 锚点信息必填项
+
+| 字段 | 必填 | 说明 |
+|------|------|------|
+| 原始任务 | ✅ | 用户的原始请求 |
+| 任务 ID | ✅ | 唯一标识符 |
+| 成功标准 | ✅ | 如何判断完成 |
+| 范围约束 | ✅ | 允许/禁止操作 |
+| 退出条件 | ✅ | 何时返回 |
+
+### 偏离检测
+
+Subagent 返回后，检查以下项目：
+
+- [ ] 产出物是否符合原始任务
+- [ ] 是否有超出范围的修改
+- [ ] 是否引入了新的依赖
+- [ ] 是否偏离了成功标准

package/.claude/skills/skill-expert-skills/LICENSE.txt

@@ -0,0 +1,204 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf of
+      any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+
+